SimCam

SimCamとは？

SimCamは、物理的なiPhoneや他のカメラデバイスを必要とせずに、iOS Simulatorでカメラ関連機能のテストを可能にするカメラテストツールです。Macのカメラフィードをシミュレータにストリーミングしたり、画像や動画を一貫したカメラソースとして注入したり、カメラストリームに直接QRコードを生成・注入したりできます。

主な目的は、iOS Simulator上でアプリを実行し、標準のAVFoundation API経由でカメラ入力を利用する際に、カメラ機能（スキャン、画像認識入力、QRベースのフローのようなもの）のテストを容易にすることです。

主な機能

• MacからiOS Simulatorへのライブカメラストリーミング: SimCamはシステムレベルの仮想カメラとして登録されるため、アプリは標準のAVFoundationカメラAPIを使ってリアルタイムフィードを読み取れます。
• カメラストリームへのQRコード生成と注入: プログラムでQRコードを生成し、手動でデバイスを画面に近づけることなく、シミュレータのカメラ入力に表示できます。
• 画像と動画メディアをカメラソースとして注入: スキャンや認識に依存するアプリを予測可能にテストするため、画像や動画をカメラソースとして使用します。
• フロント/バックカメラ対応: テストフローの要件に応じて、フロント/バックカメラの動作にソースを構成します。
• プログラム制御のためのSimCam CLI（エージェント駆動ワークフロー含む）: simcamctlを使ってカメラソース（例: QRコードやメディアファイル）を設定したり、カメラ診断を確認したりでき、自動化やAIエージェント制御を可能にします。

SimCamの使い方

1. Mac用SimCamをダウンロードしてインストール。
2. AVFoundation経由でカメラ入力を使用するiOS Simulatorとアプリを実行。
3. 必要なカメラソースを選択—Macのカメラをストリーミング、画像や動画を注入、またはQRコードを生成・注入。
4. 自動化が必要な場合にビルトインCLIを使用（例: QRソースや画像ソースの設定）。サイトに表示される例コマンド:
   • simcamctl set-source --qr "AUTH_TOKEN_XYZ"
   • simcamctl set-source --image mock.png
5. テストと反復して、シミュレータ内でアプリのカメラ関連機能が期待通りに動作するまで。

ユースケース

• iOS Simulatorビルドでのカメラ入力処理のデバッグ: 仮想カメラフィードを使って、アプリがAVFoundation経由でカメラフレームを正しく消費することをテスト。
• 自動化QRスキャンフロー: 手動での画面-電話アライメントなしに、QRコードをシミュレータカメラストリームに直接注入して、QRコードスキャンやデイープリンク処理が動作することを検証。
• スキャナーと認識のための固定視覚テストデータ: クレジットカードスキャン、バーコード読み取り、その他の画像認識入力などの機能を固定サンプルデータでテストするため、同じ画像や動画を繰り返し供給。
• エージェントやスクリプトテストシナリオ: CLIを使って自動化ワークフロー（エージェント含む）がソースを切り替え、QRコードを生成、カメラ診断を確認。
• フロント対バックカメラに依存する動作のテスト: テストセットアップでサポートされる場合、両カメラ方向でのアプリ動作を検証。

FAQ

• アプリのコードを修正する必要はありますか？ このページではこの質問を参照していますが、回答は提供されていません。表示されている唯一の詳細は、SimCamがシステムレベルの仮想カメラとして登録され、標準のAVFoundation API経由でアプリと動作することです。

• どのmacOSおよびiOS Simulatorバージョンがサポートされていますか？ ページでは「購入前の確認」セクションでこの質問を挙げていますが、提供コンテンツに互換性詳細は含まれていません。

• SimCamはサードパーティカメラライブラリをサポートしますか？ ページではこの質問を含んでいますが、具体的な互換性回答は述べていません。提供詳細はAVFoundationベースのアクセスに焦点を当てています。

• デバイス間でのライセンスはどう機能しますか？ ページではライセンスと生涯オプションを言及していますが、提供コンテンツにクロスデバイスルールは含まれていません。

• CLIの使い方やエージェントでSimCamを制御する方法は？ ページでは、SimCamにCLI（simcamctl）が含まれており、AIエージェントがカメラソースを切り替え、QRコードを生成、カメラ診断を確認できると述べ、QRおよび画像ソース設定の例コマンドを提供しています。

代替案

• 物理的なiOSデバイスでカメラテストを行う: 実機のカメラ動作が必要な場合のシンプルな代替案ですが、デバイスの取り扱いが必要で、仮想カメラフィードに比べて自動化が通常少ないです。
• カメラ/AVFoundation入力をモックするSimulatorテストハーネス: カメラストリームを注入する代わりに、アプリコードでカメラフレームをモック/スタブできますが、AVFoundationカメラパイプライン全体をテストする目的では制限されることがあります。
• 汎用デバイス自動化フレームワーク: Simulatorやデバイスでの操作を自動化できますが、SimCamで説明されたカメラストリーム/QR注入ワークフローを提供しない場合があります。
• 画面からカメラへのQRテストアプローチ: QRコードを表示して視覚的にスキャンテストする手動アプローチです。SimCamはQRコードをSimulatorのカメラストリームに直接注入することで異なります。