SimCam

SimCam 是什麼？

SimCam 是 iOS Simulator 的相機測試工具，讓您無需實體 iPhone 或其他相機裝置，即可處理相機相關功能。它能將 Mac 相機畫面串流至模擬器，將影像或影片注入作為穩定相機來源，並直接將 QR Code 注入相機串流中。

其核心目的是簡化相機功能測試，例如掃描、影像辨識輸入及 QR 流程，讓您的 App 在 iOS Simulator 中透過標準 AVFoundation API 存取相機輸入時更容易測試。

主要功能

• 從 Mac 即時串流相機至 iOS Simulator：SimCam 註冊為系統級虛擬相機，讓您的 App 使用標準 AVFoundation 相機 API 讀取即時畫面。
• QR Code 產生與注入相機串流：程式化產生 QR Code，讓它們出現在模擬器相機輸入中，無需手動將裝置對準螢幕。
• 影像與影片注入作為相機來源：使用影像或影片作為相機來源，讓依賴穩定視覺輸入的 App（例如掃描或辨識）能可預測地測試。
• 前後相機支援：設定來源以匹配前後相機行為，適用於您的測試流程需求。
• SimCam CLI 用於程式化控制（包含代理驅動工作流程）：使用 simcamctl 設定相機來源（例如 QR Code 或媒體檔案）並檢查相機診斷，實現自動化及 AI 代理控制。

如何使用 SimCam

1. 下載並安裝 Mac 版 SimCam。
2. 執行 iOS Simulator 及您的 App，該 App 透過 AVFoundation 使用相機輸入。
3. 選擇所需相機來源—串流 Mac 相機、注入影像或影片，或產生並注入 QR Code。
4. 需要自動化時使用內建 CLI（例如設定 QR 來源或影像來源）。網站顯示範例指令包括：
   • simcamctl set-source --qr "AUTH_TOKEN_XYZ"
   • simcamctl set-source --image mock.png
5. 測試並迭代，直到 App 的相機相關功能在模擬器中如預期運作。

使用情境

• 在 iOS Simulator 組建中除錯相機輸入處理：使用虛擬相機畫面測試 App 是否正確透過 AVFoundation 消耗相機畫面。
• 自動化 QR 掃描流程：透過直接注入 QR Code 至模擬器相機串流，驗證 QR Code 掃描或深層連結處理是否正常，無需手動螢幕對手機對準。
• 掃描器與辨識的穩定視覺測試資料：重複提供相同影像或影片，測試信用卡掃描、條碼讀取或其他受益於固定樣本資料的影像辨識輸入。
• 代理或腳本化測試情境：使用 CLI 讓自動化工作流程（包含代理）在測試執行中切換來源、產生 QR Code 並檢查相機診斷。
• 依賴前後相機行為的測試：在您的測試設定支援時，驗證 App 在兩種相機方向下的行為。

常見問題

• 需要修改 App 程式碼嗎？ 頁面提及此問題，但未提供答案。唯一顯示的支援細節是 SimCam 註冊為系統級虛擬相機，並透過標準 AVFoundation API 與 App 運作。

• 支援哪些 macOS 及 iOS Simulator 版本？ 頁面在「購買前」區段列為問題，但提供的內容未包含相容性細節。

• SimCam 支援第三方相機函式庫嗎？ 頁面包含此問題，但未陳述特定相容性答案。提供的細節聚焦於基於 AVFoundation 的存取。

• 授權在多裝置間如何運作？ 頁面提及授權及終身選項，但提供的內容未包含跨裝置規則。

• 如何使用 CLI 或讓代理驅動 SimCam？ 頁面指出 SimCam 包含 CLI（simcamctl）供 AI 代理切換相機來源、產生 QR Code 並檢查相機診斷，並提供設定 QR 及影像來源的範例指令。

替代方案

• 使用實體 iOS 裝置進行相機測試：當需要真實裝置相機行為時，這是直接替代方案，但涉及裝置操作，且相較虛擬相機饋送，通常自動化程度較低。
• 模擬器測試框架，模擬相機/AVFoundation 輸入：不注入相機串流，而是可在應用程式程式碼中模擬或存根相機畫面；若目標是測試完整 AVFoundation 相機管線，這可能更受限。
• 通用裝置自動化框架：這些可在模擬器或裝置中自動化互動，但可能無法提供 SimCam 所述的相同相機串流/QR 注入工作流程。
• 螢幕對相機 QR 測試方法：手動方式是顯示 QR Code 並視覺測試掃描；SimCam 的不同之處在於直接將 QR Code 注入模擬器的相機串流。