- Documentation
- Construire avec le SDK
Erreurs, vérifications du téléphone et panneau de débogage
Vérifications du téléphone. Avant le démarrage de la caméra, detectCapabilities() lit ce que le téléphone sait faire : plateforme et navigateur, page sécurisée, API caméra, WebGL 2, WebAssembly et SIMD, WebXR AR, navigateur intégré, mémoire et cœurs, et un indicateur lowEnd. Une session garde le résultat dans session.capabilities. Sans aucun WebGL, elle s'arrête avant de demander la caméra.
Écrans d'erreur. Chaque échec a un écran qui dit ce qui s'est passé, quoi faire sur ce téléphone, et les bons boutons. Il parle français ou anglais, et les étapes sont celles d'un iPhone, d'un Android ou d'un ordinateur.
| Code | Ce que la personne voit |
|---|---|
permission-denied | « La caméra est bloquée », les étapes pour l'autoriser dans les réglages du navigateur, Réessayer. |
in-app-browser | « Ouvrez cette page dans votre navigateur » : étapes pour Safari ou Chrome, Copier le lien, et sur Android Ouvrir dans Chrome. |
no-camera, not-supported, insecure-context | Une explication claire. Pas de Réessayer, car un deuxième essai ne peut rien changer. |
in-use, overconstrained, aborted, et tout autre échec (par exemple un fichier cible impossible à charger) | Une explication et Réessayer, qui recommence tout. |
Navigateurs intégrés : Facebook, Instagram, Messenger, TikTok, Snapchat, LinkedIn, Line, WeChat, Pinterest et Twitter se nomment eux-mêmes. WhatsApp et Telegram non, mais leurs vues web sont reconnues par leur forme (une vue web iPhone n'a pas « Safari » dans son user agent, une vue Android contient wv). Depuis le code : overlay.showError('permission-denied'), overlay.reportError(error), errorScreen(code, { language, platform }). La page doit être servie en HTTPS.
Panneau de débogage. Ajoutez ?debug à l'adresse (ou debug: true dans create(), debug: true sur la scène A-Frame). Une petite boîte s'affiche chaque seconde : l'état, la taille de la caméra et si la vidéo tourne, les images par seconde à l'écran, les images caméra par seconde, les poses par seconde, le temps d'image moyen et le pire, les à-coups (écarts de plus de 50 ms), les ancres visibles, la mémoire (Chrome), et les caractéristiques du téléphone. Il repose sur PerformanceMonitor (new PerformanceMonitor(session), événement stats), qui n'alloue rien dans la boucle d'images.
- Si le téléphone pivote, le tracker est reconstruit pour la nouvelle taille de vidéo.