快速配对材料和技术说明

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

快速配对材料和流程

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

营销、品牌和宣传

如需有关品牌塑造和宣传信息的指导，请访问我们的合作伙伴营销中心。新合作伙伴需要申请访问权限，而现有合作伙伴已经可以通过其合作伙伴网域帐号访问内容。

快速配对项目生命周期

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

认证流程

实现快速配对的设备必须先进行认证，然后产品才能通过该功能进行营销。快速配对认证指南介绍了如何准备认证和执行预认证自行测试。

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

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

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

技术说明

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

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

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

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

缩短 BLE 连接间隔

为了提升 GATT 连接性能的构建，提供程序应尽可能缩短连接间隔。预期的最佳值为 7.5 毫秒，这适用于大多数探索者。

BLE 通告和耳机连接状态

快速配对耳机是否播发型号 ID 或帐号数据取决于耳机的 BR/EDR 可检测模式，而不是连接或断开连接状态。请访问以下链接，参阅快速配对服务规范：

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

TxPower

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

确定 TxPower 的过程如下：

  1. 在距离为 1 米的位置使用 Android 手机测量设备的实际输出，并在输出中增加 41 dBm。
  2. 在 BLE 通告中包含此值。
  3. 在自测报告中添加此值以及测试手机信息。

使用验证工具应用测量并设置 TxPower

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

TxPower 测量过程

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

  1. 在 DUT 上打开验证工具应用。
  2. 打开应用顶部的圆点菜单：
    该测试名为“Tx 功率电平校准工具”。
  3. 将 DUT 放在距离手机 1 米的位置，然后点按“开始”按钮。
    测试页以黄色显示目标估算距离。
  4. 从设备列表中选择 DUT。
    系统会按照 MAC 地址列出设备。
    1. 如需刷新设备列表，请点按“取消”按钮，然后重新选择“开始”按钮。
  5. 调整红线（表示 TxPower），直到几乎触及黄色区域的顶部。
    正确的调整会将红线置于黄色区域的最顶部。
    1. 使用“-1”按钮将红线朝黄色区域移动。
    2. 使用“+1”按钮将红线移离黄色区域。
    3. 信号干扰可能会导致红线不稳定。如果红线行为不稳定，请尝试移动到信号干扰较弱的区域。
  6. 保存 TxPower 值，并在 DUT 和设备控制台中对其进行更新。
    电话号码显示在屏幕顶部。

电池通知

如规范中所定义，提供程序可以在通告中包含电池信息。探索器根据类型决定是显示或隐藏电池通知，0b0011 表示显示电池通知，0b0100 表示隐藏。下面介绍了一些准则，可帮助您了解何时应在通告中添加电池信息以及应使用哪种类型：

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

应在认证的自测结果中描述实现情况。

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

在调试之前，请确保您已在设备上启用蓝牙 HCI 信息收集日志。

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

$ 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 建议对每个启动序列运行上述命令。

如何提取调试日志

运行 $ 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