主屏幕上的推荐内容

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 上运行。旧的推荐行为是向前兼容的,但受到限制:

  • 推荐行会自动转换,并在主屏幕上显示为新频道。
  • 转换后的频道上的节目会响应推荐服务的更新,但用户无法使用 TV 界面来操控这些节目(添加/移除节目、将节目复制到“接下来观看”频道)。
  • 如果您将应用更新到 API 级别 26,则转换后的频道仍会显示在搭载 API 26 的电视上。当您的应用首次显示使用新 API 创建的频道时,TV 会将转换后的频道从屏幕上移除。如果应用创建默认频道,或稍后用户选择并添加由应用创建的任何其他频道时,就会立即发生这种情况。