将内容插入“接下来观看”频道时,请遵循以下指南。
“接下来观看”频道中包含的内容类型
限制您的应用将程序化添加的内容限制为传统的电影和电视剧。不要添加剪辑和其他短格式内容。
包含未完成的电影
使用 TYPE_MOVIE
将未完成的电影添加到“接下来观看”频道。如果根据以下指南开始观看但未完成,则电影为未完成状态
- 如果用户观看超过 3% 或 2 分钟(以较早的时间戳为准),则表示已开始观看电影。
- 如果片尾字幕开始,则表示已完成观看电影。在这种情况下,请不要将其添加到“接下来观看”频道。您可以使用自动检测片尾字幕的技术来确定此状态,或根据内容长度使用近似值。
包含未完成的电视剧集
使用 TYPE_TV_EPISODE
将未完成的电视剧集添加到“接下来观看”频道。如果根据以下指南开始观看但未完成,则剧集为未完成状态
- 如果用户观看超过 2 分钟,则表示已开始观看剧集。
- 如果片尾字幕开始,则表示已完成观看剧集。在这种情况下,请不要将其添加到“接下来观看”频道。您可以使用自动检测片尾字幕的技术来确定此状态,或根据内容长度(例如,剧集剩余时间少于 3 分钟)使用近似值。
处理新的电视剧集和下一集电视剧集
根据以下指南,将用户已开始观看的系列的新剧集和下一集添加到“接下来观看”频道,使用 TYPE_TV_EPISODE
- 如果用户观看系列中任何剧集超过 2 分钟或在片头结束后 1 分钟,则表示已开始观看该系列。
- 如果用户开始观看系列并完成观看一集,并且您的服务中提供该系列的下一集,则使用
WATCH_NEXT_TYPE_NEXT
将此下一集添加到“接下来观看”频道。 - 如果用户已完全看完系列中的所有当前剧集,并且有新的一季或剧集可用,则使用
WATCH_NEXT_TYPE_NEW
将此新剧集添加到“接下来观看”频道。无论用户上次观看该系列已有多长时间(例如,一年或更长时间后),都要添加新剧集。
何时将项目添加到“接下来观看”频道
根据以下指南,将未完成的内容和之前观看的系列的新剧集添加到“接下来观看”频道。
何时添加未完成的内容
当用户有未完成的内容时,在以下任一情况发生时立即将该内容添加到“接下来观看”频道
- 用户退出 Android TV 上的应用。
- 用户暂停或停止播放内容超过 5 分钟。
在这些场景中,立即发布任何未完成的内容,最大延迟为 5 秒。例如,当用户退出 Android TV 应用时,请在 5 秒内使用 Watch Next API 发布任何未完成的项目。
无论观看发生在哪里,都将任何未完成的内容发布到 Android TV,使用 Watch Next API。例如,如果用户在 Chrome 浏览器中观看电影并暂停,则 Android TV 上的应用必须立即将未完成的内容发布到 Android TV,最大延迟为 5 秒。
何时添加新剧集
当以下所有条件都满足时,立即添加之前观看的剧集的新剧集
- 新剧集在您的服务上可用。
- 用户完成了上一集。
- 用户有权观看新剧集。
无论用户上次观看该剧集已过去多久,例如一年或更长时间后,都要添加新剧集。
内容资格和 UI 更新
用户必须在您的应用中与内容进行交互,才能使内容有资格发布到 Watch Next 频道。
不要添加同一电视剧集中的多个剧集。例如,不要添加同一电视剧集中的未完成剧集和新剧集。
当一个项目更改时,不要更新“接下来播放”行中的所有项目。仅更新用户自上次更新以来交互过的项目。
Watch Next 项目包含哪些数据
为每个 Watch Next 项目包含以下内容
- Watch Next 类型
- 上次播放位置
- 时长
- 上次互动时间
- 视频节目属性:除了在视频节目属性表中标记的必填属性外,还必须为每个视频节目设置内容 ID 属性。内容 ID 属性必须与您在媒体操作Feed 中提供的内部 ID 匹配。这使 Android TV 能够更有效地协调资源,并为用户提供高置信度的功能。
从 Watch Next 频道删除内容
一旦用户完成观看电影或电视剧集没有未观看的可用剧集,就删除内容。