Colocar o Player na sua tela

Quais Players estão disponíveis?

Players: o aplicativo web Player (PWA), Android no Google Play, Amazon Signage Stick, Apple TV, macOS, iPhone e iPad, Windows, pacotes para Linux e Raspberry Pi, LG webOS Signage, BrightSign e Samsung Smart Signage (Tizen). Instalar um Player nativo para a reprodução mais rápida e confiável.

O app web do Player (PWA) em play.screenrig.ai/player/ roda em qualquer tela com navegador moderno: uma smart TV ou monitor comercial com navegador embutido, um dispositivo ChromeOS gerenciado em modo quiosque, um tablet ou um computador conectado à tela. Um embed somente de status do Player está em play.screenrig.ai/player/embed/status/.

Cada Player mostra um código de pareamento. Dê-o ao seu agente, e ele cuida do resto.

Cada Player, exceto o Windows, também mostra um código QR na sua tela de pareamento. Escaneie-o com um celular conectado ao dashboard e confirme em Parear tela.

Sincronização eventual

Players Android, Amazon Signage Stick, macOS, Windows, Linux e Raspberry Pi alinham gradualmente as mudanças de página com Players próximos exibindo a mesma revisão da playlist. Atribua a mesma playlist a telas em uma sub-rede IPv4. Use durações fixas de página de pelo menos um segundo, corte transições e sem animações de entrada. Cada Player transmite um pequeno sinal de início de página e faz um pequeno ajuste em sua espera antes da próxima página. Ajustes de tempo ativam apenas após a descoberta de um segundo Player na mesma revisão da playlist. Telas em playlists diferentes não influenciam umas às outras. Uma tela solitária mantém seu tempo normal de reprodução; o grupo segue a posição mediana de reprodução uma vez que pares se juntam.

A rede deve permitir broadcast UDP dispositivo a dispositivo na porta 49817. Permita acesso à rede local quando o dispositivo solicitar. As telas continuam reproduzindo apesar de perda de pacotes, ciclos de energia e partições de rede, e convergem novamente conforme chegam os sinais das páginas. Cada espera adicionada é limitada a 40 milissegundos. Páginas longas e grandes diferenças de tempo levam mais para convergir; isso sincroniza mudanças de página em vez de quadros de vídeo ou trilhas sonoras.

Para aproximar rapidamente uma localização, peça ao seu agente para reiniciar a reprodução nas telas com screen reload --tag LOCATION, substituindo LOCATION pela tag compartilhada. Os Players reiniciam playlists elegíveis na primeira página e finalizam o alinhamento através de seus beacons regulares. Pareamento e conteúdo baixado permanecem no lugar.

Instalar um Player nativo

Cada download também está na página de Downloads.

1. 01

   Instale o Player para seu dispositivo de tela.

2. 02

   Lançar. Abre em tela cheia e mostra um código de pareamento.

3. 03

   Dê o código de pareamento ao seu agente. Ele pareia a tela e publica nela.

Cada player nativo baixa a mídia uma vez, armazena em cache e a reproduz do armazenamento local.

Instale o APK do Android

Use o APK em TVs Android, dispositivos Google TV, tablets e caixas de sinalização no Android 9 ou superior que não usem Google Play. Use-o quando instalar por ADB.

O APK é assinado e público. É o mesmo Player da versão do Google Play. Seu nome de arquivo carrega a versão, então use https://screenrig.ai/android/manifest.json como o único apontador para o arquivo atual.

Antes de começar, ative as opções de desenvolvedor e a depuração USB ou de rede no dispositivo. Você também precisa de adb no seu computador.

1. Conecte ao dispositivo. Para um dispositivo de rede, execute adb connect DEVICE_IP:5555.

2. Baixe, verifique e instale o APK:

   curl -fsSL https://screenrig.ai/android/manifest.json -o manifest.json
   path=$(jq -r .player.path manifest.json); sha=$(jq -r .player.sha256 manifest.json)
   curl -fsSLO "https://screenrig.ai$path"
   echo "$sha  ${path##*/}" | sha256sum -c -
   adb install -r "${path##*/}"
   adb shell am start ai.screenrig.player

3. O Player abre em tela cheia e mostra um código de pareamento. Dê o código ao seu agente.

Iniciar na inicialização

Iniciar na inicialização está ativado por padrão. É um interruptor nas configurações do operador do Player: uma vez que a tela esteja pareada, pressione OK no controle remoto para abrir o menu e escolha Configurações. No Android 9, nenhuma permissão é necessária. No Android 10 e posteriores, conceda Exibir sobre outros apps a menos que o dispositivo seja gerenciado como proprietário do dispositivo: selecione Iniciar na inicialização e siga as instruções. Quando há uma tela de permissão disponível, o Player solicita a permissão ao mostrar o código de pareamento pela primeira vez: selecione Abrir configurações e permita Exibir sobre outros apps. Até que a permissão seja concedida, a linha exibirá Permissão necessária e o Player não iniciará na inicialização. Você também pode concedê-la via ADB:

