mcpField
B
barcode-capture-ios

barcode-capture-ios

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

barcode-capture-ios について

barcode-capture-iosは、iOSアプリにScandit BarcodeCaptureを統合するコーディングエージェント向けの参照スキルです。統合、移行、他社製スキャナーからの置き換えに対応する資料へ案内し、APIの確認を促します。

主な機能

  1. 01API確認の指針
  2. 02UIKit・SwiftUI統合資料
  3. 03メジャーバージョン移行の案内
  4. 04他社製スキャナー移行ガイド

活用シーン

  1. 01iOSアプリへのBarcodeCaptureの追加
  2. 02SDKバージョン間でのBarcodeCapture更新
  3. 03他社製バーコードスキャナーの置き換え

インストール

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

$npx skills add https://github.com/scandit/skills --skill barcode-capture-ios

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
integration.md
migration.md
third-party-migration.md

詳細

BarcodeCapture iOS スキル

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

トレーニングデータには、古い、または誤った Scandit SDK API が含まれている可能性があります。BarcodeCapture API は主要な SDK バージョン間で変更され、プロパティの名前が変わったり、削除されたり、構成し直されたりします。

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

意図の振り分け

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

  • BarcodeCapture をゼロから組み込む、設定する、フィードバックをカスタマイズする、ビューファインダーを追加する、スキャンを処理する、またはスキャン後に非同期処理を行う場合（例：「アプリに BarcodeCapture を追加する」「バーコードスキャンを設定する」「iOS で BarcodeCapture を使う方法」「重複スキャンをフィルタリングする」「ビープ音を消す」「ビューファインダーを追加する」「バーコードを検索している間スキャンを無効にする」）→ references/integration.md を読み、そこに記載された手順に従ってください。
  • 既存の BarcodeCapture 組み込みを移行またはアップグレードする場合（例：「v6 から v7 にアップグレードする」「BarcodeCapture を移行する」「Scandit SDK を v8 に更新する」「SDK バージョン間の変更点」）→ references/migration.md を読み、そこに記載された手順に従ってください。
  • サードパーティ製バーコードスキャナーを BarcodeCapture に置き換える場合（例：「[scanner] を BarcodeCapture に置き換える」「[framework] から BarcodeCapture に移行する」「[library] のバーコードスキャンから BarcodeCapture に切り替える」）→ references/third-party-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）
SDK のメジャーバージョン間の移行6 → 7 · 7 → 8
API リファレンス全体BarcodeCapture API

コメント

Markdown 対応