--- title: "実装" url: https://docs.catalyst.zoho.com/ja/zia-services/help/barcode-scanner/implementation/ description: "Catalystを使用すると、ユニバーサルバーコードからエンコードされた情報を読み取り、抽出する構築済みバーコードスキャナーマイクロサービスをアプリに統合できます。" last_updated: 2026-08-17T12:16:04Z service: Zia Services type: general --- # 実装 このセクションでは、CatalystコンソールでのBarcode Scannerの操作のみを説明します。アプリケーションのコードにBarcode Scannerを実装する方法については、[SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/barcode-scanner/)および[API](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/barcode-scanner)ドキュメントのセクションを参照してください。 前述のとおり、コンソールからCatalystアプリケーションにBarcode Scannerを統合するためのコードテンプレートにアクセスでき、また、バーコードが含まれる画像をアップロードしてデコードされたコンテンツを取得することで機能をテストすることもできます。 ### Barcode Scannerへのアクセス CatalystコンソールでBarcode Scannerにアクセスするには： 1. Catalystコンソールの左ペインで**Zia Services**に移動し、**Barcode Scanner**をクリックします。 ![barcode-scanner](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/barcode-scanner-updated.webp) 2. Barcode Scanner機能ページで**Try a Demo**をクリックします。 ![catalyst_barcode_test_page](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_test_page.webp) ### CatalystコンソールでのBarcode Scannerのテスト Catalystのサンプル画像を選択するか、独自の画像をアップロードして、Barcode Scannerをテストできます。 サンプル画像のバーコードをスキャンしてコンテンツをデコードするには： 1. ボックス内の**Select a Sample Image**をクリックします。 ![catalyst_barcode_sample](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_sample.webp) 2. 提供されたサンプルから画像を選択します。 ![catalyst_barcode_select_sample](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_select_sample.webp) Barcode Scannerがバーコードをスキャンし、_Result_の下にコンテンツを表示します。 ![](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_sample_scanned.webp) **View Response**をクリックして、JSON形式でも確認できます。 ![catalyst_barcode_sample_json](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_sample_json.webp) 独自のバーコード画像をアップロードしてコンテンツをデコードするには： 1. _Result_セクションの下にある**Upload**をクリックします。 ![catalyst_barcode_upload](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_upload.webp) Barcode Scannerを閉じた後に再度開く場合は、このボックス内の**Browse Files**をクリックします。 ![catalyst_barcode_browse](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_browse.webp) 2. ローカルシステムからファイルをアップロードします。 > **注意:** * ファイルは._jpg_/._jpeg_または._png_形式である必要があります。ファイルサイズは10 MBを超えないようにしてください。画像の解像度は36000000ピクセルを超えないようにしてください。 * Catalystコンソールでテストする際は、バーコードタイプが自動的に検出されるため、入力としてバーコードタイプを指定することはできません。バーコードタイプを知っている場合は、CatalystアプリケーションからAPI送信するリクエストでタイプを指定できます。 コンソールがバーコードをスキャンし、コンテンツを表示します。 ![catalyst_barcode_qr_scanned](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_qr_scanned.webp) コピーアイコンを使用してコンテンツをコピーするか、**View Response**をクリックしてJSON responseを確認できます。 ![catalyst_barcode_qr_json](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_qr_json.webp) ### Barcode Scannerのコードテンプレートへのアクセス Catalystが[Java](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/barcode-scanner/)、[Node.js](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/barcode-scanner)、[Python](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/barcode-scanner)プラットフォーム用に提供するコードテンプレートを使用して、CatalystアプリケーションにBarcode Scannerを実装できます。 テストウィンドウの下のセクションからアクセスできます。**Java SDK**、**NodeJS SDK**、または**Python SDK**タブをクリックし、コピーアイコンを使用してコードをコピーします。このコードを、必要な箇所のWebまたはAndroidアプリケーションのコードに貼り付けることができます。 ![catalyst_barcode_java](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_java_updated.webp) Javaでは、入力ファイルを新しい`File`として処理し、`ZCBarcodeOptions`モジュールを使用してバーコードの形式を選択できます。Ziaにすべての形式で画像をスキャンさせる場合は、`ZCBarcodeFormat.ALL`を使用できます。形式を把握している場合は、たとえば`ZCBarcodeFormat.ean13`のように入力できます。サポートされるすべての形式のキーについては、[APIドキュメント](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/barcode-scanner/#BarcodeScanner)を参照してください。 ![catalyst_barcode_node](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_node_updated.webp) Node.jsのコードは、バーコード画像を`barcodePromise`オブジェクトとして処理します。同様の方法で、画像ファイル名と形式を指定できます。 ![catalyst_barcode_python](https://catalyst-docs-development.zohostratus.in/images/help/barcode-scanner/catalyst_barcode_python.webp) Pythonでは、.webp/.jpeg または .png 形式の入力ファイルを`open()`メソッドに提供すると、レスポンスとして画像ファイルオブジェクトが返されます。画像ファイルオブジェクトを`zia.scan_barcode()`メソッドの引数として渡す必要があります。`setFormat`を使用してバーコード形式を指定できます。形式を`ALL`と入力すると、Barcode Scannerが自動的に形式を検出します。デコードされた情報がレスポンスとして提供されます。