UStackUStack
SimCam icon

SimCam

SimCam diffuse la caméra de votre Mac dans l’iOS Simulator, injecte images/vidéo et génère des QR via une caméra virtuelle AVFoundation.

SimCam

Qu’est-ce que SimCam ?

SimCam est un outil de test de caméra pour l’iOS Simulator qui vous permet de travailler avec des fonctionnalités liées à la caméra sans avoir besoin d’un iPhone physique ou d’un autre appareil photo. Il peut diffuser le flux de la caméra de votre Mac dans le simulateur, injecter des images ou vidéos comme source caméra constante, et générer des QR codes injectés directement dans le flux caméra.

Son objectif principal est de faciliter les tests de fonctionnalités caméra — comme le scanning, les entrées de reconnaissance d’images et les flux basés sur QR — pendant que votre app s’exécute dans l’iOS Simulator et accède aux entrées caméra via les API AVFoundation standard.

Fonctionnalités principales

  • Diffusion en direct de la caméra de votre Mac dans l’iOS Simulator : SimCam s’enregistre comme une caméra virtuelle au niveau système pour que votre app puisse lire un flux en temps réel via les API caméra AVFoundation standard.
  • Génération et injection de QR codes dans le flux caméra : Générez des QR codes par programmation et faites-les apparaître dans l’entrée caméra du simulateur sans avoir à tenir manuellement un appareil devant un écran.
  • Injection d’images et vidéos comme sources caméra : Utilisez une image ou vidéo comme source caméra pour tester de manière prévisible les apps dépendant d’entrées visuelles constantes (ex. : scanning ou reconnaissance).
  • Support des caméras avant et arrière : Configurez les sources pour reproduire le comportement des caméras avant/arrière selon les besoins de votre workflow de test.
  • SimCam CLI pour un contrôle programmatique (y compris workflows pilotés par agents) : Utilisez simcamctl pour définir les sources caméra (ex. : QR codes ou fichiers média) et vérifier les diagnostics caméra, permettant l’automatisation et le contrôle par agents IA.

Comment utiliser SimCam

  1. Téléchargez et installez SimCam pour Mac.
  2. Lancez votre iOS Simulator et votre app qui utilise les entrées caméra via AVFoundation.
  3. Choisissez la source caméra dont vous avez besoin — diffusez la caméra de votre Mac, injectez une image ou vidéo, ou générez/injectez un QR code.
  4. Utilisez la CLI intégrée pour l’automatisation (ex. : définir une source QR ou image). Exemples de commandes sur le site :
    • simcamctl set-source --qr "AUTH_TOKEN_XYZ"
    • simcamctl set-source --image mock.png
  5. Testez et itérez jusqu’à ce que la fonctionnalité caméra de votre app se comporte comme attendu dans le simulateur.

Cas d’usage

  • Débogage de la gestion des entrées caméra dans une build iOS Simulator : Vérifiez que votre app consomme correctement les frames caméra via AVFoundation avec un flux caméra virtuel.
  • Flux de scanning QR automatisés : Vérifiez que votre scanning de QR codes ou gestion de deep-links fonctionne en injectant directement des QR codes dans le flux caméra du simulateur, sans alignement manuel écran-téléphone.
  • Données visuelles de test constantes pour scanners et reconnaissance : Fournissez la même image ou vidéo de manière répétée pour tester des fonctionnalités comme le scanning de cartes bancaires, lecture de codes-barres ou autres entrées de reconnaissance d’images bénéficiant de données d’échantillon fixes.
  • Scénarios de test par agents ou scripts : Utilisez la CLI pour qu’un workflow d’automatisation (y compris un agent) puisse changer les sources, générer des QR codes et vérifier les diagnostics caméra pendant un test.
  • Test de comportements dépendant de la caméra avant vs. arrière : Validez le comportement de l’app sous les deux orientations caméra quand votre setup de test le supporte.

FAQ

  • Dois-je modifier le code de mon app ? La page mentionne cette question, mais ne fournit pas de réponse. Le seul détail indiqué est que SimCam s’enregistre comme une caméra virtuelle au niveau système et fonctionne avec les apps via les API AVFoundation standard.

  • Quelles versions de macOS et iOS Simulator sont prises en charge ? La page liste cette question dans la section « Avant d’acheter », mais n’inclut pas de détails de compatibilité dans le contenu fourni.

  • SimCam supporte-t-il les bibliothèques caméra tierces ? La page inclut cette question mais ne donne pas de réponse spécifique de compatibilité. Les détails fournis se concentrent sur l’accès basé sur AVFoundation.

  • Comment fonctionne la licence sur plusieurs appareils ? La page mentionne la licence et une option à vie, mais n’inclut pas de règles multi-appareils dans le contenu fourni.

  • Comment utiliser la CLI ou laisser un agent piloter SimCam ? La page indique que SimCam inclut une CLI (simcamctl) pour que les agents IA puissent changer les sources caméra, générer des QR codes et vérifier les diagnostics caméra, et fournit des exemples de commandes pour définir les sources QR et images.

Alternatives

  • Utiliser un appareil iOS physique pour les tests de caméra : C’est l’alternative directe quand vous avez besoin du comportement caméra d’un vrai appareil, mais cela implique la manipulation de l’appareil et généralement moins d’automatisation qu’un flux caméra virtuel.
  • Harness de test pour Simulator qui simulent les entrées caméra/AVFoundation : Au lieu d’injecter un flux caméra, vous pouvez simuler ou stubber les frames caméra dans le code de l’app ; cela peut être plus limité si votre objectif est de tester la pipeline caméra AVFoundation complète.
  • Frameworks d’automatisation d’appareils généralistes : Ils peuvent automatiser les interactions dans les simulateurs ou appareils, mais ils ne fournissent pas forcément le même workflow d’injection de flux caméra/QR décrit pour SimCam.
  • Approches de test QR écran-vers-caméra : Une approche manuelle consiste à afficher des QR codes et tester le scan visuellement ; SimCam se distingue en injectant directement les QR codes dans le flux caméra du simulateur.