为认证做准备
- 准备测试设备。
- 您将需要 5 部 Android 设备。
- 这些设备必须包括:
- 至少一个 Android T (13) 和一个 Android V (15)。
- 至少有一部三星手机和一个 Pixel 手机。
- 例如:
- 1 部 OnePlus(Android 10)。
- 3 Samsung(Android 11、12、13)。
- 1 部 Pixel (Android 15)。
- 这些设备必须包括:
- 一台不带音频开关的设备:
- 任何启用了蓝牙 (BT) 的 iPhone、PC、停用了音频切换功能的 Android 手机。
- 您可以在蓝牙设备详细信息设置中关闭“音频切换”功能。
- 除了 5 部测试手机外,多点 (MP) 测试用例 2.8 还需要一部不带音频开关的设备。
- 任何启用了蓝牙 (BT) 的 iPhone、PC、停用了音频切换功能的 Android 手机。
- 您将需要 5 部 Android 设备。
使用测试账号加入音频开关测试组,以便在测试手机上显示调试通知。
- 这还可让 Google 通过 Google Analytics 收集测试数据。
经典版(支持 A2DP+HFP)
- 确保所有 Android 设备都安装了 GmsCore 版本
23.xx.xx
或更高版本。
BLE 与 LE 音频
- 至少有两部参照手机必须支持 LE 音频。
- 例如,一部支持 LE 音频的三星手机和一部 Pixel 手机。
- 确保所有 Android 设备都安装了 GmsCore 版本
24.33.xx
或更高版本。
认证标准
- 在所有测试用例中,目标切换成功率必须超过 95%。
在需要切换的测试中,在至少 75% 的情况下,配置文件连接和切换有效状态必须在触发音频事件后 3 秒内完成。
经典版(支持 A2DP+HFP)
必须按以下组合执行自测:
- 手机 A=Android S (12) + 手机 B=Android T (13)
- 手机 A=Android T (13) + 手机 B=Android S (12)
BLE 搭配 LE 音频
必须通过以下组合执行自测:
- 手机 A:BT Classic,手机 B:BT Classic
- 手机 A:LE 音频,手机 B:BT 经典款
- 手机 A:传统蓝牙,手机 B:LE 音频
(可选)支持双 LE 音频连接的提供程序应测试:
- 手机 A:LE 音频,手机 B:LE 音频
测试指南
被测设备 (DUT) 准备
- 验证 BT 设备之前未与已登录测试 Google 账号的任何手机配对。
- 如果设备已与测试 Google 账号配对,请执行以下操作以清除配对:
- 在已配对的设备上:
- 前往蓝牙设置。
- 选择“取消保存设备”。
- 开启和关闭飞行模式。
- 在已配对的设备上:
- 确保“自动保存设备”处于开启状态。
- 此开关默认处于关闭状态。
- 您可以在“设置”>“Google”>“设备”>“已保存的设备”(每个 DUT 一个)中找到此选项。
- 将蓝牙设备设为配对模式。
- 配对初始蓝牙设备 (A)。
- 将后续的蓝牙设备与其他设备(B、C、D 等)配对。
- 如果设备已与测试 Google 账号配对,请执行以下操作以清除配对:
范围
- 所有耳机都会从音频切换自测模板中的各个标签页运行测试。
- 仅支持单点 (SP) 模式的耳机会运行以下命令:
- Generic_test 标签页。
- 支持 MP 模式的耳机会运行以下运行命令:
- Generic_test 标签页。
- “Multipoint_only”标签页。
- 可切换到 SP 模式的 MP 耳机会运行以下命令:
- 关闭 MP 的 Generic_test 标签页。
- 启用 MP 的 Generic_test 标签页。
- 开启 MP 的 Multipoint_only 标签页。
完成自我休息和自测报告
- 创建一份音频开关自测报告。
- 运行所有测试用例至少两次。
测试应采用以下形式执行:
带 A2DP+HFP 的传统模式
- 设备 B 将是主要 DUT。
- 在模板顶部的“Phone”和“OS”字段中输入设备 B 的详细信息。
测试用例示例:
测试手机:
- 设备 1:三星(Android 13)
- 设备 2:Pixel(Android 12 或 13)及其他设备。
执行的测试:
- 运行 1. 设备 A=Samsung S10+ (12),设备 B=Pixel 7 Pro (13) 列 D:手机=Pixel 7 Pro,操作系统=Android 13
- 运行 2. 设备 A=Pixel 7 Pro (13),设备 B=Pixel 6(12) 列 E:手机=Pixel 6,操作系统=Android 12
自测模板中已完成的测试示例:
BLE 搭配 LE 音频
- 设备 A=Android V (15) + 设备 B=Android T (13)
- 设备 A=Android T (13) + 设备 B=Android V (15)
- 设备 A=Android T (13) + 设备 B=Android S (12)
- 设备 A=Android T (15) + 设备 B=Android V (15)
- 设备 B 将是主要 DUT。
- 在模板顶部的“Phone”和“OS”字段中输入设备 B 的详细信息。
测试用例示例:
测试手机:
- 设备 1:三星 (Android 13)
- 设备 2:Pixel (Android 15) 及其他设备。
已执行的测试:
- [LEA+BT]:设备 A=Pixel 8 (15),设备 B=Pixel 7 Pro (13),列 D:手机=Pixel 7 Pro,操作系统=Android 13
- [BT+LEA]:设备 A=Pixel 7 (13),设备 B=Pixel 8 (Android 15) 列 E:手机=Pixel 8,操作系统=Android 15
- [BT+BT]:设备 A=Pixel 7 Pro (13),设备 B=Samsung S10+ (12) 列 E:手机=Samsung S10+,操作系统=Android 12
- [LEA+LEA]:设备 A=Pixel 8 (15),设备 B=Pixel 8(15) 列 E:手机=Pixel 8,操作系统=Android 15
以下是自测模板中已完成测试的示例:
音频事件:
测试的音频事件有 4 种类型,推荐的测试应用分别是:
- 致电:
- 内置的“电话”应用。
- VoIP:任何 VoIP 应用均可使用,例如:
- “音频切换测试”应用。
- FB Messenger。
- Line。
- WhatsApp。
- Google Meet。
- Google Meet。
- 媒体:任何音频播放器都可以,例如:
- 音频切换测试应用。
- YouTube Music。
- Apple Music。
- Spotify。
- Google 播客。
- 游戏:
- “音频切换测试”应用。
- 致电:
调试信息:
在加入 fp-sass-partner-test 组后启用通知。下面是一些示例:
- 最新状态通知:
- 无切换通知:
- 切换延迟时间通知:
延迟时间测量
- 切换延迟时间有两种类型:
- 将蓝牙配置文件连接到断开连接的 Seeker。
- 这包括所有 SinglePoint 用例,以及目标搜寻器(设备 B)断开连接的某些 MP 用例。
- 切换已连接的活跃 Seeker。
- 这包括连接目标寻找器(设备 B)的一些 MP 用例。
- 将蓝牙配置文件连接到断开连接的 Seeker。
- 您可以通过以下两种方式检索延迟时间信息:
音频切换测试应用:
- 在自测试期间使用应用触发 VoIP/媒体/游戏音频事件将简化测试设置并缩短 Seeker 的事件延迟时间。
- 可在此处下载最新版本。
- LE 音频 VoIP 测试需要手动启用政策: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot
- 应用安装:
- 将 APK 复制到测试手机并打开。
- 或者,您也可以使用
adb install audio_test_app.apk
。
- 如果您看到一个请求通知访问权限的对话框,请执行以下操作:
- 点击“确定”
- 在应用列表中选择“FP SASS test”
- 授予通知使用权。
应用概览:
目标提供商
- 点击此按钮后,系统会显示已配对的蓝牙设备列表。选择您要测试的 Feed。
- “连接”和“断开连接”按钮的作用与蓝牙设置的设备详细信息中的按钮类似。
当前状态
- 此字段显示搜寻器上次使用 BLE 广播或事件流从提供程序收到的连接状态。
- 此处还显示了音频切换调试通知。
搜寻者类型
- 此选项用于在设备音频流之间切换。
音频类型
带 A2DP+HFP 的传统模式
- 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 的音频。音频使用类型为:
- 游戏
- 如果选择此模式,系统会播放不支持 AVRCP 的音频。音频使用类型为:
USAGE_GAME
。 - 提供程序连接状态应在 5 秒内切换为
CONNECTED_A2DP_ONLY
。
- 如果选择此模式,系统会播放不支持 AVRCP 的音频。音频使用类型为:
BLE 与 LE 音频
VoIP
- 选择此模式将会将音频模式更改为
AudioManager.MODE_IN_COMMUNICATION
,并使用USAGE_VOICE_COMMUNICATION
播放音频。
- 数据流类型为
STREAM_VOICE_CALL
。 - 提供程序连接状态应在 5 秒内切换为
CONNECTED_LE_AUDIO_CALL
。
- 选择此模式将会将音频模式更改为
媒体
- 如果选择此模式,系统会播放流类型为
STREAM_MUSIC
的音频。 音频使用类型为:USAGE_MEDIA
。 - 提供程序连接状态应在 5 秒内切换为
CONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL
。 - 启动或停止时,连接状态可能会短暂切换为
CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL
。
- 如果选择此模式,系统会播放流类型为
游戏
- 选择此模式会播放用户无法直接控制的音频。音频使用类型为:
USAGE_GAME
。 - 提供程序连接状态应在 5 秒内切换为
CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL
。
- 选择此模式会播放用户无法直接控制的音频。音频使用类型为:
“播放”和“停止”按钮
- 使用“播放”和“停止”按钮可启动或停止音频。
切换结果
- 此字段显示连接和切换活动延迟时间。如果触发了音频事件但未发生切换,它还会显示拒绝切换的原因。
- 延迟时间以毫秒 (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 毫秒的延迟时间。
日志模式参考:
已知问题:
以下是搜寻者导致的已知错误:
- 游戏音频切换错误。
- 在玩游戏时,三星手机会将连接状态设置为
CONNECTED_A2DP_WITH_AVRCP
,而不是CONNECTED_A2DP_ONLY
。 - 某些游戏(例如《糖果传奇》)可能会在没有用户输入的情况下重放背景音乐并触发新的音频事件。连接的手机可能会不断切换打开游戏的每部手机的音频。
- 在玩游戏时,三星手机会将连接状态设置为