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