在主屏幕上推荐内容

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 或更早版本编译，它仍然可以在 API 级别 26 的 Android TV 上运行。旧的推荐行为是向前兼容的，但受到限制：

  • 推荐行会自动转换并在主屏幕上显示为一个新频道。
  • 转换后的频道上的节目会响应来自您的推荐服务的更新，但用户无法使用电视的 UI 来操作该频道上的节目（添加/移除节目，将节目复制到“接下来观看”频道）。
  • 如果您将应用更新到 API 级别 26，转换后的频道仍然会在运行 API 26 的电视上显示。当您的应用首次显示使用新 API 创建的频道时，电视会将转换后的频道从屏幕上移除。如果应用创建了默认频道，此情况会立即发生；如果用户选择并添加了您的应用创建的任何其他频道，则会稍后发生。
下一步
主屏幕上的频道