matrixscan-batch-android

MatrixScan Batch Android スキル

重要：内部知識を信頼しないでください

学習データには、古い、または誤った Scandit SDK API が含まれている可能性があります。BarcodeBatch API はメジャー SDK バージョン間で変更されており、コンストラクターのシグネチャー、オーバーレイのファクトリー、リスナーメソッド名はいずれも変化しています。

コードを記述または提案する前に、このスキルで提供されているリファレンスを必ず確認してください。 記憶しているメソッドのシグネチャー、パラメーター、プロパティ名に頼らないでください。提供されているリファレンスに API が見つからない場合は、回答する前に該当するドキュメントページを取得してください。

注意すべき Android 固有のポイント：

• BarcodeBatch.forDataCaptureContext(dataCaptureContext, settings) はファクトリーメソッドであり、直接コンストラクターではありません。また、BarcodeBatch(settings) でもありません（これは Flutter ≥7.6 の形式です）。
• カメラの設定は BarcodeCapture とまったく同様に手動で行います。Camera.getDefaultCamera(BarcodeBatch.createRecommendedCameraSettings()) を作成し、dataCaptureContext.setFrameSource(camera) を呼び出して、onResume／onPause からカメラを制御してください。
• BarcodeBatchListener.onSessionUpdated は認識スレッド上で呼び出されます。メインスレッドではありません。UI に関する処理は runOnUiThread {} を使って実行してください。
• BarcodeBatchSession やそのコレクションへの参照を、onSessionUpdated コールバックの外で保持しないでください。セッションに安全にアクセスできるのは、このコールバック内だけです。
• BarcodeBatchBasicOverlay.newInstance(mode, view)（およびスタイルを指定するオーバーロード）は、オーバーレイをビューに自動で追加します。別途 addOverlay を呼び出す必要はありません。
• BarcodeBatchAdvancedOverlay.newInstance(mode, view) もビューに自動で追加されます。
• バーコードごとのブラシのカスタマイズ（brushForTrackedBarcode、setBrushForTrackedBarcode）には、MatrixScan AR アドオンライセンスが必要です。デフォルトのブラシを一律に適用する基本オーバーレイには必要ありません。
• BarcodeBatchAdvancedOverlay には、MatrixScan AR アドオンライセンスが必要です。
• Android のリスナーメソッド名は Flutter と異なります。didTapTrackedBarcode ではなく onTrackedBarcodeTapped、widgetForTrackedBarcode ではなく viewForTrackedBarcode、clearTrackedBarcodeWidgets ではなく clearTrackedBarcodeViews です。
• BarcodeBatchAdvancedOverlayListener が使用するのは Android の View オブジェクトであり、Flutter の Widget ではありません。
• Android のシンボロジー名ではアンダースコアを使用します。Symbology.EAN13_UPCA、Symbology.CODE128、Symbology.QR のように記述し、camelCase は使用しません。

インテントの振り分け

ユーザーのリクエストに基づいて、回答する前に適切なリファレンスファイルを読み込んでください。

• MatrixScan Batch を一から統合する、設定を行う、追跡中のバーコードを処理する、オーバーレイ（基本的な FRAME／DOT スタイル、タップコールバック、高度な AR ビュー、アンカー／オフセットによる位置指定）をカスタマイズする、削除されたバーコードに反応する、またはフィードバックを出力する場合 → references/integration.md を読み、そこに記載された指示に従ってください。
• 既存の MatrixScan Batch 統合を移行またはアップグレードする場合（例：「v6 から v7 へのアップグレード」「BarcodeTracking を BarcodeBatch に改名」「Scandit SDK を v8 に更新」「SDK バージョン間の変更点」）→ references/migration.md を読み、そこに記載された指示に従ってください。
• サードパーティ製のマルチバーコードスキャナーを MatrixScan Batch に置き換える場合（例：「ML Kit のバーコードスキャンから Scandit MatrixScan に移行」「ML Kit のマルチバーコードスキャナーを BarcodeBatch に置き換え」「[library] から MatrixScan Batch に切り替え」）→ references/third-party-migration.md を読み、そこに記載された指示に従ってください。

API 使用ポリシー

以下の Scandit リファレンスに明示的に記載されている API のみを使用してください。メソッドのシグネチャ、パラメーター、プロパティ名を創作したり、推測したりしないでください。API が存在するかどうか、または呼び出し方法が不明な場合、あるいはコンパイルエラーが発生した場合は、回答する前に該当するリファレンスページを取得してください。ユーザーに自分でドキュメントを確認するよう伝えてはいけません。回答後は、ユーザーが詳しく確認できるよう、必ず関連リンクを記載してください。

ドキュメント URL を決して組み立てたり、推測したりしないでください。 特定のクラスやプロパティの API ページが必要な場合：

1. まず、すでに取得したページに、そのページへの直接リンクがあるか確認してください。トピックページには、関連する API シンボルへの直接リンクがあります。
2. 直接リンクが見つからない場合は、API インデックスを取得し（下の表の完全な API リファレンスを参照）、実際のリンクを取り出して、そのページに移動してください。

ライセンスキー

スキャンには Scandit ライセンスキーが必要です。このスキルのライセンス製品は native、ライセンスプラットフォームは android です。

次の手順を順番に進めてください。MCP が利用できないことを理由に、ユーザーを待たせてはいけません。

1. Scandit MCP サーバーが接続されている場合 — 製品に native、プラットフォームに android、app_identifier にアプリのバンドル ID またはアプリケーション ID（Web の場合は本番環境のドメイン。localhost は不可）、env_var に SCANDIT_LICENSE_KEY を指定して、ensure_scanner_setup を呼び出してください。返されたコマンドは実行しないでください。その後、その結果または list_license_keys から取得したキー ID を使って get_license_key を呼び出してください。list_license_keys にそのキーがトライアルではないと表示されている場合は、取得する前にユーザーに確認してください。チャットにはマスクしたプレビューのみを表示し、キー全体を決して出力しないでください。

2. 接続されていない場合 — ユーザーに、MCP クライアントでリモート Scandit MCP サーバー https://ssl.scandit.com/mcp に接続できることを一度だけ伝えてから、手順 1 に進んでください。MCP クライアントの設定を自分で編集してはいけません。

   認証はブラウザーを使用するため、ヘッドレス環境や CI ではサポートされません。サーバーが発行するのはトライアルキーのみです。本番ライセンスの作成、失効、変更は行いません。

3. ユーザーが希望しない場合、または MCP クライアントを持っていない場合 — https://ssl.scandit.com でユーザー自身にキーを生成してもらい、貼り付けてもらってください（アカウントをまだ持っていない場合は、こちらを使用します：https://ssl.scandit.com/dashboard/sign-up?p=test）。

その後、キーをコードに設定してください：プレースホルダーの代わりに、ライセンスキーを指定する呼び出しにキーを記述します。キーは get_license_key が返したもの、またはユーザーが貼り付けるか提供したものを使用します。チャットでは、引き続きマスクしたプレビューのみを表示してください。プロジェクト、そのファイル、環境からキーを検索してはいけません。

リファレンス

トピック	リソース
はじめに	はじめに · サンプル
AR オーバーレイ（BasicOverlay ブラシ、AdvancedOverlay ビュー）	AR オーバーレイの追加
完全な API リファレンス	BarcodeBatch API