将媒体应用扩展到 Android TV

Android 提供了针对在大屏设备（如高清电视）上运行的应用进行优化的丰富用户体验。您可以为 Android TV 开发应用，从而扩大应用受众群体。本文档提供了有关如何有效执行此操作的指导。

构建 TV 应用

TV 应用使用的结构与手机和平板电脑的应用相同。这表示您可以根据自身对 Android 应用的既有知识创建新的 TV 应用，也可以扩展现有应用，使其支持 TV 设备。

不过，TV 与手机和平板电脑设备在用户交互模式上差异很大。为了让您的应用在电视设备上取得成功，您必须设计新的布局，使用户能在距离电视 10 英尺的地方轻松看清楚屏幕内容，并且只需使用方向键和选择按钮便可完成导航。

如需详细了解如何处理 TV 硬件控制器、构建 TV 布局和创建 TV 导航等注意事项，请参阅构建 TV 应用。

使用 Media3 ExoPlayer

Jetpack Media3 提供了一个播放器接口，用于定义基本功能，例如播放、暂停、跳转和显示轨道信息。ExoPlayer 是 Media3 中此接口的默认实现。

与 Android 的 MediaPlayer API 相比，它增加了更多便利功能，例如支持多种流式传输协议、默认音频和视频渲染器，以及处理媒体缓冲的组件。

您可以自定义和扩展 ExoPlayer，并且可以通过 Play 商店应用更新来更新它。如需了解详情，请参阅 Media3 ExoPlayer。

使用 Media3 MediaSession

媒体会话提供了一种通用方式，让系统可以与应用的音频或视频播放器互动。Media3 与之前的媒体 API 相比，一个主要区别在于不再需要在组件之间使用连接器。

新的 MediaSession 类可接受任何实现 Player 接口的类。ExoPlayer 和 MediaController 都是实现该接口的类。这有助于简化组件之间的互动。 如需了解详情，请参阅播放器界面。

如需详细了解如何创建媒体播放应用，请参阅使用 ExoPlayer 创建基本媒体播放器。

为了给媒体应用的最终用户提供最佳体验，您需要实现 MediaSession。为此，请初始化 Player 并将其提供给 MediaSession.Builder，如下所示：

Kotlin

val player = ExoPlayer.Builder(context).build()
val mediaSession = MediaSession.Builder(context, player).build()

Java

ExoPlayer player = new ExoPlayer.Builder(context).build();
MediaSession mediaSession = new MediaSession.Builder(context, player).build();

自动状态处理

Media3 库会使用播放器的状态自动更新媒体会话。因此，您无需手动处理从玩家到会话的映射。这有助于确保用户始终看到正在播放的媒体的最新信息，包括“正在播放”卡片中的信息。

控制和通告播放

在 Media3 中，默认播放器是实现 Player 接口的 ExoPlayer 类。将媒体会话连接到播放器后，应用便可对外宣传媒体播放，并接收来自外部来源的播放命令。媒体会话会将这些命令委托给媒体应用的播放器。

媒体会话是控制播放的关键。它可让您将来自外部来源的命令路由到负责播放媒体的播放器。外部客户端可以使用媒体控制器向您的媒体应用发出播放命令。这些命令由您的媒体会话接收，最终会委托给媒体播放器。

如需详细了解播放，例如如何自定义播放命令行为，请参阅使用 MediaSession 控制和通告播放。

避免应用中断

使用 MediaSession 可避免不必要的干扰，例如：

  • 关闭电视或切换电视输入源时，出现意外且持续的播放。这也会导致电视硬件耗电量过高。借助 MediaSession，应用可以告知平台正在播放媒体，而平台也可以告知应用可以停止播放。

  • 当切换出应用或关闭电视显示屏时，音乐播放意外停止。使用 MediaSession API 可在后台服务中继续播放。

  • 限制与内容互动，禁止用户控制播放。例如，当应用在后台播放音乐时返回到该应用，或支持语音指令。借助应用中的 MediaSession，用户可以使用语音指令来搜索和跳过歌曲或剧集。

其他注意事项

在将媒体应用扩展到 Android TV 时，您需要考虑无障碍功能问题、如何提高用户互动度、如何让用户找到内容，以及如何构建游戏和 TV 输入源服务。

电视无障碍功能

虽然辅助技术可以帮助弱视用户，但为电视应用的内容发现之旅提供无障碍支持非常重要。

例如，请特别注意提供导航指导和正确标记元素，并帮助确保电视应用能与 TalkBack 等无障碍功能完美搭配使用。这些步骤可以显著改善视障用户的体验。

提高无障碍功能的第一步是提高意识。如需详细了解文字缩放、键盘布局和音频描述，请参阅无障碍资源。

在 Google TV 上提高用户互动度的最佳实践

为 Android TV 构建的所有应用都可在运行 Google TV 的设备上使用。为了在 Google TV 上提供最佳用户体验，我们建议您遵循以下最佳实践。

您需要使用 MediaSession，以提供与音频或视频播放器交互的通用方式。如需详细了解如何实现此功能，请参阅使用 Media3 MediaSession。

作为基本要求，您的应用需要支持 Google Cast。借助该 SDK，您可以扩展 Android、iOS 和 Chrome 应用，以实现向 Android TV 以及 Chromecast 设备和 Google 助理设备进行音频和视频流式传输。如需了解详情，请参阅 Google Cast 文档。

您还可以帮助用户：

  • 通过提供媒体操作 Feed 或集成“接下来观看”功能，在多个平台中发现内容。

  • 通过支持账号关联和授权同步、提供语音投屏功能以及启用 Cast Connect，充分利用语音和互动功能。

  • 通过集成 Google Play 结算服务并提供顺畅的订阅体验，更轻松地付款。

构建 TV 输入框架

观看直播电视节目以及其他基于频道的连续内容是电视体验的重要组成部分。用户习惯于通过频道浏览选择和观看电视节目。TV 输入框架会创建频道以在 TV 收视指南中发布视频或音乐内容。

TV 输入框架提供了一种统一的方法，既可以接收和播放硬件来源（例如 HDMI 端口和内置调谐器）中的直播视频内容，也可以接收和播放软件来源（例如通过互联网在线播放的内容）中的直播视频内容。如需了解详情，请参阅构建电视输入源服务。