此页面由 Cloud Translation API 翻译。

使用媒体控制器测试应用

在 Android 手机、汽车、电视和耳机上通过语音与 Google 助理互动的媒体应用由 Android Media Session API 提供支持，并使用媒体操作。媒体操作生命周期可能难以跟踪。即使是简单的搜索请求播放，也包含许多中间步骤，其中可能会出错，如简化的时间轴所示：

媒体操作生命周期

图 1. 媒体操作生命周期

借助媒体控制器测试 (MCT) 应用，您可以在 Android 平台上测试媒体播放的复杂性，并帮助验证您的媒体会话实现。

“媒体控制器测试”应用有两个版本：

客户端应用是在旧版 MediaControllerCompat 之上实现的。这样，当外部应用通过旧版 MediaControllerCompat 访问基于旧版 MediaSessionCompat 或 Media3 MediaSession 构建的媒体会话应用时，您就可以对其进行测试。在 GitHub 上查找旧版的源代码。
客户端应用基于最新的 Media3 MediaController 实现。这样，您就可以在外部应用通过 Media3 MediaController 访问基于旧版 MediaSessionCompat 或 Media3 MediaSession 构建的媒体会话应用时，测试该应用。在 GitHub 上查找 Media3 版本的源代码。

MCT 会显示应用的 MediaController 的相关信息，例如 PlaybackState 和元数据，并且可用于测试应用间媒体控件。MCT 还包含一个验证测试框架，可让您自动执行质量检查测试。

如需使用 MCT，您的应用必须提供媒体浏览器服务，并且您必须允许 MCT 连接到该服务。如需了解详情，请参阅构建媒体浏览器服务。

启动 MCT

图 2. MCT 启动页面

启动 MCT 后，您会看到两个列表：

活跃的 MediaSession - 当您启动 MCT 时，此列表最初是空的，并且您会看到“未找到任何媒体应用。必须获得通知监听器权限才能扫描活跃的媒体会话。”点击设置，前往权限屏幕，然后为 MCT 启用权限。
MediaBrowserService 实现 - 此列表显示了已实现媒体浏览器服务的应用。如果您已实现媒体浏览器服务，您的应用将显示在此列表中，但只有在您将应用配置为接受所有连接或将 MCT 列入许可名单后，才能使用 MCT。如需了解详情，请参阅使用 onGetRoot() 控制客户端连接。

手动测试手机应用

如果您允许 MCT 连接到应用的媒体浏览器服务，您的应用会显示在媒体浏览器服务列表实现列表中。在其中找到该应用，然后点击控制以在后台启动该应用。

否则，您必须先自行在后台启动应用，然后在应用显示在活跃媒体会话列表中时点击控制。

测试准备和游戏

当 MCT 开始控制您的应用时，它会显示应用的当前会话元数据：当前选择的媒体以及会话准备处理的操作。

图 3. “控件”页面

MCT 控件页面顶部包含一个下拉菜单，您可以在其中选择搜索、URI、媒体 ID 或无，以及一个文本字段，用于指定与搜索、URI 或媒体 ID 相关联的输入数据（如果您选择其中一个选项）。

文本字段下方的 Prepare 和 Play 按钮会根据您选择的操作执行相应的调用（onPrepare()、onPrepareFromSearch()、onPrepareFromUri()、onPrepareFromMediaId()、onPlay()、onPlayFromSearch()、onPlayFromUri()、onPlayFromMediaId()）。