互換性と要件

BarcodeScanner は、API を Lightning Web コンポーネントに提供して、モバイルハードウェアおよびプラットフォーム (オペレーティングシステム) 機能を JavaScript で使用できるようにする JavaScript モジュールです。デバイスハードウェアとデバイスプラットフォーム API へのアクセス権が必要になります。このアクセスは、BarcodeScanner が互換性のある Salesforce モバイルアプリケーション内で実行されている場合にのみ可能です。Web ブラウザで実行する場合は、デスクトップとモバイルのいずれの環境でもアクセスできません。

BarcodeScanner は、以下を使用して配布された Lightning アプリケーションで利用できます。

  • Salesforce モバイルアプリケーション
  • Salesforce アプリケーション用 Mobile Publisher
  • Experience Cloud 用 Mobile Publisher

BarcodeScanner は、Lightning アプリケーションまたは Lightning サイトで使用したときに完全に機能します。ただし、その Lightning アプリケーションは、互換性のある iOS または Android モバイルデバイス上でこれらの Salesforce アプリケーションのいずれかから実行されている必要があります。特定のデバイスおよびオペレーティングシステム要件については、「Salesforce モバイルアプリケーションの要件」、または対象となるモバイルアプリケーションの要件のページを参照してください。

BarcodeScanner は、デスクトップなどの他のデバイスで実行されているときは完全に機能しません。また、モバイルデバイスの場合でも、Web ブラウザで実行されているときは完全に機能しません。上記のモバイルアプリケーションのいずれかが必要です。BarcodeScanner API は、すべてのデバイスの Lightning Experience でアクセスできます。したがって、関数が足りないためにコードが失敗することはありません。ただし、デスクトップの場合でもモバイルの場合でも、アプリケーションをブラウザで実行するときは、BarcodeScanner 定数およびユーティリティ関数しか使用できません。スキャン操作を試みても失敗します。

BarcodeScanner は、次の標準バーコードシンボルを認識できます。(このリファレンスは Salesforce に属するものではありません)。

バーコードシンボル標準BarcodeScanner 種別 (barcodeTypes)
コード 128CODE_128
コード 39CODE_39
コード 93CODE_93
Data MatrixDATA_MATRIX
EAN-13 / GTIN-13EAN_13
EAN-8 / GTIN-8EAN_8
Interleaved 2 of 5ITF
PDF417PDF_417
QR コードQR
UPC-A / GTIN-12UPC_A
UPC-E / GTIN-12UPC_E

コードでバーコード種別にアクセスしたり、バーコード種別を比較したりするには、barcodeTypes 手数を使用します。

BarcodeScanner は、バーコードで検出された値を解釈しようとしません。バーコードのコンテンツは、文字列値に復号化されます。結果をさらに解析および解釈し、それを使用して何を実行するのかを判断するのは制御コンポーネントやアプリケーションです。バーコード標準およびシンボルについての詳細は、「Barcoding for Beginners (初心者のためのバーコーディング)」 (Salesforce に属するものではありません) を参照してください。