Bookmarks
Overview
When the user watches content, the client application should create a bookmark when the user pauses the content or finishes watching it:
When the user pauses the content (or does something that causes the content to be paused, such as navigating away from the player or closing the app), the app should create a bookmark with the “In Progress” tag.
When the user finishes watching the content, the app should create a bookmark (or update the existing bookmark).
(Watching is considered completed when the user has viewed 95% percent of the content.)
There can only be one bookmark on a content for an account.
The client app can retrieve this bookmark data and use it to display content that the user has:
Partly watched (“Continue Watching”)
Already watched (“Recently Watched”)
If the client app uses rails, “Continue Watching” and “Recently Viewed” rails can be set up in Rails Builder (in OpCon). These rails are delivered to the client as part of the Content Delivery response for the appropriate template without the client having to retrieve any bookmark data. See:
The criteria for including content in these rails are as follows:
If content has a bookmark with the
"In Progress"tag and apositionvalue between 0% and 90% of the total duration of the content, it is included in the “Continue Watching” rail.If content has a bookmark for which the
positionvalue is greater than or equal to 95% of the total duration of the content, it is included in the “Recently Watched” rail.
If the user navigates to content that they have partly watched, the client app can retrieve the bookmark for the content and offer to play it from the point where they stopped watching.
The app can also provide the user with the ability to remove content from its “Continue Watching” and “Recently Watched” lists. If the user chooses to remove a content from one of these lists, the client should delete the relevant bookmark.
OpenTV Platform does not delete bookmarks. The client application is responsible for all bookmark deletions.