将媒体应用扩展到 Android TV

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

构建 TV 应用

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

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

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

使用 Media3 ExoPlayer

Jetpack Media3 提供了一个 Player 接口，用于定义播放、暂停、跳转和显示轨道信息等基本功能。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 中，默认播放器是 ExoPlayer 类，它实现了 Player 接口。将媒体会话连接到播放器后，应用便可以向外部广告媒体播放内容，并接收来自外部来源的播放命令。媒体会话会将这些命令委托给媒体应用的播放器。

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

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

避免应用中断

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

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

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

  • 限制与内容的互动，导致用户无法控制播放。例如，如果应用在后台播放音乐或支持语音指令，则返回应用。在您的应用中使用 MediaSession 后，用户可以使用语音指令跳转和跳过歌曲或分集。

其他注意事项

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

电视无障碍功能

虽然辅助技术可以帮助弱视用户，但在 TV 应用的内容发现历程中提供无障碍功能同样很重要。

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

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

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

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

您需要使用 MediaSession 来提供一种通用的与音频或视频播放器互动的方式。如需详细了解如何实现此操作，请参阅使用 Media3 MediaSession。

首先，您的应用需要支持 Google Cast。借助它，您可以扩展 Android、iOS 和 Chrome 应用，以便将音频和视频流式传输到 Android TV 以及 Chromecast 设备和 Google 助理设备。如需了解详情，请参阅 Google Cast 文档。

您还可以帮助用户：

  • 提供媒体操作 Feed 或集成“接下来观看”功能，在各种平台上发现内容。

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

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

构建 TV 输入框架

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

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