scan(options)

バーコードのスキャンを開始するには、この関数を使用します。

  • options — (必須) のスキャンセッションを設定するための BarcodeScannerOptions オブジェクト。

スキャンされたバーコードの詳細を使用して Barcode オブジェクトの配列として解決される Promise オブジェクト。

却下された Promise では、BarcodeScannerFailure が返されます。

この関数は、スキャナリソースを割り当てます。スキャンの完了時にリソースをリリースするには、dismiss() とペアにします。

この関数がコールされると、モバイル OS スキャンユーザインターフェースがモバイルデバイスに表示されます。ユーザは、カメラをバーコードに向けて、バーコードが認識されるまで待ちます。

  • バーコードが正常にスキャンされると、達成された Promise を介して結果が返されます。then 句で正常な結果を処理します。
  • バーコードのスキャンに失敗すると、却下された Promise を介してエラーが返されます。catch 句でエラーを処理します。
  • ユーザがスキャン中に [キャンセル] ボタンをクリックすると、Promise は userDismissedScannerBarcodeScannerFailure.code 値で却下されます。
  • スキャンが成功してもエラーでも、モバイル OS スキャナインターフェースは表示されたままになります。スキャナインターフェースを閉じるには、コンポーネントのインターフェースに戻り、dismiss() をコールします。
  • finally 句で、最終的なクリーンアップの処理 (dismiss() のコールなど) を行います。

関連トピック