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 코드를 생성하며 카메라 진단을 확인.
• 전면 vs. 후면 카메라에 의존하는 동작 테스트: 테스트 설정에서 지원되는 경우 두 카메라 방향 모두에서 앱 동작 검증.

자주 묻는 질문

• 앱 코드를 수정해야 하나요? 이 질문에 대한 답변은 제공되지 않습니다. SimCam이 시스템 수준 가상 카메라로 등록되어 표준 AVFoundation API를 통해 앱과 작동한다는 세부 정보만 지원됩니다.

• 어떤 macOS와 iOS Simulator 버전이 지원되나요? “구매 전 확인” 섹션에 질문으로 나열되어 있지만, 제공된 콘텐츠에 호환성 세부 정보는 포함되지 않습니다.

• SimCam이 타사 카메라 라이브러리를 지원하나요? 질문으로 포함되어 있지만 구체적인 호환성 답변은 명시되지 않습니다. 제공된 세부 정보는 AVFoundation 기반 접근에 중점을 둡니다.

• 라이선싱은 기기 간에 어떻게 되나요? 라이선싱과 평생 옵션이 언급되지만, 제공된 콘텐츠에 기기 간 규칙은 포함되지 않습니다.

• CLI 사용법이나 에이전트로 SimCam 제어 방법은? SimCam에 CLI(simcamctl)가 포함되어 AI 에이전트가 카메라 소스를 전환하고 QR 코드를 생성하며 카메라 진단을 확인할 수 있으며, QR 및 이미지 소스 설정 예제 명령어가 제공됩니다.

대안

• 실제 iOS 기기를 카메라 테스트에 사용: 실제 기기 카메라 동작이 필요할 때 직관적인 대안이지만, 기기 조작이 필요하고 가상 카메라 피드에 비해 자동화가 보통 덜 됩니다.
• 카메라/AVFoundation 입력을 모킹하는 시뮬레이터 테스트 하네스: 카메라 스트림 주입 대신 앱 코드에서 카메라 프레임을 모킹하거나 스텁 처리; 전체 AVFoundation 카메라 파이프라인 테스트가 목표라면 더 제한적일 수 있습니다.
• 범용 기기 자동화 프레임워크: 시뮬레이터나 기기에서 상호작용을 자동화할 수 있지만, SimCam에 설명된 카메라 스트림/QR 주입 워크플로와 동일하지 않을 수 있습니다.
• 화면-카메라 QR 테스트 접근법: QR 코드를 표시하고 시각적으로 스캔 테스트하는 수동 방식; SimCam은 QR 코드를 시뮬레이터 카메라 스트림에 직접 주입하는 점에서 다릅니다.