快速配对材料和技术说明

本页介绍了合作伙伴在快速配对项目规划和系统集成方面需要了解的实用信息。

快速配对材料和流程

此部分提供了指向一般营销和流程信息的链接。

营销、品牌塑造和消息传递

如需有关品牌推广和消息传递的指导，请访问我们的合作伙伴营销中心。新合作伙伴需要申请访问权限，而现有合作伙伴已可以通过其合作伙伴网域账号访问相关内容。

快速配对项目生命周期

如需大致了解项目生命周期以及将快速配对集成到产品中的合作伙伴的职责，请参阅“系统集成商 (SI) 角色和职责”页面。

认证流程

实现快速配对的设备必须先通过认证，然后才能将产品与该功能一起进行营销。《快速配对认证指南》介绍了如何准备认证以及执行认证前自检。

认证常见问题解答涵盖了各种常见问题，包括何时需要进行完整认证（或重新认证）的一般说明。

实现或使用快速配对扩展服务（例如音频切换）的设备也必须经过认证。音频切换功能有单独的认证指南，其中介绍了其自检步骤以及第三方实验室认证的准备工作。

第三方实验室可以依次认证快速配对和音频切换。如需了解哪些实验室提供哪些认证服务，请参阅将设备寄送至第三方实验室页面。

技术说明

本部分介绍了一些技术实现注意事项，以帮助合作伙伴进行开发和集成。

如何同时宣传其他协议和快速配对

某些设备可能希望在快速配对的基础上支持其他功能，例如 Google 助理或 Eddystone，这些功能需要额外的广播空间。在这些情况下，轮换广告数据是最佳选择。不过，快速配对通告仍必须在通告间隔内进行通告，具体取决于可发现模式和不可发现模式。

在认证流程的第三方测试阶段，我们会测试广告轮播。请务必在认证之前使用 快速配对验证器应用验证所有轮换方案，以免出现潜在的认证延迟、重新测试和成本问题。

缩短 BLE 连接间隔

为了提高构建 GATT 连接的性能，提供方应尽可能缩短连接间隔。预期最佳值为 7.5 毫秒，适用于大多数搜寻器。

BLE 广播和耳机连接状态

快速配对耳机是否会广播型号 ID 或账号数据取决于耳机的 BR/EDR 可发现模式，而不是连接或断开连接状态。 如需了解快速配对服务规范，请点击以下链接：

• “当提供方设备处于 BR/EDR 可发现状态（即处于配对模式）时，它应通过 BLE 广播快速配对型号 ID 数据。”- 链接
• “当提供方设备不可被发现（即未处于配对模式）时，应广播快速配对账号数据” - 链接

TxPower

如规范中所述，Seeker 会根据给定的 TxPower 级别，通过 RSSI 估算距离。估计距离是确定是否显示通知的关键因素。

确定 TxPower 的流程如下：

1. 使用距离 1 米的 Android 手机测量设备的实际输出，然后将该值加上 41 dBm。
2. 将此值包含在 BLE 广告中。
3. 在自检报告中包含此值以及测试手机信息。

注意： 合作伙伴可以通过存储在设备控制台中的 TxPower 值来更新已发货设备中的 TxPower 值。无需向设备控制台提交 TxPower 值，设备控制台中的任何值都会覆盖设备的所有 TxPower 设置。

使用验证器应用测量和设置 TxPower

验证器应用提供了一项测试，用于在 DUT 上手动将 TxPower 调整到适当的级别。合作伙伴可以使用此测试在进行自测或认证之前确定 DUT 上合适的 TxPower 级别。

注意： 测试完成后，请务必在 DUT 和设备控制台中设置 TxPower 级别。

TxPower 测量程序

如需使用验证器应用测量 TxPower，请执行以下操作：

1. 在 DUT 上打开验证器应用。
2. 打开应用顶部的三点状菜单：

   

3. 将 DUT 放置在距离手机 1 米的位置，然后点按“开始”按钮。

   

4. 从设备列表中选择 DUT。

   

   1. 您可以点按“取消”按钮，然后重新选择“开始”按钮，以刷新设备列表。
5. 调整红线（表示 TxPower），直到它刚好触及黄色区域的顶部。

   

   1. 使用“-1”按钮将红线向黄色区域移动。
   2. 使用“+1”按钮将红线移出黄色区域。
   3. 信号干扰可能会导致红线不稳定。如果红线表现不稳定，请尝试移到信号干扰较少的区域。
6. 保存 TxPower 值，并在 DUT 和设备控制台中更新该值。

   

电池通知

如规范中所定义，提供方可以在广告中包含电池信息。Seeker 会根据类型决定是否显示或隐藏电池通知，0b0011 表示显示电池通知，0b0100 表示隐藏电池通知。以下是一些关于何时在广告中包含电池信息以及使用哪种类型的准则：

1. 在广告中包含电池信息，当充电盒打开且两个耳机均已插入基座时，显示电池通知 0b0011 至少 8 秒。
2. 在广告中包含电池信息，并隐藏电池通知 0b0100 至少 5 秒（当充电盒关闭且两个耳机均已插入基座时）。
3. 为了及时显示或隐藏电池通知，广告应在 2 秒内反映真实状态。
4. 您可以通过以下 2 种方式隐藏电池通知：
   1. 停止在广告中包含电池信息，Seeker 会在一段时间后隐藏通知（目前设置为 20 秒）。
   2. 在包含电池信息的广播中添加隐藏电池通知 0b0100，Seeker 在收到广播后会立即隐藏通知。
5. 如果充电盒打开或关闭时只有一个耳机入盒，则可以选择在广告中包含电池信息。
6. 当耳机从充电盒中取出或放置在充电盒中时，可以选择在广告中包含电池信息。
7. 为防止跟踪，提供方应仅在需要时（而非始终）在广告中包含原始电池数据。

实现应在认证的自检结果中进行说明。

如何启用快速配对日志记录

在调试之前，请确保您已在设备上启用 Bluetooth HCI 信息收集日志。此外，为防止关键的快速配对日志因安全原因而被编辑，请使用您的测试 Google 账号加入 Fast Pair Partner Test Google Group ([e-mail])。

如需在调试日志中捕获快速配对消息，请运行以下命令：

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google 建议在每个启动序列中运行上述命令。

注意： VERBOSE 日志可能会在正式版 build 中被剥离。

如何提取调试日志

运行 $ adb bugreport 以生成应包含所有数据的 ZIP 文件。生成 ZIP 文件可能需要几分钟时间。

根据 Android 版本，运行以下命令之一以获取 btsnoop_hic.log：

• 对于 Android 8.x 及更高版本： shell $ adb pull data/misc/bluetooth/logs logs
• 对于 Android 7.x： shell $ adb pull sdcard/btsnoop_hci.log

注意： Google 建议您将手机放在蓝牙设备旁边几分钟，然后再尝试下载 bug 报告 zip 文件。