应用开发人员的“接下来观看”指南

将内容插入“接下来观看”频道时,请遵循以下指南。

“接下来观看”频道中包含的内容类型

限制您的应用将程序化添加的内容限制为传统的电影和电视剧。不要添加剪辑和其他短格式内容。

包含未完成的电影

使用 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 频道删除内容

一旦用户完成观看电影或电视剧集没有未观看的可用剧集,就删除内容。