adb shell cmd appops set ai.screenrig.player SYSTEM_ALERT_WINDOW allow

No Fire OS 8, use ADB para conceder essa permissão; a tela de configurações não a oferece.

Protetor de tela

No Android TV e Google TV, screenRIG é um dos protetores de tela da TV. Abra Protetor de tela nas Configurações da TV e selecione screenRIG. Quando a TV iniciaria seu protetor de tela, o Player vem para a frente e reproduz seu conteúdo. Nenhuma permissão é necessária.

Atualizando

Execute as etapas de instalação novamente. O Android instala a versão superior sobre a instalada e mantém seu pareamento. Apenas uma versão superior substitui a instalada.

Google Play

O APK e a versão do Google Play compartilham o pacote ai.screenrig.player. Se a versão do Google Play estiver instalada, desinstale-a primeiro. Faça o pareamento do Player novamente após instalar o APK.

Linux e Raspberry Pi

O Player Linux é um pacote autônomo para Linux 64 bits, construído para PCs x86_64 e placas aarch64 como o Raspberry Pi. Qt, Qt WebEngine e GStreamer estão dentro do pacote. A máquina precisa da versão de glibc indicada para sua arquitetura em screenrig.ai/linux/, de uma sessão Wayland ou do compositor de quiosque cage, e de seus próprios drivers GPU, fontes, certificados CA e serviço de áudio.

Instale-o com o instalador, que seleciona a versão para a máquina e verifica contra SHA256SUMS:

curl -fsSL https://screenrig.ai/linux/install.sh | sh

Em uma tela dedicada, adicione --kiosk (sh -s -- --kiosk) para iniciar o Player na inicialização dentro de cage sob um serviço systemd. Execute o instalador novamente para atualizar, ou com --uninstall para removê-lo. Instalação manual: baixe screenrig-player-linux-x86_64.tar.gz ou screenrig-player-linux-aarch64.tar.gz e SHA256SUMS de screenrig.ai/linux/, verifique-os com sha256sum --ignore-missing -c SHA256SUMS, extraia para /opt/screenrig-player e execute /opt/screenrig-player/screenrig-player.

Debian 13, Raspberry Pi OS (trixie, 64 bits), Ubuntu, Fedora e Arch Linux executam o Player quando atendem ao requisito de glibc do pacote. Debian 12 e Raspberry Pi OS bookworm possuem uma glibc mais antiga; atualize-os primeiro. Pacotes por distribuição para uma instalação de quiosque estão nas notas de download do Linux.

Raspberry Pi

Use Raspberry Pi OS (64 bits) baseado no trixie; as imagens 32 bits e bookworm não podem executar o Player. Raspberry Pi 5 decodifica HEVC em hardware até 4K a 60 fps e não tem decodificador H.264, então envie todo vídeo para ele com screenrig media upload --codec hevc, em qualquer tamanho. Raspberry Pi 4 reproduz 1080p. Raspberry Pi OS Lite com --kiosk inicializa direto no Player.

Mantenha a resolução escolhida para a tela: um vídeo HEVC 4K é reproduzido em uma saída de 1920×1080. Para atualizar um Player Pi, execute novamente o instalador Linux usando o prefixo de instalação e a conta do Player existentes; o pareamento e as configurações de tela são mantidos. Recarregar uma tela atualiza o conteúdo e não instala uma nova versão do Player.

Video walls

Um Player controla de 2 a 12 displays como uma parede: o Player Linux em uma instalação --kiosk com wlr-randr (sudo apt install wlr-randr) e o Player Windows. Um Raspberry Pi 5 controla dois displays; um PC controla quantos suas saídas gráficas permitirem, e um mini PC Intel como o Quieter 4C controla até três. O Player Windows organiza ele mesmo o layout de displays do Windows: posiciona e gira os displays e os espelha pelo modo de duplicação do Windows para uma playlist sem format. O Windows mantém sua própria escala de display.

screen show lista as saídas da tela, por exemplo HDMI-A-1 no Linux ou DISPLAY1 no Windows. Uma parede é uma row (da esquerda para a direita), uma column (de cima para baixo) ou uma grid. Uma grade usa --columns, os displays por linha, e preenche pelo menos duas linhas: 12 displays em 4 colunas formam 3 linhas. Os displays são numerados da esquerda para a direita, depois de cima para baixo, e --outputs nomeia as saídas nessa ordem. --rotation gira cada display no sentido horário em 0 (padrão), 90, 180 ou 270 graus; 90 e 270 são painéis em modo retrato.

