应用开发者观看下一项指南

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

“观看下一项”频道中包含的内容类型

将应用的编程添加限制在传统的电影和电视剧上。不要添加剪辑和其他短片内容。

包含未完成的电影

使用 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 能够更有效地协调资源,并为用户提供高度可靠的功能。

从“接下来观看”频道中删除内容

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