Auf dieser Seite

Transport auswählen

Hardware SDK 1.2.x verwendet eine JavaScript-API. init({ env }) wählt den Transport, nicht Protocol V1 oder V2.

Plattform	Transport	Paket	`env`	Anleitung
Browser / Desktop-WebUSB	WebUSB	`@onekeyfe/hd-common-connect-sdk`	`webusb`	WebUSB
React Native	BLE	`@onekeyfe/hd-ble-sdk`	(Standard des BLE-SDKs)	React Native BLE
Nativer Android-Host	BLE über Low-Level-Plugin	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Android
Nativer iOS-Host	BLE über Low-Level-Plugin	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	iOS
Flutter-Host	BLE über Low-Level-Plugin	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Flutter
Übersicht zu nativem BLE	BLE	`@onekeyfe/hd-common-connect-sdk`	`lowlevel`	Natives BLE

USB erfordert eine kompatible Geräteschnittstelle und Firmware; prüfen Sie Verbindung und Signieren auf Ihrer Zielplattform. BLE wird von Pro, Pro 2, Neo, Touch und Classic 1s / Pure unterstützt — nicht von Mini. Air-Gap per QR ist ein separater Produktweg: Air-Gap.

Transport ist nicht das Protokoll

Ebene	Was es ist	Wie Sie auswählen
Transport	Wie Bytes übertragen werden: USB, BLE oder ein natives BLE-Plugin	`init({ env })` — `webusb` / BLE SDK / `lowlevel`
Protokoll	V1 oder V2 als Übertragungsprotokoll nach dem Verbindungsaufbau	SDK-Abfrage. Lesen Sie `connectProtocol`. Leiten Sie das Protokoll nicht aus USB-PID oder BLE-Namen ab

Ein Pro 2 über USB und ein Pro 2 über BLE verwenden beide Protocol V2. Ein Classic über USB verwendet Protocol V1. Siehe Protocol V1 und V2 und Geräte.

Verwenden Sie OneKey Bridge (env: 'web' + checkBridgeStatus) nicht für neue WebUSB-Apps. Migration: Bridge → WebUSB.

Nach dem Verbinden

Erste Adresse: Erste Schritte
PIN / Ereignisse: Core-API-Anleitung
Abbrüche und dispose(): Verbindungsabbrüche und Wiederverbindung
Firmware: Firmware-Update
Eigene BLE-Bridge: Transport auf niedriger Ebene