SimCam

O que é o SimCam?

SimCam é uma ferramenta de teste de câmera para o iOS Simulator que permite trabalhar com funcionalidades relacionadas à câmera sem precisar de um iPhone físico ou outro dispositivo de câmera. Ela pode transmitir a imagem da câmera do seu Mac para o simulador, injetar imagens ou vídeo como fonte de câmera consistente e gerar QR codes que são injetados diretamente no fluxo da câmera.

Seu propósito principal é facilitar o teste de recursos de câmera — como escaneamento, entradas de reconhecimento de imagem e fluxos baseados em QR — enquanto seu app roda no iOS Simulator e acessa entrada de câmera por meio de APIs padrão do AVFoundation.

Principais Recursos

• Transmissão ao vivo da câmera do seu Mac para o iOS Simulator: SimCam se registra como uma câmera virtual em nível de sistema, para que seu app possa ler um feed em tempo real usando APIs padrão de câmera do AVFoundation.
• Geração e injeção de QR codes no fluxo da câmera: Gere QR codes programaticamente e faça-os aparecer na entrada da câmera do simulador sem precisar segurar manualmente um dispositivo em frente a uma tela.
• Injeção de imagens e vídeo como fontes de câmera: Use uma imagem ou vídeo como fonte de câmera para que apps que dependem de entrada visual consistente (ex.: escaneamento ou reconhecimento) possam ser testados de forma previsível.
• Suporte a câmeras frontal e traseira: Configure fontes para corresponder ao comportamento de câmera frontal/traseira quando necessário no seu fluxo de testes.
• SimCam CLI para controle programático (incluindo fluxos impulsionados por agentes): Use simcamctl para definir fontes de câmera (por exemplo, QR codes ou arquivos de mídia) e verificar diagnósticos de câmera, permitindo automação e controle por agentes de IA.

Como Usar o SimCam

1. Baixe e instale o SimCam para Mac.
2. Execute o iOS Simulator e seu app que usa entrada de câmera via AVFoundation.
3. Escolha a fonte de câmera necessária — transmita a câmera do seu Mac, injete uma imagem ou vídeo, ou gere e injete um QR code.
4. Use o CLI integrado quando quiser automação (por exemplo, definir uma fonte QR ou de imagem). Exemplos de comandos mostrados no site incluem:
   • simcamctl set-source --qr "AUTH_TOKEN_XYZ"
   • simcamctl set-source --image mock.png
5. Teste e itere até que o recurso relacionado à câmera do seu app funcione como esperado no simulador.

Casos de Uso

• Depuração de manipulação de entrada de câmera em uma build do iOS Simulator: Teste se seu app consome corretamente frames de câmera via AVFoundation usando um feed de câmera virtual.
• Fluxos automatizados de escaneamento de QR: Verifique se o escaneamento de QR code ou manipulação de deep-link funciona injetando QR codes diretamente no fluxo da câmera do simulador, sem alinhamento manual de tela-para-celular.
• Dados visuais de teste consistentes para scanners e reconhecimento: Alimente a mesma imagem ou vídeo repetidamente para testar recursos como escaneamento de cartão de crédito, leitura de código de barras ou outras entradas de reconhecimento de imagem que se beneficiam de dados de amostra fixos.
• Cenários de teste com agentes ou scripts: Use o CLI para que um fluxo de automação (incluindo um agente) possa alternar fontes, gerar QR codes e verificar diagnósticos de câmera durante uma execução de teste.
• Teste de comportamento que depende de câmera frontal vs. traseira: Valide o comportamento do app em ambas as orientações de câmera quando suportado pela sua configuração de testes.

FAQ

• Preciso modificar o código do meu app? A página menciona esta pergunta, mas não fornece uma resposta. O único detalhe suportado mostrado é que o SimCam se registra como uma câmera virtual em nível de sistema e funciona com apps por meio de APIs padrão do AVFoundation.

• Quais versões de macOS e iOS Simulator são suportadas? A página lista isso como uma pergunta na seção “Antes de comprar”, mas não inclui detalhes de compatibilidade no conteúdo fornecido.

• O SimCam suporta bibliotecas de câmera de terceiros? A página inclui esta como uma pergunta, mas não afirma uma resposta específica de compatibilidade. Os detalhes fornecidos focam no acesso baseado em AVFoundation.

• Como funciona o licenciamento entre dispositivos? A página menciona licenciamento e uma opção vitalícia, mas não inclui regras de uso entre dispositivos no conteúdo fornecido.

• Como uso o CLI ou deixo um agente controlar o SimCam? A página afirma que o SimCam inclui um CLI (simcamctl) para agentes de IA alternarem fontes de câmera, gerarem QR codes e verificarem diagnósticos de câmera, e fornece exemplos de comandos para definir fontes QR e de imagem.

Alternativas

• Use um dispositivo iOS físico para testes de câmera: Esta é a alternativa direta quando você precisa do comportamento real da câmera do dispositivo, mas envolve manuseio do dispositivo e geralmente menos automação em comparação com uma transmissão de câmera virtual.
• Harness de testes do Simulator que simulam entradas de câmera/AVFoundation: Em vez de injetar uma transmissão de câmera, você pode simular ou stub frames de câmera no código do app; isso pode ser mais limitado se o objetivo for testar a pipeline completa de câmera do AVFoundation.
• Frameworks gerais de automação de dispositivos: Eles podem automatizar interações em simuladores ou dispositivos, mas podem não fornecer o mesmo fluxo de trabalho de transmissão de câmera/injeção de QR descrito para o SimCam.
• Abordagens de teste de QR de tela-para-câmera: Uma abordagem manual é exibir QR codes e testar a digitalização visualmente; o SimCam se diferencia injetando QR codes diretamente na transmissão de câmera do simulator.