Android TV 主屏幕使用频道和节目显示推荐内容。频道在主屏幕上显示为单独的行,其中包含显示该频道所有可用节目的卡片。
您的应用至少应有一个频道。应用创建的第一个频道会成为其默认频道,Android TV 会自动在主屏幕上显示该频道。您的应用可以提供其他频道,但用户必须先选择并批准这些频道,然后这些频道才能添加到主屏幕。
如果您的应用提供电视节目、电影或其他视频内容,我们建议您支持视频预览并与“接下来观看”频道集成。“接下来观看”频道由 Android 系统控制。您的应用可以向此频道添加与用户相关的节目,例如用户标记为感兴趣的节目、中途停止观看的节目,或与用户正在观看的内容相关的节目(例如连续剧的下一集或节目的下一季)。
确保兼容性
主屏幕会根据 Android 版本以两种不同的方式显示推荐内容:
- 在 Android 8.0(API 级别 26)及更高版本中,应用可以在一个或多个渠道中显示推荐内容,这些渠道会显示在不同的行中。一个频道(默认频道)始终显示。用户可以发现其他频道并将其添加到主屏幕。了解如何在主屏幕上创建推荐频道。
- 在 Android 8.0 之前,Android TV 会在始终显示在屏幕上的单个推荐行中显示所有推荐内容。了解如何在主屏幕上创建推荐行。
为了能够在所有版本的 Android TV 上显示推荐内容,您的应用应同时实现这两个 Recommendation API。测试当前系统 API 级别,并使用适当的 API 构建推荐内容行或频道。
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 创建的频道时,电视会从屏幕中移除转换后的频道。如果应用创建了默认频道,则会立即发生这种情况;如果用户选择并添加了应用创建的任何其他频道,则会在稍后发生这种情况。