screenrig screen wall set SCREEN_ID --outputs HDMI-A-1,HDMI-A-2 --arrangement row [--rotation 0|90|180|270]
screenrig screen wall set SCREEN_ID --outputs DISPLAY1,DISPLAY2,DISPLAY3,DISPLAY4 --arrangement grid --columns 2
screenrig screen wall clear SCREEN_ID

Após uma mudança de parede, cada monitor mostra seu número e nome de saída por 20 segundos, para que você possa verificar a ordem.

Uma playlist construída para a parede carrega um format (displays, arrangement, orientation e, para uma grade, columns) e uma tela de página, em unidades de design 1080p por display: um tile é 1920 × 1080 em paisagem ou 1080 × 1920 em retrato, e a tela é o tile vezes as colunas e linhas. Um painel 4K não precisa de nada diferente. Uma tela toca uma playlist de parede apenas quando sua parede tem a mesma forma.

Coloque um item com displays: [1,2,3] ocupa três monitores em uma linha, [2] fica em um monitor e [1,2] ocupa dois. Os monitores preenchem um retângulo da parede: em uma grade de 4 colunas, [1,2,5,6] é o bloco superior esquerdo e [3,7,11] uma coluna de três. Ou dê um rect livre na tela da parede. Um cartão se posiciona dentro do seu displays, então center em [2] fica no meio do monitor 2; sem displays usa todos os monitores. Em uma tela com parede, uma playlist comum (sem format) toca espelhada em todos os monitores.

Renderizar vídeo de parede na proporção da parede dentro de 4K, como 3840 × 720 para três monitores paisagem em uma linha, 3840 × 1080 para dois e 3840 × 1620 para uma grade de 4 colunas e 3 linhas, e posicioná-lo com content_fit: fill. Mantenha texto e rostos fora das junções entre os monitores.

{
  "name": "Lobby wall",
  "format": { "displays": 3, "arrangement": "row", "orientation": "landscape" },
  "pages": [
    {
      "id": "welcome",
      "canvas": { "width": 5760, "height": 1080, "background": "#000000FF" },
      "transition": { "type": "crossfade", "duration_ms": 500 },
      "advance": { "mode": "media_end" },
      "primitives": [
        {
          "id": "film",
          "primitive": "video",
          "selector": { "by": "id", "media_id": "med_01EXAMPLEWALL000000000" },
          "displays": [1, 2, 3],
          "layer": 0,
          "content_fit": "fill"
        },
        {
          "id": "menu",
          "primitive": "card",
          "card": "crd_01EXAMPLEMENU000000000",
          "layout": "center",
          "displays": [2],
          "content_fit": "fill"
        }
      ]
    }
  ]
}

Faixas

Uma faixa é uma playlist desenhada sobre a página ao longo de uma borda de um display, como um letreiro embaixo ou um logotipo em cima. A página continua tocando por baixo; a faixa esconde a parte que cobre. Uma faixa é feita para uma região: header (a borda superior), footer (a borda inferior) ou side (a borda direita, em altura total).

Uma playlist de faixa é uma playlist de região: carrega format: {"region": "footer", "orientation": "landscape"}, em que orientation é a orientação do display para o qual ela é feita, como o espectador a vê. Ela tem uma única tela de faixa, com a forma da sua borda: o lado longo corre ao longo da borda e tem pelo menos o dobro do curto, como 1920 × 240 para um rodapé ou cabeçalho em paisagem e 240 × 1080 para uma lateral em paisagem. Uma faixa contém apenas itens de imagem e cartão, sem vídeo, stream, iframe, aplicativo nem espaço de anúncio, e não tem trilha sonora. Uma faixa nunca é uma playlist padrão nem uma tomada de controle.

screenrig playlist create ticker.json --format-region footer --format-orientation landscape
screenrig campaign create --name Ticker --playlist-id pl_TICKER --tag lobby --covers footer

Uma campanha ou uma entrada de agenda mostra uma faixa por meio de covers: footer, header ou side toca uma faixa dessa região, e full (o padrão) ou main toca uma playlist comum como página. Um nível que cobre uma região precisa de uma playlist feita para essa região.

A faixa mantém a proporção da sua tela e percorre a borda de cada display da sua orientação, depois da rotação, e cobre no máximo metade do display. Um display da outra orientação mostra só a página, e também um display que a faixa cobriria em mais da metade (a altura num cabeçalho ou rodapé, a largura numa lateral). A barra de alerta de um gatilho de sobreposição é desenhada acima da faixa. Uma campanha ou entrada que não cabe em nenhuma das telas a que se destina é recusada (playlist_format_mismatch); numa tela de um público misto em que não cabe, campaign explain informa region_not_laid_out e a tela mostra a página. Mudar uma playlist para dentro ou para fora de uma região, ou para outra região, é recusado enquanto uma tela, pasta ou campanha a usar.

Instale o aplicativo web do Player

1. 01

   Abra play.screenrig.ai/player/ no dispositivo da tela.

