Sur cette page
Choisir un transport
Hardware SDK 1.2.x utilise une seule API JavaScript. init({ env }) sélectionne le transport, pas Protocol V1 ou V2.
| Plateforme | Transport | Paquet | env | Guide |
|---|---|---|---|---|
| WebUSB navigateur / ordinateur | WebUSB | @onekeyfe/hd-common-connect-sdk | webusb | WebUSB |
| React Native | BLE | @onekeyfe/hd-ble-sdk | (valeur par défaut du SDK BLE) | BLE React Native |
| Hôte Android natif | BLE via un plugin de bas niveau | @onekeyfe/hd-common-connect-sdk | lowlevel | Android |
| Hôte iOS natif | BLE via un plugin de bas niveau | @onekeyfe/hd-common-connect-sdk | lowlevel | iOS |
| Hôte Flutter | BLE via un plugin de bas niveau | @onekeyfe/hd-common-connect-sdk | lowlevel | Flutter |
| Vue d’ensemble du BLE natif | BLE | @onekeyfe/hd-common-connect-sdk | lowlevel | BLE natif |
USB nécessite une interface d’appareil et un micrologiciel compatibles ; validez la connexion et la signature sur votre plateforme cible. BLE concerne Pro, Pro 2, Neo, Touch, Classic 1s / Pure — pas Mini. QR Air-Gap constitue un parcours produit distinct : Air-Gap.
Le transport n’est pas le protocole
| Couche | Définition | Mode de sélection |
|---|---|---|
| Transport | Déplacement des octets : USB, BLE ou plugin BLE natif | init({ env }) — webusb / BLE SDK / lowlevel |
| Protocole | V1 ou V2 sur la liaison une fois celle-ci établie | Interrogation du SDK. Lisez connectProtocol. Ne le déduisez pas du PID USB ou du nom BLE |
Un Pro 2 en USB et un Pro 2 en BLE utilisent tous deux Protocol V2. Un Classic en USB utilise Protocol V1. Consultez Protocol V1 et V2 et Appareils.
N’utilisez pas OneKey Bridge (env: 'web' + checkBridgeStatus) pour les nouvelles applications WebUSB. Migration : Bridge → WebUSB.
Après la connexion
- Première adresse : Premiers pas
- PIN / événements : Guide de l’API Core
- Interruptions et
dispose(): Déconnexions et reconnexion - Micrologiciel : Mise à jour du micrologiciel
- Pont BLE personnalisé : Transport de bas niveau
Dernière mise à jour le