Playerステータスコード

コードが表示される場所

チップは、画面の左下隅に表示されるアイコンで、最初に表示されたときは1行のメッセージが付きます。Playerは、有効な状態のうち最も順位の高いものを表示し、その状態が続く間はチップを保持します。ダッシュボードでは、スクリーンのオンライン状態の横にチップが表示されます。

screenrig screen show scr_ID は、Playerが報告した内容を返します：

チップはPlayerの最後の報告です。online が false の間は、古い情報として読んでください。player.video_unusable や player.card_failed などの報告は、スクリーンのPlayerログに送られます：

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

ステータスチップ

表は順位順に並んでいます。複数の状態が当てはまる場合は、最初のものが表示されます。ラベルは、ダッシュボードでのチップの名前です。

プレーヤーの更新が必要は、チップではなく、チップの横に表示される通知です。Playerのバージョンが screenRIG のサポートする最小バージョンを下回ると表示され、Playerは保存済みのコンテンツを再生し続けます。Playerが update を宣言している場合は screenrig screen update-software scr_ID で更新し、そうでない場合はストアまたはデバイス管理ツールから更新します。

再生できない動画

Playerは、ファイルのコーデック、プロファイル、解像度に対応するデバイスのハードウェアデコーダーで動画をデコードします。デバイスが対応できない場合、Playerはその項目をスキップします。チップは decode_miss で、ほかに何も表示されていないときは decode_unplayable です。Playerログの player.video_unusable レコードには、code（video_load_failed、video_play_failed、video_autoplay_blocked、video_stalled、image_load_failed、video_prepare_failed、video_first_frame_timeout、video_decode_failed のいずれか）と、Playerが測定した decoder、codecs、width、height が記録されます。

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

動画は、デフォルトで H.264 としてアップロードされます。Raspberry Pi 5 には H.264 デコーダーがありません。この機種で再生する動画は、サイズを問わずすべて --codec hevc でアップロードしてください。Raspberry Pi 4 は 1080p を再生でき、--preset signage-1080p30 でサイズを制限できます。hevc は、そのクリップを再生するすべてのスクリーンがネイティブPlayerの場合にのみ使用してください。プレイリスト内のメディアを差し替えて、もう一度公開してください。

動画がすべて H.264 のプレイリストを、Playerが video.h264_unavailable を宣言しているスクリーンに割り当てると、invalid_request で拒否されます。動画が混在するコンテンツでは、そのPlayerは H.264 の項目をスキップします。

ページと更新の失敗

準備できないページはスキップされ、Playerは他のページの再生を続けます。Playerは失敗を報告し、last_page_failure.code はPlayer独自のコードです。screenrig events list --type playback.page_failed --screen-id scr_ID でそれらを一覧表示できます。

manifest_upgrade.state は、コンテンツ更新の進み具合を示します：

manifest_upgrade.code は、retrying、failed、blocked、partial のいずれかの状態の原因を示します：

キャッシュとストレージ

Playerはリビジョンをダウンロードする前に、ストレージを計画します。つまり、使用できる容量にどのページのファイルが収まるかを判断します。ネイティブPlayerは、ボリュームの 128 MiB を空けたままにし、設定されたクォータの範囲内に収まります。起動時に空き容量が 512 MiB 未満のPlayerは、空き容量を示すメッセージを表示します。このメッセージはチップではありません。

screen show の storage.plan.fit は、プレイリストがどのように収まるかを示します：

manifest_upgrade.code はストレージ計画をそのまま示します。blocked の更新では none_fit または transition_blocked、収まらなかったページがある partial の更新では capacity、まだ取り込み中の partial の更新では staged、書き込みに失敗したときは storage_full です。storage_shortfall は、fit が partial、transition_blocked、none_fit のいずれかの間だけ存在します。

excluded_pages の各エントリには reason があります：

大きなプレイリストを割り当てる前に、事前に確認してください：

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

回答は fits、partial、none_fit、unknown のいずれかで、プレイリストに必要なバイト数とPlayerの容量が添えられます。unknown は、スクリーンがストレージを一度も報告していないことを意味します。24時間より古い報告は古い情報とみなされます。このコマンドは何も書き込みません。ストレージの失敗が表示されている場合、回答には storage_full 警告が含まれます。Playerを実行しているデバイスのストレージを空けてから、プレイリストをもう一度試してください。

カード

描画できないカードは、その矩形を空のままにし、ページは再生を続けます。Playerは card.failed をログに記録し、Web、Android、Windows のPlayerは、ページ上のカードとコードの組み合わせごとに1回、page_id、primitive_id、manifest_revision と code を添えて player.card_failed を報告します。データの有効期限が切れたカードも空白になります。screenrig card data put --ttl 30m で更新できます。