本页目录

选择传输

Hardware SDK 1.2.x 是同一套 JavaScript API。init({ env }) 选的是传输，不是 Protocol V1 / V2。

平台	传输	包	`env`	指南
浏览器 / 桌面 WebUSB	WebUSB	`@onekeyfe/hd-common-connect-sdk`	`webusb`	WebUSB
React Native	BLE	`@onekeyfe/hd-ble-sdk`	（BLE SDK 默认）	React Native BLE
Android 原生宿主	底层插件 BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Android
iOS 原生宿主	底层插件 BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	iOS
Flutter 宿主	底层插件 BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Flutter
原生 BLE 总览	BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	原生 BLE

USB 接入需要兼容的设备接口与固件；在目标平台验证连接及签名流程。BLE 是 Pro、Pro 2、Neo、Touch、Classic 1s / Pure —— Mini 没有。二维码 Air-Gap 是另一条产品路径：Air-Gap。

传输不是协议

层	是什么	怎么选
传输	字节怎么走：USB、BLE，或原生 BLE 插件	`init({ env })` — `webusb` / BLE SDK / `lowlevel`
协议	链路起来之后线上的 V1 / V2	SDK 探测。读 `connectProtocol`。不要用 USB PID 或蓝牙名判断

Pro 2 插 USB 和走 BLE 都是 Protocol V2。Classic 插 USB 是 Protocol V1。见 Protocol V1 与 V2 和设备。

新的 WebUSB 应用不要再用 OneKey Bridge（env: 'web' + checkBridgeStatus）。迁移：Bridge → WebUSB。