2. 02

   No iOS, use Safari: Compartilhar → Adicionar à Tela Inicial. No Android, use Chrome: Instalar app ou Adicionar à Tela Inicial.

3. 03

   Abra a PWA instalada e siga as instruções de configuração exibidas.

4. 04

   Mantenha a PWA em primeiro plano no dispositivo da tela.

Inicie um navegador de quiosque com a reprodução automática permitida (Chrome --autoplay-policy=no-user-gesture-required, Autoplay Audio do Fully Kiosk) e o aplicativo web do Player reproduz o som na hora; um navegador que recusa o som reproduz o vídeo sem som, e o registro do Player informa isso.

Um Player pareia com a API do seu próprio ambiente: play.screenrig.ai com api.screenrig.ai. Quando a CLI usa outra origem de API, --api-url https://api.DOMAIN, abra https://play.DOMAIN/player/ em vez disso.

Seu agente precisa do plugin oficial para publicar conteúdo no Player.

Aplicativos na rede local

Um aplicativo pode chamar endereços http:// e ws:// na própria rede da tela, como um controlador em http://192.168.1.20. Em um navegador de quiosque, o proprietário do navegador permite isso. No Chrome e no Edge 142 e posteriores, defina a política empresarial LocalNetworkAccessAllowedForUrls como https://play.screenrig.ai: o Player repassa essa permissão aos aplicativos que ele exibe em frames, e endereços IP privados e nomes .local passam a carregar por http e ws, inclusive fetch e imagens. Para outros nomes de host http://, defina também InsecureContentAllowedForUrls como https://play.screenrig.ai, ou escolha Conteúdo não seguro: Permitir nas configurações do site. As duas políticas nomeiam a página do Player, não o endereço do aplicativo. Alcançar dispositivos na rede da tela trata de imagens e CORS.

Quiosque ChromeOS

Dispositivos ChromeOS gerenciados, como Chromebox, Chromebase ou PC ChromeOS Flex, executam o app Player web como app quiosque pelo console Google Admin. O dispositivo inicia direto no Player, mantém em tela cheia e o reinicia se fechar.

1. 01

   No console do Google Admin, abra Dispositivos → Chrome → Apps e extensões → Quiosques e selecione a unidade organizacional para suas telas.

2. 02

   Adicione o app pela URL: o link da frota do seu projeto, ou https://play.screenrig.ai/player/ com a barra final para parear cada dispositivo pelo código.

3. 03

   Defina para auto-iniciar e ative Permitir que o app gerencie energia.

4. 04

   Nas configurações de energia do quiosque do dispositivo, defina a ação ociosa para Não fazer nada, para que a tela nunca escureça ou entre em repouso.

5. 05

   Reinicie o dispositivo. Com um link de frota, o Player entra no seu projeto como uma nova tela por conta própria. Sem ele, mostra seu código de pareamento: forneça o código ao seu agente.

Na sessão do quiosque, o Player lê o número de série do dispositivo e o ID do ativo e local que você anotou no dispositivo no console Admin. Eles aparecem nos detalhes do host da tela no dashboard e em screen show. Quando uma restauração de fábrica ou reinstalação dá ao dispositivo uma nova identidade de Player, o número de série permite que seu agente o reconecte à sua tela existente com screen recover em vez de parear uma nova.

Para a trilha sonora, permita reprodução automática para https://play.screenrig.ai com a política AutoplayAllowlist.

Uma URL para toda a frota

Um link de frota é uma URL do Player que transforma cada dispositivo que a abre em sua própria tela no seu projeto, sem código de pareamento. Peça ao seu agente por um (screenrig fleet-links create), ou crie-o no dashboard em Configurações → Links de frota, e coloque sua URL no app do quiosque na etapa 2. Cada novo dispositivo entra com as tags e playlist do link e recebe seu nome do ID do ativo, depois da localização que você anota nele no console Admin.

Um dispositivo que já é uma tela permanece essa tela através de reinicializações e atualizações. Após uma limpeza total ou reinstalação, ele volta como a mesma tela, uma vez que sua antiga identidade Player ficou silenciosa por dez minutos. Limite um link com um máximo de telas, desligue-o para impedir que novas telas entrem, ou gire-o para substituir uma URL que foi compartilhada amplamente. Telas que um link já criou continuam tocando através dos três. Mantenha a URL no console Admin: ela cria telas no seu projeto.

Energia da tela via RS-232

Conecte a porta de controle RS-232 do monitor ao dispositivo ChromeOS com um adaptador serial USB e conceda o adaptador para https://play.screenrig.ai com a política SerialAllowUsbDevicesForUrls (IDs USB do fornecedor e produto do adaptador) ou SerialAllowAllPortsForUrls. Ao iniciar, o Player encontra um monitor Samsung (MDC), LG, NEC ou Philips (SICP) na porta concedida na taxa padrão de fábrica de 9600 baud e ID do monitor. Em seguida, ele alterna a própria energia, modo de espera e liga do monitor, e informa o estado de energia que o monitor retorna. A lista de capacidades do host da tela inclui Energia do monitor (RS-232).

