En esta página

Elegir transporte

Hardware SDK 1.2.x usa una única API JavaScript. init({ env }) selecciona el transporte, no Protocol V1 o V2.

Plataforma	Transporte	Paquete	`env`	Guía
WebUSB en navegador / escritorio	WebUSB	`@onekeyfe/hd-common-connect-sdk`	`webusb`	WebUSB
React Native	BLE	`@onekeyfe/hd-ble-sdk`	(valor predeterminado del SDK BLE)	React Native BLE
Host nativo Android	BLE mediante plugin de bajo nivel	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Android
Host nativo iOS	BLE mediante plugin de bajo nivel	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	iOS
Host Flutter	BLE mediante plugin de bajo nivel	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Flutter
Resumen de BLE nativo	BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	BLE nativo

USB requiere una interfaz y firmware compatibles; valida conexión y firma en tu plataforma. BLE es compatible con Pro, Pro 2, Neo, Touch y Classic 1s / Pure — no con Mini. Air-Gap QR es un flujo de producto independiente: Air-Gap.

El transporte no es el protocolo

Capa	Qué es	Cómo elegirla
Transporte	Cómo se mueven los bytes: USB, BLE o un plugin BLE nativo	`init({ env })` — `webusb` / BLE SDK / `lowlevel`
Protocolo	V1 o V2 en la comunicación una vez establecida la conexión	Consulta del SDK. Lee `connectProtocol`. No lo deduzcas del PID USB o nombre BLE

Un Pro 2 conectado por USB y un Pro 2 conectado por BLE usan Protocol V2. Un Classic por USB usa Protocol V1. Consulta Protocol V1 y V2 y Dispositivos.

No uses OneKey Bridge (env: 'web' + checkBridgeStatus) para nuevas aplicaciones WebUSB. Migración: Bridge → WebUSB.

Después de conectar

Primera dirección: Primeros pasos
PIN / eventos: Guía de la API Core
Interrupciones y dispose(): Desconexiones y reconexión
Firmware: Actualización del firmware
Conexión BLE personalizada: Transporte de bajo nivel