快速配对材料和技术说明

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

快速配对材料和流程

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

营销、品牌推广和消息传递

请访问我们的合作伙伴营销中心，获取有关品牌推广和宣传方面的指导。新合作伙伴需要申请访问权限，而现有合作伙伴已经可以通过其合作伙伴网域账号访问这些内容。

快速配对项目生命周期

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

认证流程

实现“快速配对”功能的设备必须先经过认证，然后才能在市场上销售。快速配对认证指南介绍了如何准备认证和执行认证前自测。

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

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

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

技术说明

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

如何在使用快速配对的同时通告其他协议

某些设备可能希望在“快速配对”的基础上支持其他功能（例如 Google 助理或 Eddystone），这些功能需要额外的通告空间。 在这种情况下，轮替通告数据是最佳选择。不过，快速配对通告仍必须根据可检测到模式和不可检测到模式在通告间隔内进行通告。

在认证流程的第三方测试阶段，我们会测试广告轮播。请务必在认证前使用“快速配对”验证器应用验证所有轮替方案，以免可能出现认证延迟、重新测试和费用。

缩短 BLE 连接间隔

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

BLE 广播和耳机连接状态

快速配对耳机是广播模型 ID 还是账号数据取决于耳机的 BR/EDR 可检测模式，而不是连接或断开连接状态。 请通过以下链接参阅“快速配对服务规范”：

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

TxPower

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

确定 TxPower 的过程如下：

1. 使用 Android 手机在 1 米外测量设备的实际输出，然后加上 41 dBm。
2. 在 BLE 通告中添加此值。
3. 在自测报告中，将此值与测试手机信息一并提供。

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

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

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

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

TxPower 测量过程

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

1. 在测试手机上打开 Validator 应用。
2. 打开应用顶部的点状菜单：

   

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

   

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. 为防止跟踪，提供方应仅在需要时（而非始终）在通告中包含原始电池数据。

应在认证自测结果中说明实现。

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

在调试之前，请确保您已在设备上启用蓝牙 HCI 信息收集日志。此外，为防止关键的快速配对日志因安全原因而被隐去，请使用您的测试 Google 账号加入快速配对合作伙伴测试 Google 群组 ([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 文件。