Links de frota em um gerenciador de dispositivos

A URL de um link de frota (dashboard Configurações → Links de frota ou screenrig fleet-links create) também vai no seu gerenciador de dispositivos:

• Android, Google TV e Amazon Signage Stick. No seu EMM ou gerenciador de dispositivos, defina a chave fleet_link na configuração gerenciada do app (pacote ai.screenrig.player).
• Apple (Mac, Apple TV, iPhone e iPad). No seu MDM, defina a chave fleet_link na configuração de app gerenciada.
• Linux e Raspberry Pi. Coloque a URL no arquivo /etc/screenrig/fleet-link ou adicione --fleet-link URL ao instalador (sh -s -- --kiosk --fleet-link URL).

No Android e na Apple, as chaves opcionais asset_id e location dão nome à nova tela (primeiro o ID do ativo), e serial permite que um dispositivo reinstalado recupere sua tela.

Um dispositivo sem tela entra sozinho no projeto do link. Um dispositivo cujo link não funciona mais (renovado, desativado, cheio ou expirado) mostra seu código de pareamento com uma linha que explica o motivo. Mantenha a URL no gerenciador de dispositivos: ela cria telas no seu projeto.

Um link de frota pode terminar no momento que você escolher: passe --expires-at (por exemplo, 2027-12-31T23:59:59Z) para screenrig fleet-links create ou update, ou preencha o campo Expira no dashboard. Depois desse momento, os novos dispositivos mostram seu código de pareamento, e as telas que o link criou continuam tocando.

Proprietário do dispositivo Android por código QR

Um dispositivo Android 10 ou posterior com câmera, restaurado para as configurações de fábrica, entra em um link de frota sem gerenciador de dispositivos. Abra o link no dashboard (Configurações → Links de frota), escolha Mostrar código QR em Proprietário do dispositivo Android, toque seis vezes na tela de boas-vindas do dispositivo e escaneie o código. O dispositivo baixa o Player gerenciado, confere-o com o certificado de assinatura do código, instala-o como proprietário do dispositivo e entra no projeto do link sem código de pareamento. Depois, o Player roda como o app inicial do dispositivo, em tela cheia, sem barra de navegação, notificações nem tela de bloqueio.

O código contém um payload de provisionamento, e Copiar JSON de provisionamento o copia para um gerenciador de dispositivos que provisiona a partir de JSON. Seu agente imprime o mesmo payload com screenrig fleet-links show ID --android-provisioning (exige um login Manage, porque o payload contém o segredo do link), pronto para codificar como QR code. O payload é assim:

{
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME": "PACKAGE/ai.screenrig.player.managed.ScreenRigDeviceAdminReceiver",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION": "DOWNLOAD_URL",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM": "CHECKSUM",
  "android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED": true,
  "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE": { "fleet_link": "FLEET_LINK_SECRET" }
}

PACKAGE, DOWNLOAD_URL e CHECKSUM vêm da entrada managed de https://screenrig.ai/android/manifest.json: seu package, https://screenrig.ai seguido de seu path e seu signer_sha256 em base64 seguro para URL, sem preenchimento. FLEET_LINK_SECRET é a parte da URL do link depois de #fleet=. O arquivo tem versão e é mantido, e o checksum pertence ao certificado de assinatura, então um código impresso continua funcionando quando um Player mais novo é listado. O código contém o segredo do link: compartilhe-o apenas com a pessoa que configura o dispositivo.

Fontes de navegador (vMix, OBS)

Uma fonte de navegador não guarda armazenamento, então o Player nela perderia o pareamento a cada carregamento. Um link da tela é o endereço de uma única tela: o Player aberto a partir dele é essa tela a cada carregamento, sem guardar nada. Use-o em uma fonte de navegador do vMix ou do OBS, ou em qualquer navegador que apague seus dados.

1. 01

   Pareie a tela uma vez. Abra o app web do Player em qualquer navegador, entregue ao seu agente o código exibido e aguarde até a tela ficar ativa.

2. 02

   Peça ao seu agente o link da tela (screenrig screen link create SCREEN_ID), ou abra a tela no dashboard e escolha Criar link na linha Link da tela da aba Propriedades.

3. 03

   Copie o link: seu agente o imprime com screenrig screen link show SCREEN_ID, ou escolha Copiar link no dashboard. Ele é https://play.screenrig.ai/player/#screen= seguido de um segredo.

4. 04

   Cole-o como a URL da fonte de navegador.

5. 05

   A fonte reproduz a playlist da tela imediatamente, e de novo após cada recarga.

