mcpField
M
matrixscan-ar-android

matrixscan-ar-android

github.com/scandit開発2054 回インストール5 日前に更新
リポジトリ

matrixscan-ar-android について

Android アプリへの Scandit MatrixScan AR 組み込みを支援するコーディングエージェント向けスキルです。古い知識に頼らず、参照資料で API を確認するよう案内します。

主な機能

  1. 01Android BarcodeAr の組み込み案内
  2. 02参照資料に基づく API 確認
  3. 03ライフサイクルとカメラ設定の説明
  4. 04実行時カメラ権限の案内
  5. 05Scandit ライセンスキー設定の案内

活用シーン

  1. 01Android アプリへの MatrixScan AR 追加
  2. 02バーコードのハイライトや注釈の実装
  3. 03Android BarcodeAr API の使用方法確認

MCP 対応

ライセンス設定とキー取得のため、Scandit のリモート MCP サーバーへの接続方法を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/scandit/skills --skill matrixscan-ar-android

インストール後、Claude Code で/matrixscan-ar-androidを入力して読み込まれたか確認します。

同梱ファイルreferences/integration.md

詳細

MatrixScan AR Android スキル

重要：内部知識を鵜呑みにしないでください

トレーニングデータには、古い Scandit SDK API や誤った情報が含まれている可能性があります。BarcodeAr API はメジャー SDK バージョン間で変更されており、クラス名、コンストラクターのシグネチャー、プロバイダーインターフェース、セッションタイプはすべて進化しています。

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

注意すべき Android 固有の落とし穴：

  • BarcodeAr(dataCaptureContext, settings) は直接コンストラクターであり、（BarcodeCapture のパターンである）forDataCaptureContext() ファクトリーではありません。Android では BarcodeAr にコンテキストと設定の両方を直接渡します。
  • BarcodeArView は指定された ViewGroup の親に自動的に追加されるため、手動で addView を呼び出す必要はありません。スキャンを開始するには、プロバイダーを設定した後に barcodeArView.start() を呼び出してください。
  • BarcodeArView はカメラを内部で管理するため、別途 Camera を設定したり、setFrameSource を呼び出したりする必要はありません。カメラの位置は BarcodeArViewSettings.defaultCameraPosition で設定します。
  • ライフサイクルは Camera オブジェクトではなく BarcodeArView によって管理されます。対応する Activity／Fragment のコールバックから barcodeArView.onResume()、barcodeArView.onPause()、barcodeArView.onDestroy() を呼び出してください。
  • BarcodeArListener.onSessionUpdated(barcodeAr, session, frameData) は認識スレッドから呼び出され、メインスレッドからではありません。FrameData パラメーター名は frameData です（data という名前の BarcodeCapture とは異なります）。UI に関する処理は runOnUiThread {} を使ってディスパッチする必要があります。
  • BarcodeArHighlightProvider.highlightForBarcode と BarcodeArAnnotationProvider.annotationForBarcode はメインスレッドで呼び出されます。結果はコールバックを通じて渡されるため、callback.onData(highlight) または callback.onData(annotation) を呼び出してください（要素を非表示にする場合は null を渡します）。ハイライトとアノテーションのコンストラクターは、どちらも最初の引数に Context を取ります（例：BarcodeArRectangleHighlight(context, barcode)）。
  • Android のシンボロジー名ではアンダースコアを使います：Symbology.EAN13_UPCA、Symbology.CODE39。キャメルケースではありません。
  • BarcodeArSettings では、すべてのシンボロジーがデフォルトで無効になっています。アプリで必要なものだけを有効にすると、トラッキング性能が向上します。
  • スキャンを開始する前に、実行時に CAMERA 権限をリクエストしてください。マニフェストで宣言するだけでは不十分です。
  • BarcodeArFeedback は com.scandit.datacapture.barcode.ar.feedback にあります。ar.capture ではありません。インポート：import com.scandit.datacapture.barcode.ar.feedback.BarcodeArFeedback
  • BarcodeArInfoAnnotationBodyComponent は com.scandit.datacapture.barcode.ar.ui.annotations.info にあります。ar.ui.annotations ではありません。インポート：import com.scandit.datacapture.barcode.ar.ui.annotations.info.BarcodeArInfoAnnotationBodyComponent。同じ info サブパッケージには、BarcodeArInfoAnnotationHeader、BarcodeArInfoAnnotationFooter、BarcodeArInfoAnnotationWidthPreset、BarcodeArInfoAnnotationAnchor も含まれています。

インテントの振り分け

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

  • BarcodeAr を一から統合する（例：「アプリに MatrixScan AR を追加する」「バーコード AR スキャンを設定する」「Android で BarcodeAr を使う方法」「トラッキング中のバーコードにハイライトを表示する方法」「情報アノテーションを表示する方法」）→ references/integration.md を読み、記載されている手順に従ってください。

API の使用ポリシー

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

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

  1. まず、すでに取得したページにそのページへの直接リンクがあるか確認してください。トピックページには関連する API シンボルへの直接リンクがあります。取得を依頼する際は、必ずコンテンツとあわせてリンクも要求してください。
  2. 直接リンクが見つからない場合は、API インデックス（以下の表の Full API reference を参照）を取得し、そこから実際のリンクを抽出して、そのリンクをたどってください。

URL の構造は異なる場合があります（例：api/ui/ サブディレクトリ）。推測すると 404 エラーになります。

ライセンスキー

スキャンには 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 が返したキー、またはユーザーが貼り付けるか提供したキーです。チャットには引き続きマスクしたプレビューのみを表示してください。プロジェクト、そのファイル、または環境内からキーを探してはいけません。

リファレンス

ユーザーの質問に応じて、適切なリソースを案内してください。

トピックリソース
はじめにはじめに · サンプル
高度なトピック（カスタムハイライト、注釈、タップ操作、通知、フィルター）高度な設定
API リファレンス全体BarcodeAr API

コメント

Markdown 対応