Set up Recommendations

Automate the generation of a playlist based on a seed video for your Android app.


If you have hundreds of videos hosted on or registered with your account, Recommendations automates the generation of a playlist based on a seed video and provides you options to customize the appearance and behavior of that playlist.

Screenshot of Recommendations overlayScreenshot of Recommendations overlay

Screenshot of Recommendations overlay


Requirements

In addition to the general Android SDK requirements, the following items are required to implement Recommendations.

ItemNotes
Android 4.4 (API level 19)Your app must be leveraging at least this minimum OS version.
50 videos (recommended)This is the suggested minimum number of videos that should be in your JW Player library.
Recommendations featureIf this product is not already enabled in your account, contact your JW Player representative.

Configure the Recommendations display options

The following steps explain how to create the Recommendations overlay:

  1. Create a recommendations playlist in your JW Player dashboard.
  2. After creating the recommendations playlist, on the DEVELOPER RESOURCES tab of the JW Player dashboard, copy the JSON URL.
  3. In your app, use Related.Config.Builder() to create and name a RelatedConfig object, for example, related.
  4. Add the JSON URL (file). Be sure to change the value of the ?related_media_id= query to match the media ID of the playlistItem.file URL.
  5. (Optional) Define autoPlayTimer. This creates a break between the playback of videos and enables the countdown overlay to appear. The default value is 10 (seconds).
  6. (Optional) Define onComplete as RELATED_ON_COMPLETE_AUTOPLAY. This property helps to extend a user's viewing session.
  7. (Optional) Use autoPlayMessage property to define the message that displays when the countdown overlay appears. We suggest using __title__ will begin in xx seconds.
Screenshot of the autoplay messageScreenshot of the autoplay message

Screenshot of the autoplay message

The countdown message appears above the title and description of the next video to play. The default message is Next up in xx. xx represents the number of seconds remaining in the countdown as defined by autoPlayTimer.

8. Add related to config.


PlaylistItem playlistItem = new PlaylistItem.Builder()
    .file("https://cdn.jwplayer.com/manifests/{media_id}.m3u8")
    .image("https://www.mydomain.com/poster.jpg")
    .title("Playlist-Item Title")
    .description("Some really great content")
    .build();


RelatedConfig related = new RelatedConfig.Builder()
    .file("https://cdn.jwplayer.com/v2/playlists/{recommendations_id}?related_media_id={media_id}")
    .autoPlayTimer(10)
    .onComplete(RELATED_ON_COMPLETE_AUTOPLAY)
    .autoPlayMessage("__title__ will begin in xx seconds")
    .build();
List<PlaylistItem> playlist = new ArrayList<>();
playlist.add(playlistItem);
PlayerConfig config = new PlayerConfig.Builder()
    .playlist(playlist)
    .relatedConfig(related)
    .build();
mPlayerView.setup(config);


Did this page help you?