将内容插入“观看下一项”频道时,请遵循以下指南。
“观看下一项”频道中包含的内容类型
将应用的编程添加限制在传统的电影和电视剧上。不要添加剪辑和其他短片内容。
包含未完成的电影
使用 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 秒内使用“接下来观看”API 发布任何未完成的项目。
无论观看发生在哪里,都使用“接下来观看”API 将任何未完成的内容发布到 Android TV。例如,如果用户在 Chrome 浏览器中观看电影并暂停,则 Android TV 上的应用必须立即将未完成的内容发布到 Android TV,最大延迟时间为 5 秒。
何时添加新剧集
当以下所有条件都满足时,立即添加之前观看的系列的新剧集
- 新剧集在您的服务上可用。
- 用户已完成上一集。
- 用户有权观看新剧集。
无论用户上次观看该系列节目有多久,例如一年或更长时间后,都要添加新剧集。
内容资格和 UI 更新
用户必须在您的应用中与内容进行交互,内容才能有资格发布到“接下来观看”频道。
不要从同一个电视剧集中添加多个剧集。例如,不要从同一个系列中添加未完成的剧集和新剧集。
当一个项目发生变化时,不要更新“接下来播放”行中的所有项目。仅更新用户自上次更新以来交互过的项目。
“接下来观看”项目包含哪些数据
为每个“接下来观看”项目包含以下内容
- “接下来观看”类型
- 上次播放位置
- 时长
- 上次互动时间
- 视频节目属性:除了视频节目属性表中标记的必填属性外,每个视频节目都必须设置内容 ID 属性。内容 ID 属性必须与您在媒体操作 Feed 中提供的内部 ID 相匹配。这使 Android TV 能够更有效地协调资源,并为用户提供高度可靠的功能。
从“接下来观看”频道中删除内容
用户观看完电影或电视剧没有未观看的可用剧集时,删除内容。