LE Audio 验证器应用用户手册

本页面仅适用于 LE Audio 版验证器应用。如需有关音频开关版验证器应用的帮助,请参阅“音频开关验证器应用”页面

设置

如需在验证工具应用中启用测试,请执行以下操作:

  • 确保设备搭载的是 GmsCore 23.37.xx 或更高版本。
  • 确保您的测试电子邮件地址已加入快速配对合作伙伴测试组
    • 新注册的电子邮件地址和电话号码可能需要 6 至 24 小时才能同步权限。
    • 登录和退出关联的 Google 账号也可能会触发立即同步。

您可以在 Google Play 服务的“应用信息”页面中找到 GMS 版本。

所需设备

测试至少需要两部(2 部)手机:

  • 一台搭载 Android 15 (U) 且支持 LE Audio 的设备(例如 Pixel 7)
  • 一台搭载 Android 6-13 (M-T) 且不支持 LE 音频的设备。
    • 仅流量设备只需使用其中一部手机即可。

在 Android 15 上连接到 LE 音频配置文件 (V)

Android 15 (V) 未原生启用 LE 音频。如需启用此功能,请执行以下操作:

  • 在手机上前往“开发者选项”页面。
    • 如需启用开发者选项,请执行以下操作:
    • 依次前往设置 > 系统 > 关于手机 > build 号
    • 点按“版本号”7 次。
  • 关闭“停用蓝牙 LE 音频”。
  • 开启“绕过蓝牙 LE 音频许可名单”。
  • 重新启动手机。

此图显示了“开发者选项”页面下的 LEA 开关。

为仅限数据的设备启用 BLE 测试

如果设备的型号 ID 在设备控制台中选择了“仅限数据连接”,验证器应用将显示“仅限数据”测试菜单(注意:并非所有设备类型都提供此选项)。此模式的测试菜单如下所示:

开启该开关后,应用会自动更新仅限流量的设备的测试列表。

为不支持 LE 音频的设备启用 BLE 规范和 BT 传统测试

测试人员需要切换“启用 LE 规格测试”开关,才能看到 BLE 测试。 测试人员需要确认被测设备不支持 LE 音频,才能看到 BT 传统测试,如下所示:

只有在测试人员确认设备不支持 LE 音频后,测试列表才会更新。

在搭载 Android 14 (U) 或更高版本的 Pixel 手机上启用 BLE 规范和 LE 音频测试

测试人员需要切换“启用 LE 规范测试”开关,才能看到 BLE 测试。 然后,测试人员必须确认其余提示,才能看到测试界面。应用将自动填充此配置的可用测试,包括 LE Audio 测试,如下所示:

由于 Pixel 手机是已知配置,因此应用可以填充正确的测试列表。

在搭载 Android 13 (T) 或更低版本的 Pixel 手机上启用 BLE 规范和 LE 音频测试

测试人员需要切换“启用 LE 规格测试”开关,才能看到 BLE 测试。 然后,测试人员必须确认其余提示,才能看到测试界面。应用会自动为此配置填充可用测试,包括 BT 传统测试,如下所示:

由于 Pixel 手机是已知配置,因此应用可以填充正确的测试列表。

在支持 LE 音频的非 Pixel 手机上启用 BLE 规范和 LE 音频测试

测试人员需要切换“启用 LE 规格测试”开关,才能看到 BLE 测试。 测试人员必须告知验证器应用测试手机和设备(查找器)是否支持 LE 音频连接。应用无法了解非 Pixel 手机的此类信息,因为功能支持由原始设备制造商 (OEM) 控制。在弹出式窗口中选择 LE 音频支持后,系统会启用 LE 音频测试,如下所示:

如果用户确认非 Pixel 手机支持 LE 音频,系统会显示 LE 音频测试。

在支持 A2DP 和 HFP 的非 Pixel 手机上启用 BLE 规范和 LE 音频测试

测试人员需要切换“启用 LE 规格测试”开关,才能看到 BLE 测试。 测试人员必须告知验证器应用测试手机和设备(查找器)是否支持 LE 音频连接。应用无法获知非 Pixel 手机的此类信息,因为功能支持由原始设备制造商 (OEM) 控制。在弹出式窗口中选择 A2DP + HFP 支持后,系统会启用传统 BT 测试,如下所示:

如果用户为非 Pixel 手机选择 A2DP + HFP 支持,系统会显示 BT 传统测试。

强制性测试

如需了解给定快速配对版本和设备类型需要进行哪些测试,请参阅“必须进行的测试”部分。请注意,此表格针对仅限流量的设备、搭载 Android 13 或更低版本的手机以及搭载 Android 14 或更高版本的手机提供了单独的标签页。

常见音频服务 UUID 验证

此测试用于验证 LE 可连接广告是否包含 CAS UUID,如 Bluetooth Adapter Profile (BAP 1.0.1)Common Audio Profile 要求所述。

成功的测试将如下所示:

成功的测试会在日志中显示“通过”结果。

此测试用于验证提供程序在初始配对(身份地址)和后续配对 (RPA) 尝试期间进行广告宣传时是否使用了正确的地址类型(快速配对服务数据 [0xFE2C])。

  • 支持从传统蓝牙到 LE 的 CTKD 的设备应在初始配对期间通告 RPA。
  • 所有其他支持从 LE 到 Classic 的 CTKD 的设备都应在初始配对期间通告其标识地址。
  • 所有设备(无论是否支持 CTKD)都应在后续配对期间通告其 RPA。

