做数字标牌应该买哪款 Raspberry Pi？
如果屏幕要播放视频，买 Pi 5；如果显示 1080p 的图片、文字看板和现成应用，买 Pi 4。两者运行同一个播放器。
| Raspberry Pi 5 | Raspberry Pi 4 | |
|---|---|---|
| 视频 | 硬件解码 HEVC (H.265)，最高 4K、60 帧每秒 | 1080p |
| 你的智能体上传什么 | 每个视频都转为 HEVC，无论尺寸。Pi 5 没有 H.264 解码器 | 1080p 视频 |
| 视频墙 | 两块显示屏组成一面视频墙 | 用 Pi 5 做视频墙 |
| 电源 | 27 W USB-C 电源（5 V，5 A） | 15 W USB-C 电源（5 V，3 A） |
| 适用于 | 4K 屏幕、视频循环和双屏视频墙 | 1080p 屏幕、图片和文字看板，或你已有的 Pi 4 |
图片、网页、HLS 直播流和 200 多款现成应用在两者上都能运行，所以区别在于视频。4K 视频在 1080p 显示屏上也能播放，所以请让显示屏保持它自己选择的分辨率。HEVC 适用于运行播放器应用的屏幕，不适用于所有网页浏览器。Pi 官方页面（Pi 5、Pi 4）列出了电源规格。
上传命令默认使用 H.264，所以 Pi 5 的视频需要 --codec hevc，或者用一句话告诉你的智能体这段视频是给 Pi 5 用的。该命令会让每条边不超过 3840 像素，并以恒定的每秒 30 帧编码，所以 4K 源文件会以每秒 30 帧的 4K 到达。只有在所有要播放该视频的屏幕都运行原生播放器时才使用 HEVC。要查看播放器在某台 Pi 上支持什么，请在它上面运行 screenrig-player --capabilities-json。
还需要买什么？
- 电源。请使用对应型号的官方电源：Pi 5 为 27 W，Pi 4 为 15 W。Pi 官方页面警告，电源功率不足可能引发问题。
- 一张 microSD 卡。Lite 镜像至少需要 8 GB，Pi 的指南建议留出更多增长空间。请买 32 GB 或更大的，因为这张卡还要保存你发布的媒体：按定价页面的估算，一段 2 分钟的高清视频约占 75 MB。
- 如果你需要，可以用 SSD。Pi 5 可以通过单独的转接板从 M.2 SSD 启动并运行。下面的安装步骤在 SD 卡和 SSD 上都一样。
- 一根 micro-HDMI 转 HDMI 线，以及一台支持 HDMI 的显示屏。
- 带散热片或风扇的外壳。播放器会报告 Pi 的温度，你的智能体可以读取，智能体的屏幕列表会把达到 80 °C 或更高的 Pi 标记为过热。
- 网络。以太网或 Wi-Fi，用于配对和首次下载你的内容。
从空白卡到配对码
- 写入镜像。把 trixie 版本的 64 位 Lite 镜像写入存储卡。32 位镜像或较旧的 bookworm 版本无法运行播放器，安装程序会检查。
- 让 Pi 接入你的网络启动，接上键盘和显示器，或者按下一节的方法通过 SSH。
补充 Lite 镜像缺少的内容。下载页面列出了自助终端安装所需的软件包：
终端 sudo apt install cage ca-certificates fonts-noto-core libgl1-mesa-dri libegl1 pipewire-audio使用专用屏幕选项运行安装命令，命令来自下载页面：
终端 curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk- 重启 Pi。它会启动进入播放器，播放器会显示一个供你的智能体使用的代码。
安装程序会选择 64 位 ARM 版本，对照已发布的校验和检查它，并将其安装到 /opt/screenrig-player。专用屏幕选项会添加一个 systemd 服务，在开机时于 cage（一个精简的自助终端合成器）中启动播放器。桌面版的会话已经具备播放器所需的一切：不使用专用屏幕选项进行安装，然后从菜单启动播放器。
然后把代码读给你的智能体：
- 你
接待处后面的 Pi 显示一个代码 ABC 234。配对它，命名为 Reception Pi，并把今天的访客欢迎页放上去。
- 智能体
已配对。Reception Pi 现在显示访客欢迎页，我检查了截图来确认。
要升级，请使用相同的选项再运行一次安装命令。配对和显示设置会保留。
没有键盘时，如何通过 SSH 设置 Pi？
Lite 镜像没有桌面，所以第一次设置可以在你的笔记本电脑上完成。写入存储卡时打开 SSH：写卡工具的自定义设置中有用户名、密码、你的 Wi-Fi 信息和 SSH 开关。当前的镜像没有需要去查的默认密码，因为用户和密码由你在那里设定。如果不用该工具，请按Pi 入门指南的说明，在存储卡的启动分区上放一个名为 ssh 的空文件，以及一个内容为 username:encrypted-password 的 userconf.txt 文件。然后连接并安装：
ssh -l USER HOSTNAME.local
sudo apt install cage ca-certificates fonts-noto-core libgl1-mesa-dri libegl1 pipewire-audio
curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk重启 Pi，播放器会在显示屏上显示它的代码。要省去代码，请在安装命令中加入设备群链接（--kiosk --fleet-link URL），Pi 就会自行加入你的项目。
为已在运行的 Pi 打开 SSH
Raspberry Pi OS 默认关闭 SSH 服务器。在你已经能访问的 Pi 上，运行 sudo raspi-config，选择 Interfacing Options（有些版本称为 Interface Options），然后选择 SSH，再选择 Yes，完成即可。在桌面版上，控制中心的 Interfaces 标签页有同样的开关。全新安装的 Raspberry Pi OS 主机名为 raspberrypi，所以除非你选了别的主机名，否则 ssh -l USER raspberrypi.local 能找到它。Pi 的远程访问指南列出了每种途径。
Pi 如何直接启动进入播放器？
使用专用屏幕选项时，Pi 通电即启动播放器，没有桌面，没有登录，也无需点击任何东西。如果播放器退出，服务会重新启动它，断电后 Pi 会重新启动回到屏幕。你的智能体还可以重启 Pi、清除播放器的缓存、重启播放器或更新它，并在显示器和线缆允许的情况下，通过 HDMI-CEC、DDC/CI 或面板背光关闭和开启显示器。更新需要一个保留了更新通道的安装。播放器指南列出了 Pi 报告和控制的内容。
- 你
接待处后面的 Pi 看起来冻结了。重启它。
- 智能体
已重启。Reception Pi 已恢复并正在播放，我检查了截图来确认。
使用 --kiosk 安装后，重启可以到达 Pi。重启、清除缓存、重启应用和更新命令共用每块屏幕每 10 分钟 2 次的限额，所以反复重试的循环不会让 Pi 不断重启。离线的 Pi 会挂起重启，默认保留 24 小时，等它重新上线时执行。
Raspberry Pi 标牌能离线播放吗？
可以。播放器只下载一次你的内容，并从 Pi 自身的存储中播放，所以视频不会卡顿缓冲，断网也不会让已经下载好的播放列表停止。配对和首次下载需要网络。使用专用屏幕选项时，Pi 在断电后还会直接重新启动回到播放器，播放器若退出也会重新启动。
Raspberry Pi 5 能驱动视频墙吗？
可以，两块显示屏。一台 Pi 5 用一个播放器把两块显示屏驱动成一面视频墙，需要专用屏幕安装方式外加一个额外的软件包：
sudo apt install wlr-randr你的智能体指定每块显示屏的输出（例如 HDMI-A-1）和顺序，随后每块显示屏会显示自己的编号 20 秒，方便你核对。两块显示屏排成一行是一个 3840 × 1080 的页面，你的智能体会按这个形状构建播放列表。视频墙从 Plus 起提供，参见定价。
- 你
接待处有两块显示屏接在同一台 Pi 5 上，并排放置。把它们做成一面视频墙，并让欢迎视频横跨两块。
- 智能体
完成。两块显示屏现在是一面视频墙，从左到右排列，欢迎视频横跨两块。我检查了截图来确认。
Linux 页面有详细信息，一台电脑能驱动的显示屏数量取决于它的图形输出，最多十二块。
竖屏：楼宇导览牌
Pi 也可以驱动竖屏。播放器会告诉你的智能体屏幕有多大，因此页面会做成适合它的尺寸。
- 你
这块屏幕是竖着安装的。构建一个导览牌：一层是接待处，然后是 Harbor Dental（1 楼，104 室）、Northpoint Physio（1 楼，112）、Alder & Finch（2 楼，205）、Studio Marlow（2 楼，210）、Tidewater Insurance（3 楼，301）和 Cedar Legal（3 楼，318）。加一条说明：电梯在接待处旁边。
- 智能体
完成。屏幕报告的是竖向显示，所以我把导览牌做成了这个形状。它列出全部七家，按楼层排序，底部附有关于电梯的说明。
导视页面在同一块屏幕上增加了带步行时间的箭头、楼层地图和房间看板。
如何通过智能体管理大量 Raspberry Pi？
要设置不止一台 Pi？向你的智能体要一个设备群链接，加到每次安装中，每台 Pi 都会自行加入你的项目，无需读出代码。位于同一个 IPv4 子网、播放同一个播放列表的 Pi 还会让它们的翻页保持一致：每个播放器通过 UDP 端口 49817 广播一个小信标，并在切换到下一页之前最多增加 40 毫秒的等待。这需要至少一秒的固定页面时长和直切转场，而且它对齐的是翻页，不是视频帧。播放器指南有详细说明。
- 你
我要在八个店面橱窗后面各放一台 Pi。给我做一个大家都能用来加入的链接，这样我就不用读八个代码了。
- 智能体
完成。在每台 Pi 上安装播放器时加入这个链接，它就会自行加入你的项目。请把链接保密，因为拿到它的任何人都可以添加屏幕。最后一台 Pi 加入后，你可以把它关闭。
把链接放进安装命令（--kiosk --fleet-link URL）或文件 /etc/screenrig/fleet-link 中。播放器指南介绍了如何限制链接的使用次数、关闭和替换它。所有 Pi 加入后，按地点给它们打标签：一次请求就能更改所有带该标签的 Pi。
- 你
给八台橱窗里的 Pi 打上“橱窗”标签，并让它们全部播放春季促销。
- 智能体
完成。八台 Pi 都带有“橱窗”标签，并正在播放春季促销。我检查了其中两台的截图。
远程关注 Pi 的状态
Pi 每十五分钟报告一次设备和播放器的运行时间、温度、内存、CPU 负载、网络和 Wi-Fi 信号、显示器是否连接以及任何崩溃，显示器连接或电源变化时则立即报告。你的智能体会读取这些信息，控制台的实时视图显示 Pi 正在播放什么。
阈值是固定的，所以你知道每个标记的含义。屏幕列表将达到 80 °C 或更高的 Pi 标为过热，24 小时内崩溃 3 次或以上标为频繁崩溃，显示器断开时标为显示器已断开，35 分钟没有收到报告时标为数据过期。Pi 在 60 秒没有连接后才算离线，所以快速重连不会留下标记。黑屏和冻结画面检测以及电子邮件和 webhook 警报包含在每个套餐中，因此离线的 Pi 或冻结的屏幕都会通知到你。
Raspberry Pi 数字标牌常见问题
哪些数字标牌软件可以在 Raspberry Pi 上运行？
screenRIG 播放器可在装有 trixie 版本的 64 位 Lite 或桌面镜像的 Pi 5 或 Pi 4 上运行。Pi 只运行播放器，你的内容、排程和屏幕都在云端的项目中，所以 Pi 上没有需要安装的标牌服务器。自托管应用把内容和控制保留在 Pi 或你自己运行的服务器上；免费数字标牌软件比较涵盖了这两种类型。
哪款 Raspberry Pi 最适合做数字标牌？
视频较多的循环内容、4K 和双屏视频墙选 Pi 5；1080p 屏幕以及由图片、文字和现成应用组成的看板选 Pi 4。
Raspberry Pi 能播放 4K 数字标牌吗？
Pi 5 可以。它以硬件方式解码最高 4K、60 帧每秒的 HEVC 视频，当你告诉智能体这段视频是给 Pi 5 用的时，它会把每个视频转换为 HEVC。Pi 4 播放 1080p。
设置 Pi 时需要连接屏幕吗？
屏幕上显示配对码，你把它读给智能体。如果安装命令中带有设备群链接，Pi 无需代码就加入你的项目，所以你可以通过 SSH 设置，之后再安装到位。
我可以把 Raspberry Pi 用作广告显示屏吗？
可以。任何播放器都可以投放广告，你可以把它的播放时间卖给广告主。户外数字标牌和 DOOH页面介绍了方法。
如何更新 Pi 上的播放器？
使用相同的选项和相同的账户再运行一次安装命令。配对和显示设置会保留。screenrig.ai/linux/version.txt 给出了当前的版本号。重新加载只刷新内容，不会安装新的播放器。在保留了更新通道的安装上，你的智能体也可以远程更新播放器。
Raspberry Pi 数字标牌的费用是多少？
Pi 及其配件是你的成本。screenRIG 免费，屏幕数量不限。付费套餐增加商务工具、更多成员、专人沟通、治理和合同条款。参见定价。