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