在主屏幕上推荐内容

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

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

下一步

主屏幕上的频道