SimCam

Что такое SimCam?

SimCam — это инструмент для тестирования камеры в iOS Simulator, который позволяет работать с функциями, связанными с камерой, без необходимости в физическом iPhone или другом устройстве с камерой. Он может транслировать поток с камеры Mac в симулятор, внедрять изображения или видео как стабильный источник камеры и генерировать QR-коды, которые вводятся напрямую в поток камеры.

Его основная цель — упростить тестирование функций камеры, таких как сканирование, распознавание изображений и потоки на основе QR-кодов, пока ваше приложение запущено в iOS Simulator и получает доступ к входу камеры через стандартные API AVFoundation.

Основные возможности

• Трансляция живого потока камеры с Mac в iOS Simulator: SimCam регистрируется как системная виртуальная камера, чтобы ваше приложение могло читать поток в реальном времени с помощью стандартных API камеры AVFoundation.
• Генерация и внедрение QR-кодов в поток камеры: Программно генерируйте QR-коды, и они появятся во входе камеры симулятора без необходимости вручную подносить устройство к экрану.
• Внедрение изображений и видео как источников камеры: Используйте изображение или видео как источник камеры, чтобы тестировать приложения, зависящие от стабильного визуального входа (например, сканирование или распознавание), предсказуемо.
• Поддержка фронтальной и задней камеры: Настраивайте источники для имитации поведения фронтальной/задней камеры, когда это нужно в вашем рабочем процессе тестирования.
• SimCam CLI для программного управления (включая сценарии с агентами): Используйте simcamctl для установки источников камеры (например, QR-кодов или медиафайлов) и проверки диагностики камеры, что позволяет автоматизировать и управлять через AI-агенты.

Как использовать SimCam

1. Скачайте и установите SimCam для Mac.
2. Запустите iOS Simulator и ваше приложение, которое использует вход камеры через AVFoundation.
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-кодов или обработка deep-link работает, внедряя QR-коды напрямую в поток камеры симулятора без ручного выравнивания экрана с телефоном.
• Стабильные визуальные тестовые данные для сканеров и распознавания: Подавайте одно и то же изображение или видео многократно для тестирования функций вроде сканирования кредитных карт, чтения штрих-кодов или других входов распознавания изображений, которые выигрывают от фиксированных образцов.
• Сценарии тестирования с агентами или скриптами: Используйте CLI, чтобы рабочий процесс автоматизации (включая агента) мог переключать источники, генерировать QR-коды и проверять диагностику камеры во время теста.
• Тестирование поведения, зависящего от фронтальной/задней камеры: Проверьте поведение приложения при обеих ориентациях камеры, если это поддерживается вашей тестовой настройкой.

Часто задаваемые вопросы

• Нужно ли модифицировать код моего приложения?
  На странице упоминается этот вопрос, но ответа не предоставлено. Единственная поддержанная деталь — SimCam регистрируется как системная виртуальная камера и работает с приложениями через стандартные API AVFoundation.

• Какие версии macOS и iOS Simulator поддерживаются?
  На странице этот вопрос указан в разделе «Перед покупкой», но детали совместимости в предоставленном контенте отсутствуют.

• Поддерживает ли SimCam сторонние библиотеки камеры?
  На странице вопрос присутствует, но конкретного ответа о совместимости нет. Предоставленные детали фокусируются на доступе через AVFoundation.

• Как работает лицензирование на разных устройствах?
  На странице упоминается лицензирование и опция пожизненного доступа, но правила для нескольких устройств в предоставленном контенте не указаны.

• Как использовать CLI или позволить агенту управлять SimCam?
  На странице указано, что SimCam включает CLI (simcamctl) для AI-агентов, чтобы переключать источники камеры, генерировать QR-коды и проверять диагностику камеры, и приведены примеры команд для установки источников QR и изображений.

Альтернативы

• Использование физического iOS-устройства для тестирования камеры: Это прямолинейная альтернатива, когда требуется поведение камеры реального устройства, но она включает работу с устройством и обычно меньше автоматизации по сравнению с виртуальной камерой.
• Тестовые harness для симулятора, имитирующие входы камеры/AVFoundation: Вместо внедрения потока камеры можно имитировать или заглушать кадры камеры в коде приложения; это может быть более ограничено, если цель — протестировать полный конвейер камеры AVFoundation.
• Универсальные фреймворки автоматизации устройств: Они могут автоматизировать взаимодействия в симуляторах или устройствах, но могут не предоставлять такой же рабочий процесс внедрения потока камеры/QR-кодов, как в SimCam.
• Подходы к тестированию QR-кодов экран-камера: Ручной подход — отображать QR-коды и визуально тестировать сканирование; SimCam отличается прямым внедрением QR-кодов в поток камеры симулятора.