快速配对材料和技术说明

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

快速配对材料和工艺

本部分提供了常规营销和流程信息的链接。

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

访问我们的合作伙伴营销中心，获得有关品牌塑造和 消息。新合作伙伴需要申请访问权限，而现有合作伙伴可以 已通过合作伙伴网域账号访问相应内容。

快速配对项目生命周期

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

认证流程

实现快速配对的设备必须先获得认证，然后才能获得产品 哪些广告客户可以使用这项功能进行营销通过 快速配对认证指南介绍了如何准备 以进行认证，并执行认证前自测。

认证常见问题解答涵盖了各种常见问题， 包括全面认证（或重新认证）时间的一般说明 为必填字段。

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

第三方实验室可以依序认证快速配对和音频切换。请参阅 将设备寄送到第三方实验室页面（实验室提供的第三方实验室） 哪些认证服务。

技术说明

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

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

某些设备除了支持快速配对之外，可能还想支持其他功能，例如 Google 助理或 Eddystone 等，需要额外的广告空间。 在这些情况下，轮替广告数据是最佳选择。不过， 快速配对广告仍须通过 根据可检测模式和 无法检测到模式。

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

缩短 BLE 连接时间间隔

为了改进 GATT 连接性能的构建，提供商应 尽可能缩短连接时间间隔。预期最佳值是 7.5 毫秒，适用于大多数搜索者。

BLE 通告和耳机连接状态

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

  • “当提供方设备在 BR/EDR 可检测到时（即，在配对期间 则其应通过 BLE 通告快速配对模型 ID 数据。”- 链接
  • “当无法被检测到时（即未处于配对模式），提供程序应 宣传快速配对账号数据”- 链接

TxPower

如规范中所定义，追逐者会估计距离 由 RSSI 根据给定的 TxPower 级别确定。估算的距离是关键因素 用于确定是否显示通知的因素。

确定 TxPower 的流程如下：

  1. 使用 Android 手机在 1 米处测量设备的实际输出功率 然后向其添加 41 dBm
  2. 在 BLE 通告中包含此值。
  3. 在自测报告中将此值与测试手机信息一起添加。
。

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

验证器应用提供了一项测试，可将 TxPower 手动调整为适当的 水平。合作伙伴可以使用此测试来确定合适的 TxPower 级别。

TxPower 测量程序

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

  1. 在 DUT 上打开验证器应用。
  2. 打开应用顶部的圆点菜单： <ph type="x-smartling-placeholder">
    </ph> 该测试名为“Tx 功率等级校准工具”。
  3. 将 DUT 放在距离手机 1 米处，然后点按“开始”按钮。
    测试页以黄色显示目标估算距离。
  4. 从设备列表中选择 DUT。
    系统会按 MAC 地址列出设备。
    1. 你可以点按“取消”来刷新设备列表按钮和 重新选择“START”按钮。
  5. 调整红线（代表 TxPower），直到其几乎未接触到顶部 黄色区域
    正确的调整可将红线置于黄色区域的最上方。
    1. 使用“-1”按钮将红线向黄色区域移动。
    2. 使用“+1”按钮将红线移离黄色区域。
    3. 信号干扰可能会使红线不稳定。请尝试移动到某个区域 信号干扰较小。
  6. 保存 TxPower 值，并在 DUT 和设备控制台中更新该值。
    该编号显示在屏幕顶部。

电池通知

如规范中所定义，提供商可向电池 信息。追逐者决定是显示还是隐藏 电池通知，具体取决于类型，可以设置为 0b0011，以显示电池 通知或 0b0100 可将其隐藏。以下是一些关于在什么情况下需要提供 通告中的电池信息以及要使用的类型：

  1. 在显示电池的通告中添加电池信息 在充电盒打开时0b0011显示至少 8 秒的通知 耳机已插入基座。
  2. 在隐藏电池的通告中添加电池信息 在案例关闭时发出至少 5 秒钟的“0b0100”通知，并且 耳机已插入基座。
  3. 为了在显示或隐藏电池通知时能够迅速响应， 广告应在 2 秒内反映真实状态。
  4. 您可以通过以下两种方式隐藏电池通知： <ph type="x-smartling-placeholder">
      </ph>
    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
。