Requisitos de rede e definições de firewall

Quando precisas disto?

A maioria das redes domésticas e de pequenos escritórios funciona com o Screenbird de forma imediata. Só precisas deste artigo se a tua rede tem:

Uma firewall restritiva que bloqueia domínios desconhecidos
Um filtro web ou proxy que limita o tráfego de saída
Uma VLAN separada para ecrãs sem acesso à internet

Domínios necessários

Inclui em allowlist estes domínios tanto para o dashboard (usado pelas pessoas que gerem o conteúdo) como para o player (em execução no ecrã).

Domínios do dashboard

screenbird.app, aplicação principal
dev.screenbird.app, staging (apenas necessário se a tua equipa usar staging)
api.screenbird.app, API de dispositivos
*.supabase.co, base de dados e autenticação
cdn.screenbird.app, recursos estáticos e conteúdo
media.screenbird.app, imagens e vídeos

Domínios do player

player.screenbird.app, aplicação do player
cdn.screenbird.app, entrega de conteúdo
*.supabase.co, ligação à tua conta
api.screenbird.app, heartbeat e sincronização de conteúdo

Domínios opcionais (usados por algumas aplicações e integrações)

apis.google.com, seletor de Google Slides, Sheets, Docs
*.googleusercontent.com, miniaturas do Google Drive
images.pexels.com, biblioteca de imagens Pexels
api.qrserver.com, códigos QR em templates
geocoding-api.open-meteo.com, preenchimento automático de localização na aplicação Meteorologia
challenges.cloudflare.com, Cloudflare Turnstile (usado durante o registo e formulários de contacto)

Se não usas uma integração específica, não precisas de incluir o seu domínio em allowlist.

Portas necessárias

HTTPS (443), toda a comunicação usa HTTPS sobre a porta 443
WebSocket (443), a comunicação em tempo real também usa a porta 443

O Screenbird não usa quaisquer portas não-padrão.

Protocolos necessários

HTTPS para todo o tráfego
WebSocket Secure (WSS) para atualizações em tempo real do dashboard para o player

Requisitos de largura de banda

Player em repouso, menos de 10 KB por minuto (apenas heartbeat)
Player a reproduzir imagens estáticas, mínimo após o conteúdo ser descarregado
Player a reproduzir vídeo 1080p, o download inicial depende do tamanho do ficheiro, depois 0 tráfego durante a reprodução (os vídeos ficam em cache local)
Player a reproduzir transmissões em direto (YouTube, RSS), depende da transmissão

Para a maioria das redes de sinalização, 5 Mbps de download é mais do que suficiente por ecrã. O Screenbird foi concebido para funcionar offline depois do conteúdo estar descarregado, pelo que falhas breves de rede não interrompem a reprodução.

Testar a tua rede

Para verificar se um ecrã consegue chegar ao Screenbird, abre um navegador no dispositivo e vai a:

https://player.screenbird.app, deve carregar o ecrã de início de sessão do player
https://screenbird.app, deve carregar a página de início de sessão do dashboard

Se algum falhar, verifica os registos da firewall em busca de pedidos bloqueados aos domínios listados em cima.

Precisas de ajuda com implementação empresarial?

Se estás a implementar muitos ecrãs em redes empresariais e precisas de ajuda com documentação de allowlist, validação de TI ou configuração de proxy, contacta-nos em support@screenbird.app e ajudamos-te.