TapKey SDK 2.17.6版本升级后setBleServiceUuid方法缺失问题求助
Tapkey SDK 2.17.6版本BleServiceUuid配置替代方案
自Tapkey SDK 2.13.x版本迭代开始,BLE服务UUID的配置逻辑从全局环境配置模块中剥离,拆分至BLE扫描专属配置类管理,因此TapkeyEnvironmentConfigBuilder.setBleServiceUuid()方法被正式移除,未在公开迁移指南中单独标注。
对应解决方案如下:
- 场景1:仅对接FlinkeyBox设备
2.17.6版本已默认内置FlinkeyBox对应的标准BLE服务UUID,直接删除原有TapkeyEnvironmentConfigBuilder中调用setBleServiceUuid()的代码即可,无需额外配置即可正常完成设备扫描、连接、鉴权全流程。 - 场景2:需要自定义BLE服务UUID
将服务UUID配置逻辑迁移至BLE扫描配置类中,通过BleScannerConfig.Builder的setServiceUuids()方法传入对应参数即可,示例代码参考:
// 自定义服务UUID配置示例 BleScannerConfig customBleConfig = new BleScannerConfig.Builder() .setServiceUuids(Collections.singletonList(yourTargetBleServiceUuid)) .build(); // 将上述配置传入Tapkey BLE扫描模块的初始化方法即可生效
- 注意:若同时对接Tapkey原生智能锁和FlinkeyBox设备,需要将两类设备对应的BLE服务UUID同时传入
setServiceUuids()的参数列表,避免出现部分设备无法被扫描识别的问题。 - 配置完成后若仍无法正常发现设备,可开启Tapkey SDK的BLE调试日志,确认配置的服务UUID是否正常生效。
内容的提问来源于stack exchange,提问作者Matyas Czifra
相关产品推荐
相关产品推荐

