主屏幕上的推荐内容

Android TV 主屏幕使用“频道”和“频道”来显示推荐内容。 计划。频道在主屏幕上以单独的行显示, 卡片,其中显示了该频道的所有可观看节目。

您的应用至少应有一个频道。您的第一个频道 成为其默认渠道, Android TV 会自动在主屏幕上显示该频道。您的应用 可以提供其他频道,但用户必须选择并批准这些频道 然后再将其添加到主屏幕

如果您的应用提供电视节目、电影或其他视频内容,我们建议您: 您支持视频预览和 与“接下来观看”频道集成。 “接下来观看”频道由 Android 系统控制。您的应用可以添加 与此频道相关的用户相关节目,例如用户标记为 有趣、中途停止观看或与内容相关的内容 用户正在观看的内容(例如电视剧的下一集或某电视剧的下一季) )。

确保兼容性

主屏幕会以两种方式显示推荐内容,具体取决于 Android 版本:

  • 在 Android 8.0(API 级别 26)及更高版本中,应用可以按一个或 显示在不同行上的更多渠道一个频道(默认频道) 始终显示。用户可以发现其他频道并将其添加到自己的首页上 屏幕。了解如何创建推荐频道
  • 在 Android 8.0 之前,Android TV 会集中显示所有推荐内容 始终显示在屏幕上的推荐行。了解如何创建 首页上的推荐行 屏幕。

若要在所有版本的 Android TV 上显示推荐内容,您的应用 应该同时实现两个推荐 API。测试当前的系统 API 级别并 使用适当的 API 构建推荐行或渠道。

Kotlin

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

Java

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

如果您的应用是使用 API 级别 25 或更低级别编译的,则仍可在 级别 26 中的 Android TV。旧推荐行为是向前兼容的, 但会受到限制:

  • “推荐”行会自动转换,并显示为新的 频道。
  • 转换后的频道上的节目会响应您的 推荐服务、 但用户无法使用电视的界面操纵频道上的节目 (添加/删除节目、将节目复制到“接下来观看”频道)。
  • 如果您将应用更新到 API 级别 26,则转换后的渠道 仍然会出现在运行 API 26 的电视上。TV 会从以下位置移除转换后的频道: 屏幕上首次显示使用新 API 创建的频道时。 如果应用创建了 默认渠道、 或者稍后,在用户选择并添加您的应用创建的任何其他频道时触发。