The Android Developer Challenge is back! Submit your idea before December 2.

主屏幕上的推荐内容

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

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