Guia de solução · Teste de webcam
Como corrigir «OverconstrainedError» em câmera ou microfone
OverconstrainedError significa que uma página pediu configurações que seu dispositivo não oferece, como uma resolução exata, uma taxa de quadros ou um ID de dispositivo que não existe mais. O dispositivo funciona, mas o pedido foi rígido demais. Como visitante, você resolve escolhendo outro dispositivo ou redefinindo a página. Como desenvolvedor, você relaxa as restrições.
Lista de soluções rápidas
- 1Recarregue a página e escolha a câmera ou o microfone padrão em vez de um específico.
- 2Desconecte e reconecte o dispositivo e atualize a página para o navegador listá-lo de novo.
- 3Selecione outra câmera ou outro microfone na lista de dispositivos e teste novamente.
- 4Atualize o navegador, pois versões antigas informam limites de resolução de forma diferente.
- 5Se você desenvolve a página, use valores ideal para largura, altura e taxa de quadros em vez de valores exact.
O que são «restrições»
Uma página pode passar restrições ao getUserMedia: width, height, frameRate, facingMode, deviceId e opções de áudio. As palavras exact e min tornam um valor obrigatório. Se nenhum dispositivo conectado atende a um valor obrigatório, o navegador para com OverconstrainedError e indica no erro qual configuração falhou.
Gatilhos típicos são pedir 1920 × 1080 a uma câmera 720p, solicitar facingMode environment em um notebook com uma só câmera ou reutilizar um deviceId salvo antes de o dispositivo ser desconectado.
Como os desenvolvedores devem tratar
Prefira ideal a exact, leia a propriedade constraint do erro para ver qual configuração falhou e tente de novo uma vez com restrições mais simples. Mostre ao usuário um seletor de dispositivo em vez de falhar em silêncio. O teste de webcam informa a resolução e a taxa de quadros reais da câmera para você ver o que é possível.
Perguntas frequentes
Perguntas frequentes
O que significa OverconstrainedError?
A câmera ou o microfone não conseguiu atender a uma configuração exigida pela página, como um tamanho exato ou um dispositivo específico que não está mais conectado.
Por que aparece depois de desconectar uma câmera USB?
A página pode ainda pedir essa câmera pelo ID salvo. Escolha outro dispositivo ou recarregue para a página pedir o dispositivo padrão.
OverconstrainedError é um problema de permissão?
Não. Erros de permissão são NotAllowedError. Este é sobre configurações incompatíveis, então o aviso de permissão pode não ser o problema.
Como vejo o que minha câmera suporta?
Rode o teste de webcam e veja a resolução e a taxa de quadros mostradas junto com a imagem ao vivo.