Abra um link da tela em um único lugar. Aberto em dois, é uma tela duas vezes. Várias fontes de navegador em um mesmo navegador, cada uma com seu próprio link, funcionam como telas separadas.

Um link da tela é uma credencial: quem o tem abre essa tela. Se ele vazar, ou se você quiser recuperá-lo, peça o link de novo (screenrig screen link create SCREEN_ID, ou Substituir link): o endereço antigo para de funcionar imediatamente e uma fonte que ainda o exibe mostra um aviso e nenhum conteúdo, sem código de pareamento. Cole o novo endereço e a fonte volta a reproduzir. Desativar link (screenrig screen link delete SCREEN_ID) encerra o link sem criar um novo. O Player próprio da tela, se houver, não é afetado em nenhum dos casos.

Publicidade nas suas telas

O Player que você já usa também é o Player de anúncios: não há nada extra para instalar.

Vender é uma escolha feita por tela, através do mesmo plugin oficial e CLI. Opte por incluir uma tela própria com screenrig ads inventory update scr_LOBBY --enabled e descreva-a publicamente com nome do site, cidade, região, tipo de local e tags de público escolhidas. Defina slots de anúncio reutilizáveis com screenrig ads slots create — mídias aceitas (imagem ou vídeo), as durações máximas de imagem e vídeo, e uma taxa opcional para esse slot. Apenas a definição do slot não altera nada na tela; colocar sua página de slot em uma das suas playlists é o que dá à tela um intervalo real de anúncios, e todas as outras páginas continuam a ser reproduzidas normalmente.

Anúncios pagos exigem um Player que suporte reprodução de adslot. O servidor serve a um Player sem esse suporte apenas a playlist comum, para que a tela reproduza conteúdo da casa e não publicidade paga; um Player capaz solicita preenchimento para cada página de adslot e pula qualquer slot que não possa preencher, mantendo a playlist em movimento. Compradores não pareiam nada — compram do seu inventário através do convite que você envia com screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY.

O plugin, projeto e os passos para a primeira tela estão no Guia de início.

Displays comerciais

Samsung Smart Signage (Tizen) executa o Player nativo screenRIG.

Players BrightSign com OS 9.1 ou superior iniciam automaticamente o Player screenRIG a partir de um cartão SD. Extraia o pacote para a raiz do cartão, insira-o e ligue. O player aplica sua política de hardware e abre o Player screenRIG.

1. 01

   Defina primeiro o relógio e a rede do player. Um relógio errado interrompe a conexão segura.

2. 02

   Extraia para a raiz de um cartão SD FAT32 e insira o cartão.

3. 03

   Liga o player. Ele inicia o pacote e mostra o código de pareamento.

4. 04

   Dê o código ao seu agente.

LG webOS Signage

Displays LG webOS Signage na versão 6.0 ou mais recente (Chromium 79 ou mais recente) executam o Player screenRIG. Um aplicativo instalado inicia ao ligar e o abre. Displays com webOS Signage 4.x ou mais antigo usam um navegador mais antigo do que o Player exige. Baixe os pacotes em screenrig.ai/webos/.

Um display no modo de inicialização de aplicativo Local instala com.lg.app.signage.ipk a partir de um pen drive USB.

1. 01

   Defina primeiro a data, a hora e a rede do display. Um relógio errado interrompe a instalação com “Unknown error” e interrompe a conexão segura.

2. 02

   Em um pen drive USB FAT32, crie na raiz uma pasta chamada application e coloque com.lg.app.signage.ipk nela. Mantenha o nome do arquivo.

3. 03

   Conecte o pen drive ao display. Em Server Settings, defina Application Launch Mode como Local e o tipo como IPK e execute Local Application Upgrade a partir do USB.

4. 04

   Reinicie o display. Ele inicia o aplicativo e mostra o código de pareamento.

5. 05

   Dê o código ao seu agente.

Para instalar pelo menu de aplicativos do display ou por um servidor SI, use ScreenRig-webos.ipk no lugar. Os dois pacotes são aplicativos separados para o display, cada um com seu próprio pareamento, então instale apenas um por display.

Um display que liga antes de a rede ficar pronta mostra a tela do screenRIG e continua tentando até o Player responder. Pressione Info no controle remoto para ver o modelo do display, a versão do navegador e o estado da conexão.

Outros monitores comerciais com navegador HTML5 embutido ou lançador de URL podem abrir play.screenrig.ai/player/ diretamente e seguir os passos do aplicativo web acima. O monitor deve manter a página em primeiro plano e permitir o armazenamento de dados. Android TV e caixas de streaming com navegador completo podem fazer o mesmo: abrir play.screenrig.ai/player/ no navegador da caixa, fornecer o código de pareamento ao seu agente e manter a página em primeiro plano.

Fluxos e imagens de fallback

