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 创建的频道时,电视会从屏幕上删除转换后的频道。如果应用创建了默认频道,这会立即发生,或者当用户选择并添加您的应用创建的其他任何频道时,这会稍后发生。