`beginCapture(options)` (従来)

新しいスキャンセッションを開始するには、この関数を使用します。

LWC のスキャンコードで最新の scan() API および dismiss() API を使用して、開発環境を簡素化することをお勧めします。従来の beginCapture() API、resumeCapture() API、endCapture() API は引き続き使用できますが、将来のリリースで廃止される予定です。

Note

構文

1import { getBarcodeScanner } from 'lightning/mobileCapabilities';
2beginCapture(options: BarcodeScannerOptions): Promise<Object>

パラメータ

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

戻り値

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

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

使用方法

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

1myScanner
2  .beginCapture(scanningOptions)
3  .then((result) => {
4    // Do something with the result of the scan
5    console.log(result);
6    this.scannedBarcode = result.value;
7  })
8  .catch((error) => {
9    // Handle cancellation and scanning errors here
10    console.error(error);
11  })
12  .finally(() => {
13    myScanner.endCapture();
14  });

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

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

関連トピック

The Japanese Summer '24 guide is now live

日本語の Summer '24 ガイドが公開されました! 「Component Reference (コンポーネントリファレンス)」は、以前と同様にコンポーネントライブラリにあります。

beginCapture(options) (従来)

構文

パラメータ

戻り値

使用方法

`beginCapture(options)` (従来)