此常见问题解答涵盖了与快速配对相关的常见问题。
工具和集成
本部分介绍了快速配对规范、工具和集成测试。
快速配对规范
- 对于给定的设备类型和快速配对版本,我需要实现哪些功能?
- 快速配对是否与特定功能(LE 音频等)集成?
- 如何知道我的项目(而非模型 ID)是否处于有效状态?
- 如何知道设备的型号 ID 是否处于有效状态?
验证器应用
设备行为
- 如何在设备获得认证之前查看设备上的半页和通知?
- 为什么后续配对通知未显示在第 2 部设备上?
- 为什么我的设备停止显示半页通知?
short time banned
是什么意思?- 在哪里可以找到模型 ID 防欺骗密钥?
- 在配对模式下,我能否使用设备的公共地址进行广告宣传,而不是使用 RPA?
- 当配套应用已在前台打开时,为什么我的设备上不显示快速配对半页?
设备控制台
- 为什么我无法在设备控制台中创建项目?
- 我是否必须向 Bluetooth SIG 注册公司名称?
- 如何手动将数据上传到设备控制台?
- 设备控制台中的更改需要多长时间才能与指定设备同步?
- 如何强制将设备控制台中的更改同步到设备?
- 如何将自检数据上传到设备控制台?
认证
本部分介绍了与认证流程相关的常见问题。
准备工作
自测
- 合作伙伴是否需要在测试之前预先提交任何设备数据?
- 我可以在自行测试报告中使用所有相同的手机和 Android 版本吗?
- 如何手动测量配对时间?
- 如何管理仅颜色不同的设备的自检?
- 演讲者必须测试和实现哪些功能?
- 后续配对测试是否要求手机 A 忘记 DUT?
- How to test Retroactively Write Account Key on LE Audio enabled headset ?
设备认证
- 我可以使用哪种类型的设备(EVT、DVT、PVT、已发布)进行自测和认证?
- 合作伙伴如何为通过认证的同一设备指定不同的颜色版本?
- 如何查看 Google 颁发的认证票券?
- 完成自测后,我该如何处理 Google 颁发的认证票券?
- 是否必须使用与自测相同的软件和固件版本进行认证?
- 如何在设备控制台中管理一组类似产品?
- 应如何与第三方实验室分享任何自定义测试步骤?
- 为什么在玩游戏时,提供商的音频切换状态不显示 CONNECTED_A2DP_ONLY?
认证后
常规问题
对于给定的设备类型和快速配对版本,我需要实现哪些功能?
强制性功能页面定义了特定设备类型和快速配对修订版本所需的功能。合作伙伴可以申请豁免,我们会根据具体情况审核相关申请。
快速配对是否与特定功能(LE 音频等)集成?
Google 不断将新功能和新功能集成到快速配对中。如需详细了解具体请求,请与您的 SI 合作伙伴或 Google 联系人联系。
如何知道我的项目(而非模型 ID)是否处于有效状态?
项目状态通过设备控制台中项目页面上的图标指示。
未启用的项目会显示以下图标:
有效项目会显示以下图标:
如何知道设备的型号 ID 是否处于有效状态?
确保您的设备已在 Google Cloud 项目中注册,如型号 ID 页面中所述(如果您尚未注册)。
模型 ID 在认证后会完全激活,并在设备控制台中的设备页面上显示此按钮:
在设备控制台中,没有型号 ID 的设备的设备页面上会显示此按钮:
设备在通过“审批”按钮提交草稿后,系统会为其分配型号 ID。在 Google 将设备分配为“PENDING”状态后,此型号 ID 即可用于集成和测试,但必须通过认证流程完全激活,才能用于最终产品。
您可以在设备控制台中的设备页面上找到设备的型号 ID:
如何在设备上使用验证器应用?
合作伙伴必须先创建 Google 账号,并由设备控制台管理员将该账号添加到其设备控制台项目,然后才能将测试结果上传到设备控制台。
- 合作伙伴必须创建 Google 账号。
- Google 账号可以与非 Gmail 地址相关联。
- 创建账号后,让合作伙伴的设备控制台管理员将该账号电子邮件地址添加到正确的设备控制台项目。
- 在设备上登录此 Google 账号。
验证器应用用户手册介绍了具体的使用场景。
如何排查消息解密失败问题?
这些问题通常是由硬件加密块的问题引起的。尝试对设备进行插桩,以查看引擎输入、输出和 API 调用。现有的加密测试用例可能有助于问题排查。
尝试下载配套应用时,错误代码 DF-DFERH-01
表示什么?
这通常是由软件包名称前面的空格引起的。
验证设备控制台中的软件包名称是否没有前导空格。
如何在设备获得认证之前查看设备上的半页和通知?
仅当设备上启用了调试通知时,才会显示未认证设备的广告(和通知)。
如需启用调试通知,请执行以下操作:
- 设置 > 应用和通知 > Google Play 服务 > 通知
- 设置 > Google > 设备和分享(或设备连接)> 设备 > 三点状图标 > 包含调试结果
为什么后续配对通知未显示在第 2 部设备上?
此信息可能需要几个小时才能与设备同步。
如需强制进行手动同步,请执行以下操作:
- 依次前往设置 > Google > 设备和分享 > 设备。
- 选择“已保存的设备”下方的相应设备。
- 选择相应的 Google 账号。
配对的耳机现在应显示在列表中。
为什么我的设备不再显示半页通知?
在点击“关闭”按钮关闭半屏通知后,系统会在 5 分钟内禁止显示半屏通知。如需强制重新显示半页,请执行以下任一操作:
- 等待 5 分钟,让半张纸重新启用。
- 重启手机。
short time banned
是什么意思?
bug 报告日志中显示的 short time banned
状态是指通过点击“关闭”按钮关闭同一半屏通知时出现的状态。这会导致在接下来的 5 分钟内抑制该半页广告的后续展示。
如需强制重新显示半页,请执行以下任一操作:
- 等待 5 分钟,让半张纸重新启用。
- 重启手机。
在哪里可以找到模型 ID 防欺骗密钥?
密钥仅对在设备控制台中注册的项目可见。
在配对模式下,我能否使用设备的公共地址(而非 RPA)进行广告宣传?
一般情况下,不会。
Google 不会测试此使用情形,这可能会导致不良行为。
希望采用此方法的合作伙伴至少需要:
- 对所有功能执行完整的自检,以验证实现情况。
- 向 Google 申请豁免。
我们可能会根据具体情况批准豁免。
当配套应用已在前台打开时,为什么我的设备上不显示“快速配对”半页?
当快速配对半页检测到配套应用(通过其在 Nearby 控制台中的“配套应用软件包名称”标识)已在前台运行时,系统会抑制该半页。此措施可防止出现冗余通知。
例如,如果用户在移动设备上于前台启动耳机配套应用,系统将不会显示快速配对半页。
为什么我无法在设备控制台中创建项目?
您必须拥有 Google 账号才能创建项目。您可以将非 Google 电子邮件地址与 Google 账号相关联。
此问题还会显示“请求的身份验证范围不足”的错误消息。
我是否必须向 Bluetooth SIG 注册公司名称?
是的;在设备控制台中创建的每个新设备都必须在 Bluetooth SIG 中注册公司名称。
如何手动将数据上传到设备控制台?
合作伙伴必须先创建 Google 账号并将其添加到快速配对测试组,然后才能手动将测试结果上传到设备控制台。
使用验证工具应用的合作伙伴应按照验证工具应用设置部分中的说明操作。
- 合作伙伴必须创建 Google 账号。
- Google 账号可以与非 Gmail 地址相关联。
- 创建账号后,将其添加到快速配对测试组。
- 在设备上登录此 Google 账号。
- 在测试设备上启用“使用情况和诊断信息”:
- 依次选择“设置”>“Google”> 三点状图标 >“使用情况和诊断信息”> 开启“使用情况和诊断信息”
设备管理中心内的更改需要多长时间才能与指定设备同步?
25 小时。
如何强制将设备控制台更改同步到设备?
每台设备每天都会刷新一次本地缓存。如需强制刷新缓存,请执行以下任一操作:
- 更改系统语言:
- 依次前往设置 > 系统 > 语言和输入 > 语言。
- 较早的 Android 版本可能使用设置 > 系统 > 语言 > 系统语言。
- 将系统语言更改为任何其他语言。
- 依次前往设置 > 系统 > 语言和输入 > 语言。
- 将系统时钟提前 25 小时。
许多设备控制台设置(例如 TxPower)都存在于设备的缓存中。
如何将自检数据上传到设备控制台?
合作伙伴必须同时遵循验证器应用和手动测试路径,才能将自检数据上传到设备控制台。这些路径可能会在未来合并。
验证器应用涵盖提交校准和端到端 (E2E) 测试结果,而手动测试涵盖后续配对、距离测试和扩展功能。这两种途径都可以上传初始配对结果。
如需上传验证器应用数据,请执行以下操作:
- 确保您已按照验证器应用设置回答中列出的所有步骤操作。
- 在所有测试期间,请确保设备连接到互联网。
- 测试完成后,点击“提交”按钮。
如需上传手动测试数据,请执行以下操作:
- 填写 BT Classic 或 BT LE Audio 自检报告表单中列出的所有手动测试字段。
- 某些扩展程序(例如音频切换)具有额外的自检报告(BT Classic 或 BT LE Audio)。
- 将所有自检报告提交给您的 SI 合作伙伴或客户经理。
- 让设备保持联网状态的时间:
- 所有测试的时长。
- 测试完成后 25 小时。
- 确保手机已连接到电源,以免在上传过程中断电。
在送检样品以进行认证之前,我需要采取哪些行动?
如何在支持 LE 音频的耳机上测试追溯写入账号密钥?
鉴于蓝牙堆栈处理配置文件连接。测试应侧重于验证是否成功进行追溯配对,无论手机的 LE 音频切换开关设置如何。
如果配对后 LE 音频切换开关处于“关闭”状态,请在“关闭”列中记录结果,并将“开启”列标记为“不适用”;反之亦然。
必须发送多少个样品才能获得认证?
必须将三 (3) 个样品发送到第三方认证实验室。如需了解特定实验室的联系信息,请参阅将设备寄送至第三方实验室页面。
Google 可能会根据需要要求快速配对合作伙伴向 Google 发送样品。如需了解 Google 的配送信息,请参阅将设备寄送给 Google 页面。
如何管理样品设备的国际运输?
每家第三方实验室在管理国际运输、进口关税和流程方面都有独特的流程。您必须与实验室协调此流程。
如需了解特定实验室的联系信息,请参阅将设备运送至第三方实验室页面。这同样适用于寄送给 Google 的任何设备。
如何获得正式批准,以便在产品中宣传快速配对功能?
- 注册合作伙伴账号。
- 查看产品营销流程页面上的流程。
- 查看 Fast Pair 徽标指南页面。
- 制作包装和营销材料。
- 在“素材资源审批”标签页中提交您的设计,以供营销审核。
合作伙伴是否需要在测试之前预先提交任何设备数据?
否。
在向 Google 提交自检报告之前,应在其中输入所有必要的详细信息,例如型号 ID 和固件版本。
我可以在自测报告中使用所有相同的手机和 Android 版本吗?
否。
除了您自己的设备外,您还必须使用 3 部不同品牌且运行不同 Android 版本的手机。三部手机中必须有一部是 Pixel 手机。
您无需使用自检报告中列出的确切手机和 Android 版本号。
如何手动测量配对时间?
配对时间的衡量方式如下:
- 在界面上点按“配对”按钮的那一刻。
- 手机上显示“配对成功”界面时。
如何管理仅颜色不同的设备的自检?
- 对一个型号执行完整的自检。
- 在所有其他型号上运行验证器应用,并确认它们通过了验证。
音箱需要测试和实现哪些功能?
规范中介绍了功能要求。
后续配对测试是否要求手机 A 忘记 DUT?
否。
后续配对的自检不需要手机 A 忘记 DUT 并重新执行初始配对。例如,在运行 30 次后续配对自检测试时,只需要手机 B 忘记 DUT。
我可以使用哪类设备(EVT、DVT、PVT、已发布)进行自测和认证?
设备必须至少达到设计验证测试 (DVT) 级别。
一般来说,在自检或认证后对任何软件或固件进行更改都需要进行某种形式的重新测试。如需了解详情,请参阅认证阈值部分。
合作伙伴如何为正在接受认证的同一设备指定不同的颜色版本?
借助设备控制台的“系列”功能,合作伙伴可以针对此确切场景指定设备系列。
命名惯例由合作伙伴自行决定。一种常见的做法是在商品名称中添加表示颜色的后缀(例如“_green”)。
如何查看 Google 签发的认证票券?
您需要拥有 Google 合作伙伴网域账号 (PDA) 才能查看 Google 的项目跟踪组件。您的 SI 合作伙伴应具有用于查看这些勾号的 PDA,并且可以提供状态更新。
如果您没有 SI,请与您的 Google 合作伙伴联系,以获取有关如何制作 PDA 的帮助。
完成自测后,我该如何处理 Google 颁发的认证票券?
合作伙伴需要对此工单执行以下操作:
- 告知 Google 您计划使用哪个第三方实验室。
- 直接向第三方实验室提供服务申请单编号。
是否必须使用与自测相同的软件和固件版本进行认证?
是。
一般来说,在自检或认证后对任何软件或固件进行更改都需要进行某种形式的重新测试。如需了解详情,请参阅认证阈值部分。
如何在设备控制台中管理一组类似商品?
如果一组产品具有相同的产品图片、名称、软件和固件版本,则可以在设备控制台中将其添加为“系列”。
每台设备都必须有一个条目。
此组中只需认证一台设备,认证完成后,该系列中的所有其他设备都会获得批准。更新设备软件或固件时,只需向 Google 提交一份自检报告。
应如何与第三方实验室分享任何自定义测试步骤?
一般来说,合作伙伴无需为快速配对认证实现自定义测试步骤。依赖自定义步骤可能会违反快速配对标准并降低设备性能。
任何自定义步骤或特殊要求都应在项目提案阶段与 Google 讨论。
为什么在玩游戏时,提供方的音频切换状态不显示 CONNECTED_A2DP_ONLY?
这是一个已知问题,由 Seeker 引起,与不正确的游戏音频切换有关。在玩游戏时,三星手机会将连接状态设置为 CONNECTED_A2DP_WITH_AVRCP
而不是 CONNECTED_A2DP_ONLY
。
如需了解详情,请参阅音频切换认证已知问题部分。
何时需要重新认证设备或软件?
任何软件或固件更改都需要提交自检报告,即使不修改快速配对代码也是如此。
一般来说,在以下情况下,您需要进行完整重新认证:
- 发布具有新快速配对功能的二进制文件。
- 新功能必须通过第三方实验室认证,现有功能可以通过自检报告进行验证。
- 发布移除了快速配对功能的二进制文件。
- 更改已实现的快速配对版本(例如,从 3.0 更改为 3.1)。
- 某些版本更改可能需要额外认证。
- 例如,3.1 -> 3.2 需要音频切换认证。
- 某些版本更改可能需要额外认证。
- 在新硬件(尤其是配备新天线的硬件)上发布二进制文件。
您的 SI 或 Google 联系人可以针对具体情况提供最佳指导,包括豁免或弃权申请。
对于获得认证后的软件和固件更新,需要进行哪些测试?
认证后的软件和固件更新需要:
- 执行自检。
- 向 Google 提交自测结果。
- 通过验证器应用的端到端集成测试。
如认证阈值部分中所述,实现新的快速配对扩展服务或更改快速配对版本需要进行额外的认证。
我应将固件更新的自检报告发送到哪里?
如需详细了解 SI 合作伙伴的流程,请与他们联系。
如果您没有 SI 合作伙伴,请将自检报告发送给自检报告审核团队。
对于只有细微差别(例如颜色)的设备,是否必须创建不同的型号 ID?
可以。任何存在物理差异的设备都必须获得新的型号 ID。类似商品回答提供了一些命名惯例建议。
如何将我的设备添加到支持的芯片组页面?
芯片组通过认证后,系统会更新支持的芯片组页面。当出现以下任一情况时,系统会将新的芯片组添加到列表中:
- 开发板通过认证。
- 使用该芯片组的产品通过了认证。