音频切换认证准则

认证准备

1. 准备测试设备。
   • 您需要 5 台 Android 设备。
     • 这些设备必须包含：
       • 至少有一个 Android T (13) 和一个 Android S (12)。
       • 至少一部三星手机和一部 Pixel。
       • 例如：
         • 1 OnePlus (Android 10)。
         • 3 Samsung（Android 11、12、13）。
         • 1 个 Pixel (Android 13)。
   • 一台未启用“音频切换”功能的设备：
     • 任何 iPhone、PC、支持蓝牙 (BT) 的笔记本电脑或已停用音频切换功能的 Android 手机。
       • 您可以在蓝牙设备详细信息设置中关闭音频切换功能。
     • 除了 5 部测试手机之外，多点 (MP) 测试用例 2.8 还需要一台不带音频切换功能的设备。
2. 使用您的测试帐号加入音频切换测试组，以便在测试手机上显示调试通知。
   • 这也使得 Google 能够通过 Google Analytics（分析）收集测试数据。
3. 确保所有 Android 设备均已安装 GmsCore 23.xx.xx 或更高版本。

认证标准

• 在所有测试用例中，目标切换成功率都必须超过 95%。
• 在需要开关的测试中，至少 75% 的案例中，必须在触发音频事件后 3 秒内完成配置文件连接和切换活动状态。

测试指南

被测设备 (DUT) 准备

• 验证 BT 设备之前未与登录测试 Google 帐号的任何手机配对。
  • 如果设备已与测试 Google 帐号配对，请执行以下操作以清除配对记录：
    • 在已配对的设备上：
      • 前往蓝牙设置。
      • 选择“取消保存设备”。
      • 开启和关闭飞行模式。
  • 确保“自动保存设备”处于开启状态。
    • 此开关默认处于关闭状态。
    • 您可以在“设置”>“Google”>“设备”>“已保存的设备”（每个 DUT 一个设备）中找到此选项。
  • 将蓝牙设备设为配对模式。
  • 与初始蓝牙设备 (A) 配对。
  • 将后续蓝牙设备与其他设备（B、C、D 等）配对。

范围

• 所有耳机都会从音频切换自测模板中的各个标签页运行测试。
• 仅支持 SinglePoint (SP) 模式的耳机会运行以下内容：
  • “Generic_test”标签页。
• 支持 MP 模式的耳机会运行：
  • “Generic_test”标签页。
  • Multipoint_only 标签页。
• 可以切换到 SP 模式的 MP 耳机会运行以下设备：
  • 停用了 MP 的 Generic_test 标签页。
  • 启用 MP 的 Generic_test 标签页。
  • MP 处于开启状态的“Multipoint_only”标签页。

完成自我休息和自测报告

• 将所有测试用例至少运行两次。
• 测试的执行形式如下：

1. 设备 A=Android S (12) + 设备 B=Android T (13)
2. 设备 A=Android T (13) + 设备 B=Android S (12)
3. 设备 B 将是主 DUT。
   • 在模板顶部的“手机”和“操作系统”字段中输入设备 B 的详细信息。

示例测试用例：

• 测试手机：

  • 设备 1：Samsung (Android 13)
  • 设备 2：Pixel（Android 12 或 13）及其他设备。

• 执行的测试：

  • 第 1 次运行。设备 A=Samsung S10+ (12)，设备 B=Pixel 7 Pro (13) 列 D：手机=Pixel 7 Pro、OS=Android 13
  • 运行 2. 设备 A=Pixel 7 Pro (13)，设备 B=Pixel 6(12) 列 E：手机=Pixel 6，OS=Android 12

自测模板中已完成测试的示例：

音频事件：

• 已测试的音频事件有 4 种类型，推荐的测试应用包括：
  1. 调用：
     1. 内置的电话应用。
  2. VoIP：任何 VoIP 应用都可以运行，例如：
     1. 音频切换测试应用。
     2. Facebook Messenger。
     3. Line。
     4. WhatsApp。
     5. Google Meet。
     6. Google Meet。
  3. 媒体：任何音频播放器都可以运行，例如：
     1. 音频切换测试应用。
     2. YouTube Music。
     3. Apple Music。
     4. Spotify。
     5. Google 播客。
  4. 游戏：
     1. 音频切换测试应用。

注意 ：如需了解详情，请参阅音频切换测试应用部分。

调试信息：

• 加入 fp-sass-partner-test 群组后，系统会启用通知。下面是一些示例：

  1. 最新状态通知：

  2. 无切换通知：

注意 ：“最新状态”是指发生音频事件时的连接状态，而不是当前最新事件。

1. 切换延迟时间通知：

延迟时间测量

注意： “搜寻者”是指您用来连接受测耳机的手机或平板电脑，在测试用例中也称为设备 A、B、C、D 或 E。