成功的测试将如下所示:

成功的测试会在日志中显示“通过”结果。

在 BLE 规范模式下测试更改

启用“启用 LE 规范测试”开关后,部分测试将发生变化。 例如,“电池电量更新”测试将更改为“使用 LE 音频连接的电池电量更新”和“使用传统配置文件连接的电池电量更新”。修改后的测试将仅显示在其各自的 Android 版本中。

任何发生此类更改的测试都必须在 2 部手机上进行测试,以确保正常运行,其中一部手机不支持 LE 音频,另一部手机支持 LE 音频。对于 Pixel 手机,这意味着需要在搭载 Android 14 (U) 或更高版本的手机和搭载 Android 13 (T) 或更低版本的手机上进行测试。对于非 Pixel 手机,这意味着需要在已实现 LE Audio 的手机和仅实现 A2D + HFP 的手机上进行测试。

变更示例:

在 Android 14 或更高版本中,测试会更改为 LE Audio;而在 Android 13 或更低版本中,测试会使用 BLE Classic。

如何将结果上传到设备控制台

如何提交结果

“提交结果”按钮会显示测试结果摘要,但不会实际将结果提交给 Google。

提交流程从按下“提交结果”按钮开始。

查看所有结果后,按结果页面底部的“提交”按钮,将结果提交给 Google。

滚动到搜索结果页的底部并按

在设备控制台中查看上传的结果

您可以在附近分享的控制台中找到提交的测试结果。(音频开关测试用例中的距离指标和时长指标将被移除)。例如:

测试结果会显示在附近分享控制台中的表格中。

问题排查

如果所有测试都失败,请尝试关闭并重新开启蓝牙。

您可以通过下拉菜单中的按钮启用和停用蓝牙。

未收到 KeyBasedPairingResponse

如果配对成功,但仍然显示如图所示的错误消息,则可能是因为 GMS 核心版本过低。验证手机是否已按照设置部分中的说明进行配置。

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在端到端集成测试中显示 KeyBasedPairingResponse 错误。 在自动配对和自动后续配对测试中,应用显示 KeyBasedPairingResponse 错误。

KeyBasedPairingResponse 类型有误

这可能是由提供程序发送错误的消息类型所致。支持 LE Audio 的 Seeker 应接收消息类型 2,所有其他情况均应接收消息类型 1。

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在端到端集成测试中显示 KeyBasedPairingResponseType 错误。 在自动配对和自动后续配对测试中,应用显示 KeyBasedPairingResponseType 错误。

KeyBasedPairingExtensionResponse 地址长度有误

这可能是由于为 LE 音频设备选择了错误的 CSIP 支持类型所致。支持 CSIP 和 LE Audio 的设备应收到地址长度为 2 的地址,所有其他情况均收到地址长度为 1 的地址。

以下屏幕截图展示了此错误在不同测试中的表现形式。

在端到端集成测试中,应用显示 KeyBasedPairingExtensionResponse 地址长度错误。 在自动配对和自动后续配对测试中,应用显示 KeyBasedPairingExtensionResponse 地址长度错误。

状态错误

这通常是由于提供程序(设备)未能连接而导致的。对于 CSIP 设备,必须有两个 (2) 个连接事件。

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在端到端集成测试中显示状态错误。 应用在自动配对和自动后续配对测试中显示状态错误。

仅接收来自 1 个地址的连接事件

当 Seeker 仅从 CSIP 设备收到 1 个地址时,就会出现这种情况。支持 CSIP 的设备应始终提供 2 个地址。

以下屏幕截图展示了此错误在不同测试中的表现形式。

在自动配对和自动后续配对测试中,应用显示了来自 1 个地址错误的唯一接收连接事件。

未收到 UUID

查找方未收到任何类型的 UUID。

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在 E2E 集成测试中显示 UUID 错误。 应用在自动配对和自动后续配对测试中显示 UUID 错误。

未收到预期的 UUID

在不同场景下,Seeker 预计会收到特定类型的 UUID。下表定义了在这些不同情况下 UUID 应为何值。

提供方支持 LE 音频 提供方不支持 LE 音频 提供方是仅限流量的设备
Seeker 不支持 BLE 110B、1108 或 111E 110B、1108 或 111E 不适用
Seeker 支持 BLE 110B、1108 或 111E 110B、1108 或 111E 1812
Seeker 支持 BLE 和 LEA 184E 110B、1108 或 111E 1812

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在 E2E 集成测试中显示意外的 UUID 错误。 应用在自动配对和自动后续配对测试中显示意外的 UUID 错误。

仅从 1 个地址接收正确的 UUID

当 Seeker 仅从 CSIP 设备收到 1 个地址时,就会出现这种情况。支持 CSIP 的设备应始终提供 2 个地址。

以下屏幕截图展示了此错误在不同测试中的表现形式。

应用在 E2E 集成测试中显示“仅收到 1 个 UUID”错误。 在自动配对和自动后续配对测试中,应用显示仅收到 1 个 UUID 错误。