You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 08:09:01