• 切换延迟时间有两种：
  1. 将蓝牙配置文件连接到已断开连接的搜寻者。
     • 这包括所有 SinglePoint 情况以及目标寻道程序（设备 B）断开连接的一些 MP 情况。
  2. 切换已连接的主动搜索者。
     • 这包括目标搜寻者（设备 B）已连接的一些 MP 的情况。
• 您可通过以下两种方式检索延迟时间信息：
  1. 所有延迟都可以由 adb 命令转储。
     • 如需了解详情，请参阅转储延迟部分。
     • 此命令可以提供并记录完成至少一个测试用例后的延迟时间。
  2. 使用音频切换测试应用。
     • 在目标搜寻者上运行的应用将在切换后显示延迟。
     • 如果没有切换，应用将显示“无切换”原因。

音频切换测试应用：

• 在自测期间使用应用触发 VoIP/媒体/游戏音频事件可简化测试设置并缩短探索者的事件延迟时间。
  • 请在此处下载版本 1.03。

注意 ：您需要有 Google 帐号才能请求访问下载链接。授予访问权限的流程可能需要几天时间才能完成。

• 应用安装：
  • 将该 APK 复制到测试手机并打开。
  • 或者，您也可以使用 adb install audio_test_app.apk。

警告 ：首次打开应用时，授予所有权限。

• 如果您看到一个请求通知访问权限的对话框，请执行以下操作：
  1. 点击“确定”
  2. 在应用列表中选择“FP SASS 测试”
  3. 授予通知访问权限。

应用概览：

目标提供商

点击此按钮后，系统会显示已配对蓝牙设备的列表。选择您要测试的 SDK。

“连接”和“断开连接”按钮的作用与蓝牙设置的设备详细信息中的按钮类似。

当前状态

此字段显示探索者使用 BLE 通告或事件流从提供程序收到的最近一次连接状态。

音频切换调试通知也会显示在此处。

追逐者类型

此选项用于在设备间切换音频流。

音频类型

VoIP 选择此模式会将音频模式更改为 AudioManager.MODE_IN_COMMUNICATION 并调用 AudioManager.startBluetoothSco，然后使用 USAGE_VOICE_COMMUNICATION 播放音频。

• 数据流类型为 STREAM_VOICE_CALL。
• 提供程序连接状态应在 5 秒内切换为 CONNECTED_HFP。

媒体 选择此模式将播放支持 AVRCP 的音频。音频使用类型为：USAGE_MEDIA。

• 提供方连接状态应在 5 秒内切换为 CONNECTED_A2DP_WITH_AVRCP。
• 连接状态在启动或停止时可能会暂时切换到 CONNECTED_A2DP_ONLY。

游戏 选择此模式后，系统将播放不支持 AVRCP 的音频。音频使用类型为：USAGE_GAME。

• 提供程序连接状态应在 5 秒内切换为 CONNECTED_A2DP_ONLY。

“播放”和“停止”按钮

使用“播放”和“停止”按钮可开始或停止播放音频。

切换结果

此字段显示“连接和切换”活动延迟时间。如果触发了音频事件但未发生切换，该图还会显示拒绝切换的原因。

• 延迟时间以毫秒 (ms) 为单位。
• 一般来说，延迟时间是从音频切换触发器开始到收到已连接的 BT 配置文件或通知多点切换事件之间的这段时间测得的。
• 提供程序触发的开关会测量从音频启动开始的延迟时间。

转储延迟时间

• 使用以下命令，可让用户在运行手动测试时捕获延迟时间测量结果： adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • 延迟时间测量结果显示在 NearbyDeviceManager 的 SwitchHistory 部分下：

            NearbyDeviceManager
              Nearby Sass device count: 1
                Sass device - address:XX:XX:XX:XX:XX:XX, name:Googler's Pixel Buds, accountKey:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, modelId:6edaf7
                  SwitchHistory
                    15:30:21:166 - 15:30:25:201, latency 3035ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:34:58:568 - 15:34:58:568, latency 0ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, HFP
                    15:36:26:615 - 15:36:31:603, latency 1988ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:37:56:108 - 15:37:56:250, latency 142ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, A2DP"

• GmsCore 无法衡量的任何开关（例如，HFP 的有效开关）都会被记录为 0 毫秒的延迟时间。

日志模式参考：

已知问题：

以下是由探索器导致的已知错误：

1. 游戏音频切换不正确。
   • 三星手机在玩游戏时会将连接状态设置为 CONNECTED_A2DP_WITH_AVRCP，而不是 CONNECTED_A2DP_ONLY。
   • 某些游戏（例如《糖果传奇》）可能会在没有用户输入的情况下重放背景音乐并触发新的音频事件。已连接的手机可能会不断地在打开游戏的每部手机上切换音频。