播放器状态码

代码出现的位置

状态图标是屏幕左下角的一个图标，首次出现时附带一行消息。播放器显示排名最高的活动状况，并在该状况持续期间保留状态图标。控制台在屏幕的在线状态旁显示该状态图标。

screenrig screen show scr_ID 返回播放器报告的内容：

状态图标是播放器的最后一次报告：online 为 false 时应视为已过期。player.video_unusable 和 player.card_failed 等报告会写入屏幕的播放器日志：

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

状态图标

表格按排名顺序排列：多个状况同时成立时，显示第一个。标签是该状态图标在控制台中的名称。

需要更新播放器是状态图标旁的提示，不是状态图标。当播放器版本低于 screenRIG 支持的最低版本时显示，播放器会继续播放其已保存的内容。播放器声明 update 时用 screenrig screen update-software scr_ID 更新，否则通过其应用商店或设备管理器更新。

无法播放的视频

播放器使用设备的硬件解码器，按文件的编解码器、配置文件和分辨率解码视频。设备无法解码时，播放器会跳过该项：状态图标为 decode_miss；屏幕上没有其他内容时为 decode_unplayable。播放器日志中的 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），并附上播放器测得的 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。替换播放列表中的媒体并重新发布。

将视频全为 H.264 的播放列表分配给播放器声明 video.h264_unavailable 的屏幕时，会被拒绝并返回 invalid_request。在混合内容中，该播放器会跳过 H.264 项目。

页面与更新失败

无法准备就绪的页面会被跳过，播放器继续播放其他页面。播放器会报告该失败，last_page_failure.code 是播放器自己的代码。screenrig events list --type playback.page_failed --screen-id scr_ID 会列出这些代码。

manifest_upgrade.state 说明内容更新进展如何：

manifest_upgrade.code 指出 retrying、failed、blocked 或 partial 状态的原因：

缓存与存储

下载修订之前，播放器会规划其存储：哪些页面的文件能放进它可使用的空间。原生播放器会在其存储卷上保留 128 MiB 空闲空间，并且不超出为其设置的任何配额。启动时，可用空间不足 512 MiB 的播放器会显示一条带有剩余空间的消息；该消息不是状态图标。

screen show 中的 storage.plan.fit 说明播放列表如何放入存储：

manifest_upgrade.code 重复该计划：blocked 更新时为 none_fit 或 transition_blocked，页面放不下的 partial 更新为 capacity，仍在填充的 partial 更新为 staged，写入失败时为 storage_full。fit 为 partial、transition_blocked 或 none_fit 时存在 storage_shortfall。

excluded_pages 的每个条目都有一个 reason：

分配大型播放列表之前先查询：

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

它返回 fits、partial、none_fit 或 unknown，并附上播放列表所需的字节数和播放器的容量。unknown 表示该屏幕从未报告过存储情况。超过 24 小时的报告会标记为已过期。该命令不写入任何内容。出现存储失败时，返回结果会带有 storage_full 警告：请释放运行播放器的设备上的存储空间，然后重试该播放列表。

卡片

无法绘制的卡片会让其矩形区域留空，页面继续播放。播放器记录 card.failed；Web、Android 和 Windows 播放器会针对页面上的每张卡片和每个代码各报告一次 player.card_failed，附带 page_id、primitive_id、manifest_revision 和 code。数据已过期的卡片同样为空白：screenrig card data put --ttl 30m 可刷新它。