Use stream para um feed ao vivo e video para um arquivo enviado. Um stream precisa de uma imagem pronta enviada pela mesma conta como fallback. A imagem aparece durante a conexão, se a reprodução travar ou quando o Player não puder receber a fonte.

Preparar um feed

Use uma playlist HTTPS pública HLS sem credenciais embutidas, ou a URL RTSP de uma câmera. Para o Web Player, a playlist, segmentos e chaves devem permitir requisições cross-origin da origem do Player. Vídeo H.264 com áudio AAC é um perfil inicial prático; a decodificação depende do dispositivo. O áudio está mudo por padrão, e as regras de autoplay do navegador ainda se aplicam.

Escolha o horário e o transporte

Use no máximo uma transmissão por página e avanço baseado em duração. Forneça uma ou duas fontes com protocolos diferentes, em ordem de preferência. Uma fonte pode informar apenas sua url: uma URL https é HLS, uma URL rtsp ou rtsps é RTSP. Para multicast, use um grupo IPv4 com escopo administrativo em 239/8 e uma porta UDP; adicione uma alternativa HLS para outros Players. screenRIG não converte multicast em HLS. Transmissões não são armazenadas em cache para reprodução offline; a imagem de fallback é.

Reproduzir uma câmera diretamente

Os Players Android, Amazon e Linux abrem as fontes de câmera rtsp:// diretamente, pela rede do próprio Player, sem relay. Use a URL fornecida pela câmera ou pelo gravador, incluindo as credenciais user:pass@. Linux também abre fontes rtsps://.

Para uma câmera UniFi Protect, ative o RTSP de um canal nas configurações do Protect da câmera e copie a URL. Android e Amazon convertem a URL rtsps:// do Protect na porta 7441 para rtsp:// sem criptografia na porta 7447, removendo enableSrtp. O Player precisa acessar a porta 7447 do console do Protect; essa conexão não usa TLS nem SRTP. Para outras fontes RTSPS criptografadas no Android e na Amazon, use uma alternativa HLS ou a imagem de fallback. Outros Players reproduzem a alternativa HLS ou mostram a imagem de fallback.

Ativar recepção multicast

No Android, abra o menu do operador, escolha Configurações e ative streams Multicast; está desativado por padrão. No Qt, ative SCREENRIG_ENABLE_MULTICAST=1 no ambiente de lançamento do Player e verifique --capabilities-json. A rede deve transportar o grupo multicast e porta selecionados. Esta versão não fornece DRM, RTP, cabeçalhos de autenticação personalizados ou transcodificação de stream.

Trilhas sonoras

Uma trilha sonora de playlist toca em todo Player. O Player baixa e verifica cada faixa MP3 junto com o resto da playlist, então toca as faixas em ordem enquanto as páginas mudam. Transições de página nunca param ou reiniciam a música, e a trilha sonora continua tocando offline a partir das faixas em cache. Uma trilha sonora com indicação (cued: true) toca uma faixa apenas quando uma indicação de página a inicia e fica silenciosa após o fim dessa faixa até a próxima indicação. Uma página cujo advance é audio_end termina quando sua faixa indicada termina; se o Player não puder tocar a faixa, a página dura o tempo da faixa.

Quando o agente republica a playlist, a faixa atual continua tocando se ainda estiver na nova trilha sonora. O volume da trilha sonora é multiplicado pelo volume do Player, então a configuração de volume do operador ou o controle de volume do display ainda decidem o quão alto a tela fica.

Navegadores podem bloquear o som até que alguém interaja com a página. O player no aplicativo web continua exibindo páginas e inicia a trilha sonora no primeiro toque ou pressionamento de tecla. Para um navegador de quiosque sem supervisão, permita a reprodução automática com som; no Chromium, inicie com --autoplay-policy=no-user-gesture-required; em um ChromeOS quiosque, defina a política AutoplayAllowlist. Players nativos não precisam de configuração.

Saúde do dispositivo e controle do monitor

Cada Player reporta a saúde do dispositivo a cada quinze minutos, e imediatamente quando sua conexão de exibição ou energia muda. Declara os controles de dispositivo que suporta: reinicialização remota e os métodos de energia da exibição que pode usar. O que um Player pode ler e alternar depende da plataforma e de como o dispositivo está configurado.

As capacidades reais de cada tela aparecem em screen show como suas capacidades do host, ao lado do seu último relatório de integridade, para que o agente saiba antes de agir se aquela tela pode reiniciar ou trocar seu monitor. A tabela mostra o que cada player pode fazer.

Ações remotas

