matrixscan-ar-ios

MatrixScan AR iOS スキル

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

学習データには、古い Scandit SDK API や誤った API が含まれている可能性があります。MatrixScan AR API は SDK のバージョン間で変更され、クラス名の変更、再構成、置き換えが行われることがあります（例：BarcodeTracking → BarcodeBatch → BarcodeAr）。

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

対象範囲

このスキルの対象は、MatrixScan AR のスキャンパイプラインです：DataCaptureContext、BarcodeAr モード、BarcodeArSettings、BarcodeArView、BarcodeArViewSettings、BarcodeArListener、BarcodeArFeedback、カメラ、コントロールの表示設定。

対象外：

• ハイライト（検出されたバーコード上に描画される図形のカスタマイズ — BarcodeArHighlightProvider、BarcodeArRectangleHighlight、BarcodeArCircleHighlight など）— matrixscan-ar-highlight-ios スキルが担当します。
• アノテーション（情報カード、ステータスアイコン、ポップオーバー、レスポンシブアノテーション — BarcodeArAnnotationProvider、BarcodeArInfoAnnotation、BarcodeArPopoverAnnotation など）— matrixscan-ar-annotation-ios スキルが担当します。

ユーザーの質問がインテグレーションとハイライト／アノテーションのカスタマイズの両方にまたがる場合は、ここではインテグレーションの部分を扱い、残りを担当する兄弟スキルをユーザーに伝えてください。

インテントの振り分け

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

• MatrixScan AR のスキャンパイプラインのセットアップまたは調整（例：「アプリに MatrixScan AR を追加する」、「AR スキャナーをセットアップする」、「これらのシンボロジーを有効にする」、「フィードバック／トーチ／カメラ／コントロールを設定する」、「カメラ設定を変更する」、「ズームコントロールを表示する」）→ references/integration.md を読み、記載された手順に従ってください。プロジェクトですでに MatrixScan AR が組み込まれている場合は、コンテキスト、モード、ビュー、ライフサイクルを作り直さず、既存のものを探して（BarcodeArView、次に BarcodeAr を grep してください）、ユーザーが求めた内容だけを変更してください。コードを書く前に、プロジェクトが UIKit と SwiftUI のどちらを使用しているかを確認し（import SwiftUI、@main の App 構造体、SceneDelegate／AppDelegate、.storyboard／.xib ファイルなどを確認）、以下のリファレンステーブルから対応する Get Started ページを使用してください。
• MatrixScan Batch から MatrixScan AR への移行（例：「BarcodeBatch／BarcodeTracking から MatrixScan AR に移行する」、「MatrixScan Batch を MatrixScan AR に置き換える」、「オーバーレイベースのスキャンから AR に切り替える」）→ references/migration.md を読み、記載された手順に従ってください。

API の使用方針

以下の Scandit リファレンスに明示的に記載されている API のみを使用してください。メソッドシグネチャ、パラメーター、ビュー修飾子を作り出したり、推測したりしないでください。API が存在するか、どのように呼び出すか確信が持てない場合、またはコンパイルエラーが発生した場合は、回答する前に該当するリファレンスページを取得してください。ユーザー自身にドキュメントを確認するよう指示しないでください。回答後は、ユーザーがさらに確認できるよう、必ず該当するリンクを含めてください。

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

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

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

ライセンスキー

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

次の手順を順番に進めてください。MCP が原因でユーザーを待たせてはいけません。

1. Scandit MCP サーバーが接続されている場合 — 製品に native、プラットフォームに ios、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 が返したもの、またはユーザーが貼り付けたもの、もしくは提供したものです。チャットには引き続きマスクされたプレビューのみを表示してください。キーを探すために、プロジェクト、そのファイル、環境を検索してはいけません。

参考資料

質問に応じて取得するページをこの表から選び、ユーザーがさらに詳しく確認できるよう、回答にリンクを含めてください。

トピック	リソース
UIKit の統合	はじめに（UIKit） · サンプル
SwiftUI の統合	はじめに（SwiftUI）
API リファレンス全般	MatrixScan AR API