Códigos de status do Player

Onde os códigos aparecem

Um chip é um ícone no canto inferior esquerdo da tela, com uma mensagem de uma linha quando aparece pela primeira vez. O Player mostra a condição ativa de maior prioridade e mantém o chip enquanto a condição persistir. O dashboard mostra o chip ao lado do estado online da tela.

screenrig screen show scr_ID retorna o que o Player reportou:

Um chip é o último relatório do Player: leia-o como desatualizado enquanto online for falso. Relatórios como player.video_unusable e player.card_failed vão para o log do Player da tela:

screenrig events list --source log --screen-id scr_ID

Chips de status

A tabela segue a ordem de prioridade: quando várias condições se aplicam, a primeira é exibida. O rótulo é o nome do chip no dashboard.

Atualização do Player necessária é um aviso ao lado do chip, não um chip. Aparece quando a versão do Player está abaixo do mínimo que o screenRIG suporta, e o Player continua reproduzindo o conteúdo salvo. Atualize o Player com screenrig screen update-software scr_ID onde ele declara update; caso contrário, pela loja de aplicativos ou pelo gerenciador de dispositivos.

Vídeo que não reproduz

Um Player decodifica vídeo com o decodificador de hardware do dispositivo para o codec, o perfil e a resolução do arquivo. Quando o dispositivo não consegue, o Player pula o item: o chip é decode_miss, ou decode_unplayable quando não há mais nada na tela. O registro player.video_unusable no log do Player nomeia o campo code (video_load_failed, video_play_failed, video_autoplay_blocked, video_stalled, image_load_failed, video_prepare_failed, video_first_frame_timeout ou video_decode_failed) com decoder, codecs, width e height medidos pelo Player.

screenrig media upload ./lobby-loop.mp4 --codec hevc
screenrig media upload ./lobby-loop.mp4 --preset signage-1080p30

Um vídeo é enviado como H.264 por padrão. Um Raspberry Pi 5 não tem decodificador de H.264: envie todo vídeo para ele com --codec hevc, em qualquer tamanho. Um Raspberry Pi 4 reproduz 1080p, e --preset signage-1080p30 limita o tamanho. Use hevc somente quando todas as telas que reproduzem o clipe forem Players nativos. Substitua a mídia na playlist e publique a playlist novamente.

Atribuir uma playlist cujos vídeos são todos H.264 a uma tela cujo Player declara video.h264_unavailable é recusado com invalid_request. Em conteúdo misto, esse Player pula os itens H.264.

Falhas de página e de atualização

Uma página que não fica pronta é pulada, e o Player continua reproduzindo as outras páginas. Ele reporta a falha, e last_page_failure.code é o código próprio do Player. screenrig events list --type playback.page_failed --screen-id scr_ID os lista.

manifest_upgrade.state indica como está a atualização de conteúdo:

manifest_upgrade.code indica a causa de um estado retrying, failed, blocked ou partial:

Cache e armazenamento

Antes de baixar uma revisão, um Player planeja seu armazenamento: quais arquivos de páginas cabem no espaço que ele pode usar. Um Player nativo deixa 128 MiB do volume livres e permanece dentro de qualquer cota definida para ele. Ao iniciar, um Player com menos de 512 MiB livres mostra uma mensagem com o espaço livre; essa mensagem não é um chip.

storage.plan.fit em screen show indica como a playlist cabe:

manifest_upgrade.code repete o plano: none_fit ou transition_blocked para uma atualização blocked, capacity para uma atualização partial cujas páginas não couberam, staged para uma atualização partial que ainda está sendo preenchida, e storage_full quando uma gravação falha. storage_shortfall está presente enquanto fit for partial, transition_blocked ou none_fit.

Cada entrada de excluded_pages tem um campo reason:

Consulte antes de atribuir uma playlist grande:

screenrig screen storage-forecast scr_ID --playlist-id pl_ID

Ele responde fits, partial, none_fit ou unknown, com os bytes de que a playlist precisa e a capacidade do Player. unknown significa que a tela nunca reportou armazenamento. Um relatório com mais de 24 horas é marcado como desatualizado. O comando não grava nada. Quando uma falha de armazenamento aparece, a resposta traz um aviso storage_full: libere armazenamento no dispositivo que executa o Player e tente a playlist novamente.

Cartões

Um cartão que não consegue ser desenhado deixa seu retângulo vazio, e a página segue sendo reproduzida. O Player registra card.failed, e os Players web, Android e Windows reportam player.card_failed uma vez para cada cartão em uma página e código, com page_id, primitive_id, manifest_revision e o code. Um cartão cujos dados expiraram também fica em branco: screenrig card data put --ttl 30m o renova.