Guide de dépannage · Test de webcam
Comment corriger « OverconstrainedError » pour une caméra ou un micro
OverconstrainedError signifie qu'une page a demandé des réglages que votre appareil ne peut pas fournir, comme une résolution exacte, une fréquence d'images ou un identifiant d'appareil qui n'existe plus. L'appareil fonctionne, mais la demande était trop stricte. En tant que visiteur, vous corrigez en choisissant un autre appareil ou en réinitialisant la page. En tant que développeur, vous assouplissez les contraintes.
Liste de dépannage rapide
- 1Rechargez la page et choisissez la caméra ou le micro par défaut plutôt qu'un appareil précis.
- 2Débranchez et rebranchez l'appareil, puis actualisez pour que le navigateur le liste de nouveau.
- 3Sélectionnez une autre caméra ou un autre micro dans la liste des appareils et testez de nouveau.
- 4Mettez à jour le navigateur, car les anciennes versions signalent différemment les limites de résolution.
- 5Si vous développez la page, utilisez des valeurs ideal pour la largeur, la hauteur et la fréquence d'images plutôt que des valeurs exact.
Ce que sont les « contraintes »
Une page peut passer des contraintes à getUserMedia : width, height, frameRate, facingMode, deviceId et des options audio. Les mots exact et min rendent une valeur obligatoire. Si aucun appareil connecté ne peut respecter une valeur obligatoire, le navigateur s'arrête avec OverconstrainedError et indique dans l'erreur le réglage qui a échoué.
Les déclencheurs typiques sont la demande d'une image 1920 × 1080 à une caméra 720p, la demande de facingMode environment sur un portable qui n'a qu'une caméra, ou la réutilisation d'un deviceId enregistré avant le débranchement de l'appareil.
Comment les développeurs doivent le gérer
Préférez ideal à exact, lisez la propriété constraint de l'erreur pour voir quel réglage a échoué et réessayez une fois avec des contraintes plus simples. Proposez à l'utilisateur un sélecteur d'appareil plutôt qu'un échec silencieux. Le test de la webcam indique la résolution et la fréquence d'images réelles de la caméra, ce qui permet de voir ce qui est possible.
FAQ
Questions fréquentes
Que signifie OverconstrainedError ?
La caméra ou le micro n'a pas pu satisfaire un réglage exigé par la page, comme une taille exacte ou un appareil précis qui n'est plus connecté.
Pourquoi apparaît-il après avoir débranché une caméra USB ?
La page demande peut-être encore cette caméra par son identifiant enregistré. Choisissez un autre appareil ou rechargez pour que la page demande l'appareil par défaut.
OverconstrainedError est-il un problème d'autorisation ?
Non. Les erreurs d'autorisation sont des NotAllowedError. Celle-ci concerne des réglages non pris en charge, donc la demande d'autorisation n'est peut-être pas en cause.
Comment savoir ce que ma caméra prend en charge ?
Lancez le test de la webcam et lisez la résolution et la fréquence d'images affichées avec l'image en direct.