matrixscan-ar-annotation-ios について
iOS アプリの MatrixScan AR アノテーション向けコーディングスキルです。統合、カスタマイズ、操作に関する質問を資料に振り分け、記憶に頼らず文書化された API を確認します。
主な機能
- 01アノテーションの統合とカスタマイズ
- 02操作に関する質問を資料へ振り分け
- 03文書に基づく API の検証
- 04UIKit、SwiftUI、API リファレンスの提示
活用シーン
- 01スキャンしたバーコードへの注釈追加
- 02注釈の外観や動作のカスタマイズ
- 03注釈やポップオーバーボタンのタップ処理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/matrixscan-ar-annotation-iosを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/customization.mdintegration.mduser-interaction.md詳細
MatrixScan AR アノテーション iOS スキル
重要：内部知識を信頼しないでください
トレーニングデータには、古くなっていたり、誤っていたりする Scandit SDK API が含まれている可能性があります。MatrixScan AR API は SDK のバージョン間で大幅に変更されます。プロパティの名前が変更されたり、削除されたり、再構成されたりするほか、新しいアノテーション型（例：BarcodeArResponsiveAnnotation）が v8 の途中で追加されています。
コードを記述または提案する前に、必ずこのスキルで提供されているリファレンスで API を確認してください。 記憶しているメソッドシグネチャ、パラメーター、ビュー修飾子に頼らないでください。提供されているリファレンスに API が見つからない場合は、回答する前に該当するドキュメントページを取得してください。
このスキルの対象はアノテーションのみです。ハイライト、MatrixScan AR の新規セットアップ、カメラ／トーチ／シンボロジーの設定、セッションレベルのスキャンリスナーは対象外であり、兄弟スキルで扱います。
インテントの振り分け
ユーザーのリクエストに応じて、回答する前に適切なリファレンスファイルを読み込んでください。1つの質問が複数のインテントにまたがる場合（例：「カスタムヘッダー付きのタップ可能な情報アノテーションを追加する」）は、該当するリファレンスをすべて読み込んでください。
- MatrixScan AR アノテーションの統合（例：「アプリにアノテーションを追加する」「各バーコードにステータスアイコンを付ける」「BarcodeArInfoAnnotation／BarcodeArPopoverAnnotation／BarcodeArResponsiveAnnotation を使う」「利用可能なアノテーション型は？」）→ references/integration.md を読み、記載の指示に従ってください。統合コードを書く前に、プロジェクトが UIKit と SwiftUI のどちらを使用しているかを特定し（
import SwiftUI、@mainのApp構造体、SceneDelegate／AppDelegate、.storyboard／.xibファイルなどを確認）、以下の「References」表から該当する Get Started ページを読み込んでください。 - アノテーションのカスタマイズ（例：「アノテーションのアンカーを変更する」「情報アノテーションのヘッダーテキストを設定する」「タップしたときだけアノテーションを表示する」「ポップオーバーのボタンをカスタマイズする」「小さい幅のプリセットを使う」「アノテーションの背景を透明にする」「近距離表示と遠距離表示を切り替える」）→ references/customization.md を読み、記載の指示に従ってください。
- MatrixScan AR アノテーションとのユーザー操作への対応（例：「ユーザーがアノテーションをタップしたときに処理する」「ポップオーバーのボタンタップに反応する」「情報アノテーションのヘッダー／フッターのタップを検出する」）→ references/user-interaction.md を読み、記載の指示に従ってください。
アノテーションとのインタラクションには BarcodeArViewUIDelegate を使用しません（このデリゲートはハイライトのタップ用です）。タップ可能な各アノテーション型には、それぞれ独自のデリゲートがあります。user-interaction.md を参照してください。
API の使用ポリシー
以下の Scandit リファレンスで明示的に文書化されている API だけを使用してください。メソッドシグネチャ、パラメーター、ビュー修飾子を作り出したり、推測したりしないでください。API が存在するか、どのように呼び出すか確信が持てない場合、またはコンパイルエラーが発生した場合は、回答する前に該当するリファレンスページを取得してください。ユーザー自身でドキュメントを確認するよう案内してはいけません。回答の後には、ユーザーが詳細を確認できるよう、必ず関連リンクを含めてください。
ドキュメントの URL を組み立てたり、推測したりしてはいけません。 特定のクラスまたはプロパティの API ページが必要な場合：
- まず、すでに取得したページ（例：アノテーションクラスのページ）に、そのページへの直接リンクが含まれているか確認してください。トピックページには関連する API シンボルへの直接リンクがあります。取得時には必ず、コンテンツとともにリンクも要求してください。
- 直接リンクが見つからない場合は、API インデックス（以下の表のFull API referenceを参照）を取得し、そこから実際のリンクを抽出して、そのリンクをたどってください。
URL の構造はさまざまです（例：api/ui/ サブディレクトリ）。推測すると 404 エラーになります。
参考資料
質問に応じて適切なページを選ぶ際にこの表を使用し、ユーザーがさらに詳しく確認できるよう、回答にリンクを含めてください。ユーザーに自分でドキュメントを読むよう案内しないでください。
| トピック | リソース |
|---|---|
| UIKit との統合 | 始める（UIKit） · サンプル |
| SwiftUI との統合 | 始める（SwiftUI） |
| API リファレンス（全編） | MatrixScan AR API |