AGI Bar 有多块显示屏，可以展示各种活动信息、海报、视频
更新靠插 U 盘，一轮下来十几分钟，很不 AGI
市面上是有一些方案，但死贵、且难用
我还在筹备二店，每个店单独维护一套系统也不现实
于是杨宏芷宁，AGI Bar 的实习生，用飞书&树莓派，搭建了一套展示系统
在手机上改内容，就会在屏幕上生效，成本极低，可批量复制
这套东西，昨天晚上搞定的，软硬件结合，效果拔群
等我把代码再拾掇一下，会以更标准&简单的方式，让大家用上
下面这篇文章，是实习生杨宏芷宁的实践记录
用飞书，控制店铺屏幕
一、事情的起因
某一天的下午，大老师突然兴致勃勃的和我说：我们 AGI Bar 日常需要在门口的三个屏幕上播放一些内容，比如宣传海报轮播、视频播放（例如宣传片）、一些第三方网页（活动页面/报名入口之类）。
这些内容需要实时替换，最好他能够在手机上直接线上修改，不需要每次都跑到店里插 U 盘或者掏出点什么东西改半天或者打电话叫我。同时，三个屏幕要分别控制，让他们展示不同或相同的内容。如果能控制轮播的速度就更好了。
听完大老师的需求，我脑子里快速过了一遍：多屏幕展示、远程控制、稳定简洁。看起来不复杂，但要做好还真得想想办法。
二、方案对比与选择
一开始，我查了查资料，对比了几种常见的方案。
传统 U 盘方案？把图片、视频拷到 U 盘，插在电视上。这显然完全不符合大老师的需求，每次更新都要跑到店里，而且三个屏幕很难同步管理。
第三方广告机系统？市面上有很多广告机系统，功能强大，很多商业场所的选择。但我们已经有三个三星的屏了，买完新的没地方放，而且也做不到如此"客制化"。
串流播放？在电脑上运行 OBS 或类似推流软件，通过局域网把内容推到店铺的屏幕上。非常实时，也可以远程到推流源主机上随便改。但店面不大，还经常有活动需要来回移动桌椅，很难给一台稳定运行的主机找地方放。
自己开发 CMS 系统？搭一个内容管理后台，上传图片、视频、链接然后推送到屏幕。想想都肝疼，要做的太多了。
在对比过程中，大老师突然想到：飞书其实就是一个很好的内容管理平台。
飞书多维表格可以随时新增、修改、删除内容，表格天然就是一个轻量级的 CMS。企业自建应用能通过 API 拉取数据，实现高度定制化。云端管理让你在任何地方都能直接修改表格，立即生效。最关键的是，飞书免费，我只要写一点后端逻辑和前端界面就行。
于是，我最后决定：用飞书作为内容管理平台，结合树莓派作为终端播放器，搭建整个展示系统。
三、技术实现过程
1. 搭建飞书"内容管理后台"
首先，我在飞书里新建了一个多维表格，把它作为"内容管理后台"。字段设计得很直白：
- 哪个电视：标记内容是给哪一块屏幕播放的（比如"外侧北电视""入户电视""外侧南电视"）
- 附件：直接上传图片（支持多张），也可以放视频，也可以视频和图片混放
- 轮播间隔（秒）：控制每个素材停留的时长
- 网址：如果要跳转到网页，可以直接填 URL
- 最后更新时间：方便追踪内容的修改情况
这样，任何人只要会用 Excel，就能随时往里加内容，学习成本几乎为零。
2. 开启多维表格自动化流程
为了保证内容更新后能即时同步到云端网页，我还在飞书多维表格里配置了一个自动化流程。
流程逻辑很简单：当表格中的记录发生变化（比如新增了图片、更换了播放网址、调整了播放间隔），飞书就会触发一个动作。这个动作是向我部署在云服务器上的 API 发送一个 POST 请求，通知服务器"有新内容需要刷新"。
云服务器接收到请求后，就会重新拉取最新的表格数据，并通过 WebSocket 广播给所有的屏幕端。
这样做的好处显而易见：不需要靠定时任务去轮询，而是有更新立即推送，保证了屏幕上的内容和飞书表格几乎是实时同步的。
3. 企业自建应用 & API 拉取
为了从表格里拉取数据，我在飞书开发者后台创建了一个企业自建应用，然后给它开通了多维表格的权限。
这里踩了一个坑：如果使用的是应用 token 的话，单纯申请多维表格权限还不够，还需要给应用加上机器人权限，否则会报错。报错信息在飞书里搜索，就直接告诉我是缺少机器人权限的原因（其实文档里写了但我没细看），还是很方便的。
拿到 Token 后，就可以在云服务器上写脚本，拉取表格数据，写到展示网页中。
4. 云服务器作为中转与分发
在飞书自动化流程把变更推送出来之后，我需要有一个"中枢"来处理这些更新，还要保证更新及时，于是我在云服务器上部署了一个使用了 WebSocket 的小型 Web 服务。
它的职责主要有三点：
接收飞书推送：当多维表格有变化时，飞书会触发自动化流程，向云服务器的指定 API（/trigger-refresh）发起一个 HTTP 请求。服务器接收到请求后，会立即去调用飞书的 API，拉取最新的表格数据。
缓存与处理数据：拉取到的表格内容会被转换成统一格式。服务器会把这些数据存储在本地文件中，保证客户端请求时能快速获取。
实时分发给屏幕端：我在服务器和客户端（树莓派网页端）之间建立了 WebSocket 连接。一旦有新内容，服务器就会通过 WebSocket 广播给所有在线的屏幕端，让它们立即刷新播放列表。
这样，整个数据流就形成了：飞书多维表格（更新） → 自动化流程（推送 HTTP 请求） → 云服务器（拉取并处理数据） → WebSocket 广播 → 树莓派屏幕（即时更新播放）。
5. 树莓派作为展示终端
在店铺的三个屏幕后面，我各放了一台树莓派并做了几个关键设置：
- 开机自启动浏览器，直接全屏打开展示网页
- 关闭屏幕保护和节能模式，保证一直显示
- 可以远程 SSH 登录，方便我调试和维护
这样，每次开机就能自动进入展示状态，根本不需要人手动操作。
6. 理论上的展示页面效果
系统支持轮播图展示，也支持视频播放，基本满足了大老师的所有需求。
四、最终效果与体验
经过不断的调试，现在整个系统运行非常稳定。店铺现在常用的模式是：外面两个屏放海报，屋里放活动排表。
多屏控制做到了，三个屏幕完全独立，也能保持一致内容。远程更新也实现了，我只需要在飞书表格里改一下，几秒钟后屏幕就会更新。成本还低，几乎零额外费用，飞书免费，树莓派硬件一次性投入即可。可扩展性也不错，上面的轮播图就是在大老师新的需求下，用同样的原理又做的。
五、总结
整个项目中，我的核心思路是
- 用飞书多维表格替代 CMS 后台，在尽可能自由的前提下大大减少开发成本。
- 用树莓派作为低成本播放终端，灵活不占地方，可以放到任何其他屏幕上复用。
其实飞书不仅仅是一个协作工具，它完全可以作为轻量级的应用开发平台。通过飞书 API，我们可以快速搭建很多业务场景，不仅省钱，还能满足个性化需求。
粤ICP备14082021号
免费POC，
零成本试错
