Skip to Content
ハードウェアトランスポート切断と再接続
このページの内容

切断と再接続

USB の取り外し、BLE 信号の喪失、Bluetooth のリセット、ファームウェアの再起動によって接続が切れることがあります。以下の手順で中断された操作を終了し、デバイスを再接続して、選択済みのウォレットを安全に再利用します。

SDK がすでに行うこと

  • 通常の切断 / 再接続でも、確認済みの connectProtocol は保持されます。切断後に V1 と V2 を選び直す必要はありません。
  • 実行中の呼び出しは失敗します。SDK は署名、消去、ファームウェア更新を再実行しません。
  • Protocol V2 はデバイスごとに呼び出し順序を保ちます。最初の呼び出しの復旧中に、2 つ目の業務呼び出しを重ねないでください。

統合側で行うこと

  1. アプリ起動時に DEVICE.CONNECT / DEVICE.DISCONNECT を一度だけ購読します。
  2. DISCONNECT が発生したら、該当する connectId の接続をビジー/無効としてマークし、現在の UI フローを失敗させます。同じ副作用のあるメソッドを再試行しないでください。
  3. 再検索します (searchDevices)。ユーザーの準備ができたら実行します。USB の再接続や BLE の再ペアリングで、次が新たに生成される場合があります: 新しい connectId。USB と BLE の ID は別々にキャッシュしてください。参照: 識別子.
  4. 新しい接続後は、getDeviceState でデバイス状態を更新します。永続化した deviceId + passphraseState を再利用します。ファームウェアの session_id は永続化しないでください。
  5. 次のアドレス取得 / 署名では、永続化した passphraseState または useEmptyPassphrase: true を渡します。Core はそのメソッド内でファームウェアセッションを再開します。再接続だけのためにウォレットセッションを開き直さないでください。
import { DEVICE } from '@onekeyfe/hd-core';
 
HardwareSDK.on(DEVICE.DISCONNECT, (payload) => {
  markDisconnected(payload);
  // Fail the open UI flow; do not replay signing or firmware updates.
});
HardwareSDK.on(DEVICE.CONNECT, () => {
  refreshDeviceList();
});

BLE 固有の事項

  • 権限 (BLUETOOTH_SCAN / CONNECT, iOS の Bluetooth 用途文字列、Android では多くの場合位置情報) は、プロセス終了後も許可されている必要があります。参照: React Native BLE.
  • retryCount / timeout はデバイス呼び出し前の接続設定を制御します。署名の再試行やアプリレベルの復旧の代わりにはなりません。
  • OS のボンドが古くなった場合、接続の繰り返しを停止します。システムの Bluetooth 設定からデバイスを削除し、再ペアリングするよう案内してください。
  • Mini には BLE がありません。Neo には BLE がありますが、カメラはありません。参照: デバイス.

USB 固有の事項

  • WebUSB で選択画面を再表示するにはユーザー操作が必要です。ただし、まだ許可済みのデバイスに対して skipWebDevicePrompt を渡す場合を除きます。共通パラメーターを参照してください。
  • 別のタブや Bridge がデバイスを保持していると、取得/オープンのエラーになります。他の接続元を閉じてください。最初の対応として dispose() を実行しないでください。

dispose()

await HardwareSDK.dispose();

dispose() は、SDK の終了時や env / トランスポート構成の切り替え時 (WebUSB → 低レベルなど) にのみ呼び出します。すべての接続と Protocol V2 のトランスポートカーソルが破棄されます。

通常の BLE 切断や USB 取り外しで dispose() を呼び出さないでください。同じ HardwareSDK インスタンスで検索して再接続します。

dispose() の後は、必ず init() を再実行してから searchDevices を呼び出します。

ファームウェアの再起動

firmwareUpdateV2 / V3 / V4 は意図的に切断する場合があります。待機して再接続し、バージョンを読み取ってください。切断を更新失敗とみなして再実行しないでください。参照: ファームウェア更新.

次へ

最終更新日
Flutter (ネイティブ)概要