Como encontrar a URL correta do stream MJPEG da câmera de uma impressora 3D

A página web de uma câmera não é necessariamente o seu stream de vídeo. Ela pode conter controles, JavaScript e um elemento de imagem cuja origem aponta para outro lugar. O Printer Tools precisa da URL real do stream MJPEG para uma câmera MJPEG externa ou para uma prévia compatível do OctoPrint e do Crowsnest.

A diferença entre snapshot e stream é igualmente importante. Um snapshot retorna uma única imagem; o MJPEG continua enviando quadros JPEG em uma única resposta HTTP.

Printer Tools

Todas as suas impressoras 3D num único painel

Monitorize impressoras Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo e Prusa a partir de uma única app

Disponível para Android, iPhone, iPad e Mac, com apps complementares para Apple Watch e Wear OS e acesso remoto opcional por VPN, OctoEverywhere ou Obico

Identifique a origem da câmera

Comece pela documentação do servidor de webcam, do plugin do OctoPrint, do Crowsnest ou da câmera IP. Procure um valor descrito explicitamente como stream, MJPEG ou JPEG multipart.

Não presuma que o endereço da página no navegador seja o stream. Uma URL de painel costuma renderizar HTML, que não pode ser decodificado como vídeo por um componente de câmera.

Conheça os tipos de resposta comuns

Um endpoint de snapshot retorna um JPEG e depois fecha a conexão. Ele só se atualiza quando é solicitado de novo. Um endpoint MJPEG mantém uma resposta multipart aberta e separa uma sequência de quadros JPEG com delimitadores.

Se o Printer Tools receber HTML, JSON, um redirecionamento para login ou uma imagem estática onde espera quadros multipart, o Live View pode ficar em branco ou parar depois de um quadro.

Verifique caminhos relativos e absolutos

O OctoPrint e proxies reversos podem publicar caminhos relativos à própria URL base. O Crowsnest normalmente expõe uma rota MJPEG pela interface web, mas um proxy personalizado ou o nome da câmera pode alterá-la.

Use o caminho exato da sua configuração atual. Um caminho copiado da instalação do Mainsail ou do OctoPrint de outra pessoa pode apontar para um serviço que não existe na sua.

Teste autenticação e redirecionamentos

Abra o stream em um dispositivo confiável dentro da LAN. Se ele redirecionar para uma página de login, configure a autenticação compatível em vez de colar cookies do navegador no Printer Tools.

HTTP e HTTPS também importam. Uma página segura pode recusar conteúdo incorporado inseguro, e um certificado local pode exigir uma cadeia de confiança compatível. Não desative a segurança do dispositivo inteiro por causa de uma câmera.

Ajuste a resolução na origem

A largura de banda do MJPEG cresce rapidamente com a resolução, a taxa de quadros e a qualidade da imagem. Configure um perfil de monitoramento moderado no Crowsnest ou na câmera e teste a estabilidade antes de aumentá-lo.

Se vários painéis abrirem o mesmo stream, o servidor de webcam pode ter de codificar ou entregar o conteúdo para vários clientes. Use o método de compartilhamento suportado pela origem.

Mantenha separadas as câmeras nativas das impressoras

Não substitua a câmera nativa de uma impressora compatível por uma URL MJPEG adivinhada. A K1 usa seu caminho MJPEG conhecido, a K2 usa WebRTC, a Bambu escolhe RTSPS ou JPEG via TCP, e outras marcas têm transportes próprios.

Para decisões sobre qualidade de câmera, veja como escolher resolução e taxa de quadros.

Perguntas frequentes

Por que a URL funciona no navegador, mas não como câmera?

O navegador pode estar renderizando uma página web, seguindo um redirecionamento para login ou executando JavaScript em vez de abrir uma resposta MJPEG pura.

Posso usar uma URL de snapshot?

Somente onde o recurso oferecer suporte explícito a snapshots. Não é o mesmo que um stream MJPEG contínuo.

Por que o vídeo para depois de uma imagem?

Você pode ter selecionado um endpoint de snapshot em vez de um stream multipart.

Devo expor a URL da webcam na internet?

Não. Mantenha-a local e use uma VPN para acesso remoto.

Fontes oficiais: µStreamer (GitHub) · Crowsnest (GitHub) · OctoPrint — Webcam configuration