scan(options)
バーコードのスキャンを開始するには、この関数を使用します。
options
— (必須) のスキャンセッションを設定するためのBarcodeScannerOptions
オブジェクト。
スキャンされたバーコードの詳細を使用して Barcode
オブジェクトの配列として解決される Promise オブジェクト。
却下された Promise では、BarcodeScannerFailure
が返されます。
この関数は、スキャナリソースを割り当てます。スキャンの完了時にリソースをリリースするには、dismiss()
とペアにします。
この関数がコールされると、モバイル OS スキャンユーザインターフェースがモバイルデバイスに表示されます。ユーザは、カメラをバーコードに向けて、バーコードが認識されるまで待ちます。
- バーコードが正常にスキャンされると、達成された Promise を介して結果が返されます。
then
句で正常な結果を処理します。 - バーコードのスキャンに失敗すると、却下された Promise を介してエラーが返されます。
catch
句でエラーを処理します。 - ユーザがスキャン中に [キャンセル] ボタンをクリックすると、Promise は
userDismissedScanner
のBarcodeScannerFailure.code
値で却下されます。 - スキャンが成功してもエラーでも、モバイル OS スキャナインターフェースは表示されたままになります。スキャナインターフェースを閉じるには、コンポーネントのインターフェースに戻り、
dismiss()
をコールします。 finally
句で、最終的なクリーンアップの処理 (dismiss()
のコールなど) を行います。
関連トピック