在设备之间传输

当用户使用无线技术连接电视、家庭影院系统和音乐播放器时,他们希望能够在这些更大、音量更高的设备上播放 Android 应用中的内容。实现这种播放模式,可将您在单台设备上的单用户应用转变成一种共享体验,让多名用户都愉悦和鼓舞人心。

Android Media Router API 旨在使用通用界面在远程接收端设备上实现媒体显示和播放。然后,实现 MediaRouter 接口的应用开发者可以连接到该框架,并将内容播放到参与媒体路由器框架的设备。媒体播放设备制造商可以通过以下方式加入该框架:发布 MediaRouteProvider,允许其他应用连接到接收方设备并在上面播放媒体。图 1 说明了应用如何通过媒体路由器框架连接到接收器设备。

图 1. 简要介绍媒体路由提供程序类如何提供从媒体应用到接收方设备的通信。

注意:如果您希望应用支持 Google Cast 设备,则应使用 Cast SDK 并将您的应用构建为 Cast 发送端。请按照 Cast 文档中的说明操作,而不是直接使用 MediaRouter 框架。

MediaRouter 支持库

mediarouter API 在 AndroidX MediaRouter 库中定义。此库与搭载 Android 2.3(API 级别 9)及更高版本的设备兼容,可确保在所有设备上提供一致的体验。 如需详细了解 mediarouter API,请参阅 API 参考文档中的 androidx.mediarouter.media 软件包。

MediaRouter API
媒体应用使用 MediaRouter API 发现可用的远程播放设备并将音频和视频传送给这些设备。
MediaRouteProvider API
MediaRouteProvider API 用于定义远程播放设备的功能,并使其对使用 MediaRouter 搜索备用媒体路径的应用可见。

输出切换器

从 Android 11 开始,应用的路由选项也会显示在系统媒体播放器中。当用户改变视听环境时(例如在厨房中观看视频与在手机上观看之间切换,或者在家中收听音频与在车中收听之间切换),这有助于为用户提供无缝切换设备的流畅体验。

默认情况下,按媒体通知中的路由选择按钮后,系统会打开输出切换器,其中包含以下选项:

  • 当前设备上的扬声器
  • 所有已连接的蓝牙音频设备

应用还可以根据其功能提供更多选项,例如“投射”。

应用可以使用 MediaRouter API 自定义路由选项。您可以排除不支持的设备(例如,如果您观看的是 Netflix 智能电视,则会过滤掉仅音频模式的 Chromecast),或添加应用能够识别的其他特殊设备。