Player-Statuscodes

Wo die Codes erscheinen

Ein Chip ist ein Symbol in der unteren linken Ecke des Bildschirms, das beim ersten Erscheinen von einer einzeiligen Meldung begleitet wird. Der Player zeigt den ranghöchsten aktiven Zustand an und behält den Chip, solange der Zustand besteht. Das Dashboard zeigt den Chip neben dem Online-Status des Bildschirms an.

screenrig screen show scr_ID gibt zurück, was der Player gemeldet hat:

Ein Chip ist die letzte Meldung des Players: Betrachten Sie ihn als veraltet, solange online false ist. Meldungen wie player.video_unusable und player.card_failed gehen an das Player-Protokoll des Bildschirms:

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

Status-Chips

Die Tabelle ist nach Rang geordnet: Treffen mehrere Zustände zu, wird der erste angezeigt. Das Label ist der Name des Chips im Dashboard.

Player-Update erforderlich ist ein Hinweis neben dem Chip, kein Chip. Er erscheint, wenn die Version des Players unter dem von screenRIG unterstützten Minimum liegt; der Player spielt seine gespeicherten Inhalte weiter. Aktualisieren Sie den Player mit screenrig screen update-software scr_ID, wenn er update deklariert, andernfalls über seinen Store oder die Geräteverwaltung.

Video, das nicht abgespielt wird

Ein Player dekodiert Video mit dem Hardware-Decoder des Geräts für Codec, Profil und Auflösung der Datei. Kann das Gerät das nicht, überspringt der Player den Eintrag: Der Chip lautet decode_miss, oder decode_unplayable, wenn sonst nichts auf dem Bildschirm ist. Der Eintrag player.video_unusable im Player-Protokoll nennt den code (video_load_failed, video_play_failed, video_autoplay_blocked, video_stalled, image_load_failed, video_prepare_failed, video_first_frame_timeout oder video_decode_failed) mit decoder, codecs, width und height, die der Player gemessen hat.

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

Ein Video wird standardmäßig als H.264 hochgeladen. Ein Raspberry Pi 5 hat keinen H.264-Decoder: Laden Sie jedes Video dafür mit --codec hevc hoch, in jeder Größe. Ein Raspberry Pi 4 spielt 1080p ab, und --preset signage-1080p30 begrenzt die Größe. Verwenden Sie hevc nur, wenn auf jedem Bildschirm, der den Clip abspielt, ein nativer Player läuft. Ersetzen Sie das Medium in der Playlist und veröffentlichen Sie die Playlist erneut.

Das Zuweisen einer Playlist, deren Videos alle H.264 sind, an einen Bildschirm, dessen Player video.h264_unavailable deklariert, wird mit invalid_request abgelehnt. Bei gemischten Inhalten überspringt dieser Player die H.264-Einträge.

Seiten- und Update-Fehler

Eine Seite, die nicht bereit werden kann, wird übersprungen, und der Player spielt seine anderen Seiten weiter. Er meldet den Fehler, und last_page_failure.code ist der eigene Code des Players. screenrig events list --type playback.page_failed --screen-id scr_ID listet sie auf.

manifest_upgrade.state zeigt, wie ein Inhaltsupdate verläuft:

manifest_upgrade.code nennt die Ursache eines Zustands retrying, failed, blocked oder partial:

Cache und Speicher

Bevor ein Player eine Revision herunterlädt, plant er seinen Speicher: Dateien welcher Seiten in den Platz passen, den er nutzen darf. Ein nativer Player lässt 128 MiB seines Datenträgers frei und bleibt innerhalb eines gegebenenfalls für ihn festgelegten Kontingents. Beim Start zeigt ein Player mit weniger als 512 MiB freiem Speicherplatz eine Meldung mit dem freien Speicherplatz an; diese Meldung ist kein Chip.

storage.plan.fit in screen show gibt an, wie die Playlist in den Speicher passt:

manifest_upgrade.code wiederholt den Plan: none_fit oder transition_blocked bei einem Update im Zustand blocked, capacity bei einem Update im Zustand partial, dessen Seiten nicht gepasst haben, staged bei einem Update im Zustand partial, das noch befüllt wird, und storage_full, wenn ein Schreibvorgang fehlschlägt. storage_shortfall ist vorhanden, solange fit den Wert partial, transition_blocked oder none_fit hat.

Jeder Eintrag von excluded_pages enthält das Feld reason:

Fragen Sie nach, bevor Sie eine große Playlist zuweisen:

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

Die Antwort lautet fits, partial, none_fit oder unknown, mit den Bytes, die die Playlist benötigt, und der Kapazität des Players. unknown bedeutet, dass der Bildschirm nie Speicher gemeldet hat. Eine Meldung, die älter als 24 Stunden ist, wird als veraltet markiert. Der Befehl schreibt nichts. Wenn ein Speicherfehler angezeigt wird, enthält die Antwort eine Warnung storage_full: Geben Sie Speicher auf dem Gerät frei, auf dem der Player läuft, und versuchen Sie es dann erneut mit der Playlist.

Karten

Eine Karte, die nicht gezeichnet werden kann, lässt ihr Rechteck leer, und die Seite wird weiter abgespielt. Der Player protokolliert card.failed, und die Web-, Android- und Windows-Player melden player.card_failed einmal pro Karte und Code auf einer Seite, mit page_id, primitive_id, manifest_revision und dem code. Auch eine Karte, deren Daten abgelaufen sind, bleibt leer: screenrig card data put --ttl 30m erneuert sie.