主屏幕上的推荐内容

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 创建的频道时。 如果应用创建了 默认渠道、 或者稍后，在用户选择并添加您的应用创建的任何其他频道时触发。

。

注意： 这种向前兼容的行为是暂时的，有时将被移除 。为了确保兼容性，最佳实践是同时实现 API（如上所述）。