Mais três controles de dispositivo chegam a um Player como comandos: limpar seus caches, reiniciar seu aplicativo (não o dispositivo) e atualizá-lo para a versão mais recente. Um Player declara clear_cache, restart_app ou update em suas capacidades de host somente onde o comportamento funciona nesse dispositivo, de modo que screen show informa o agente antes de agir; uma tela cujo Player não declara a capacidade responde command_unsupported e nada é enviado. Limpar o cache mantém o pareamento e as configurações e reabastece o conteúdo a partir do manifesto. Cada comando é listado em commands em screen show, done ou failed com a causa que o Player reporta.

Escurecimento por inatividade, brilho automático e bloqueio de quiosque

Três configurações de tela controlam a tela diretamente no dispositivo. Um Player aplica uma delas quando screen show lista a sua capacidade do host (display_power.idle, brightness.auto ou kiosk_lock); a configuração é armazenada de qualquer forma.

• Escurecer por inatividade. Após 30 a 86400 segundos sem um toque ou tecla ou, quando presence é um evento de despertar, sem ninguém na frente da tela, a tela escurece e a reprodução pausa. Um touch ou presence, conforme você escolher, a acende de novo; o toque que acorda uma tela escura não vai além. Presence lê a câmera do dispositivo no próprio dispositivo, e nenhuma imagem sai dele. Uma programação de exibição ou substituição que mantém o display desligado prevalece.
• Brilho automático. auto define o brilho a partir do sensor de luz do dispositivo; fixed, o padrão, mantém o brilho do operador. Um dispositivo declara brightness.auto somente quando tem um sensor de luz.
• Bloqueio de quiosque. O Player Android se fixa na tela com a fixação de tela (screen pinning), sem precisar de proprietário do dispositivo. A pessoa na tela confirma na primeira vez, e a barra de status, o início e os recentes ficam bloqueados enquanto a fixação durar.

Seu agente os define com screen display-idle, screen brightness e screen kiosk-lock. A aba Propriedades da página da tela no dashboard tem as mesmas três em Configurações do dispositivo.

Visualização ao vivo

A visualização ao vivo mostra no dashboard, em vídeo, o que uma tela exibe, e screenrig screen live frame salva quadros JPEG dela para um agente que só tem HTTPS. O player Android (Google Play e Amazon Signage Stick), Linux e Raspberry Pi a publicam, e uma tela que consegue lista a capacidade do host live_view em screen show. No Android, alguém na tela autoriza a captura de tela uma única vez a cada início do player. Uma sessão ao vivo termina sozinha quando o prazo acaba; inicie-a de novo para continuar assistindo.

Controlar uma tela no dispositivo

Uma vez que a tela está pareada, pressione OK no controle remoto para abrir seu menu do operador. A primeira tela do menu contém:

• Nome da tela. Selecione para renomear a tela.
• Playlist. Sua dica é a playlist que a tela está reproduzindo. Selecione-a ou pressione Direita para listar todas as playlists do projeto em ordem alfabética e escolha uma para mudar a tela para ela. Um takeover, uma campanha ou uma programação de playlist ainda decide o que toca; a dica sempre indica o que está tocando.
• Página. Sua dica é o nome da página que está sendo exibida; o nome da página é seu identificador. O menu abre nesta linha. Pressione Esquerda ou Direita para ir para a página anterior ou próxima, ou selecione para listar as páginas da playlist na ordem de reprodução e escolher uma para pular. A página escolhida começa do início.
• Configurações. Brilho, volume e reset, e no Android recepção multicast e inicialização automática.
• Sair das configurações fecha o menu de qualquer tela.

Voltar, ou Esquerda em uma lista, retorna à tela anterior. O menu fecha sozinho após 60 segundos sem entrada.

Pausar e retomar

Pressione Play/Pause no controle remoto (K no Windows) para pausar a tela; o chip Pausado aparece. Uma tela pausada mantém seu temporizador de página, o vídeo da página e a trilha sonora. Pressione o botão novamente e tudo continua de onde parou: uma página configurada para mostrar por 20 segundos, pausada em 10 segundos, mostra os 10 segundos restantes, e a música retoma do mesmo ponto em vez de recomeçar. Mover para a próxima ou anterior página, ou escolher uma no menu, mantém a pausa: a nova página espera no início até você retomar. Cartões, páginas web e transmissões ao vivo continuam rodando enquanto pausados. Uma pausa termina sozinha após 60 minutos.

Verifique sua primeira tela

Dê ao seu agente a tela pretendida e peça para publicar uma mensagem simples de boas-vindas. Peça uma captura de tela quando o Player estiver exibindo.

Se a tela estiver ausente da lista do agente, confirme que o Player está aberto e sua configuração está completa. Se o conteúdo não atualizar, verifique a conexão do dispositivo e peça ao agente para inspecionar o estado da tela e evidências de reprodução.

Um chip na tela, ou um código em screen show, é explicado em Códigos de status do Player.

Uma vez que a tela está pareada, seu menu do operador nomeia a tela e mostra sua playlist e página.

Continuar com o fluxo de trabalho do agente.