大屏幕照片墙完整操作教程

按现场操作顺序完成：先确认状态，再添加素材来源，连接屏幕，设置播放和动画，最后分配上屏并在素材监控里处理临时显示。

总览视频

1. 现场标准流程

1. 首页确认软件运行、素材数量和在线屏幕数量。
2. 素材来源里添加照片、视频或外部接口来源。
3. 播放管理里添加屏幕，并打开“启用播放”。
4. 分配引擎里把素材来源连到目标屏幕，点击“保存并生效”。
5. 素材监控里查看设备预览，必要时临时上墙或固定显示。

• 有素材不等于会上屏，必须分配并保存。
• 设备在线不等于会播放，必须打开“启用播放”。
• 改了连线、外部输入或目标规则后，都要点“保存并生效”。

2. 首页检查

1. 看左下角是否是运行状态。
2. 看“素材总数”“已上墙”“待轮播”是否正常。
3. 看“在线播放源”数量是否等于现场应在线屏幕数量。
4. 点击“查看上墙画面”，进入素材监控确认画面。

3. 添加素材来源

1. 进入“素材来源”。
2. 点击“添加素材来源”。
3. 选择来源类型：本地文件夹监控、第三方 API 接入、现场 API 接收。
4. 填写来源名称，选择素材比例和本地存储文件夹。
5. 有视频素材时，保留视频处理策略。
6. 添加成功后，展开“来源设置”继续补参数。

来源类型	要填什么	完成后检查
本地文件夹监控	监控文件夹、是否包含子文件夹、支持格式。	点击“重新扫描”，素材池出现缩略图。
第三方 API 接入	API 地址、访问 Key、活动相册、素材类型、拉取间隔。	测试连接成功，选择相册后素材数量增加。
现场 API 接收	复制 API 地址和鉴权 Key 给对接方，必要时设置允许 IP。	对接方推送后，素材池出现新素材。

素材比例和视频处理

项目	处理方式
图片	按所选素材比例居中裁剪，不额外压缩。
GIF	不按图片比例裁剪。
视频	不按图片比例裁剪，是否压缩看视频处理策略。

• 第一次添加来源时选对比例；已有来源后，新来源会沿用同一比例。
• 照片主体被裁掉，先回素材来源检查比例。
• 视频很多或电脑性能一般时，视频处理策略建议保持开启。

4. 现场 API 推图

普通操作人员只需要把软件里显示的 API 地址和鉴权 Key 复制给对接方。下面内容给对接人员使用。

项目	内容
请求方式	POST
请求地址	软件里“API 地址”显示的完整地址。
鉴权方式	请求头填写 X-API-Key。
内容格式	application/json。
必填字段	type、url。
成功返回	{ "ok": true, "id": "素材编号" }。

{
  "type": "image",
  "url": "https://example.com/photo/A1.jpg",
  "name": "现场照片001"
}

字段	说明
type	素材类型：image、gif、video。
url	素材文件地址，软件会从这个地址下载。
thumb	缩略图地址，可不填。
name	素材名称，可不填。
externalId	对接方素材编号；相同编号不会重复入库。
durationSec	图片停留秒数，可不填。

• 对接方设备必须能访问 API 地址里的电脑 IP。
• 换网络或电脑 IP 变化后，要重新复制 API 地址。
• 开启设备白名单后，只有允许 IP 可以推送。

5. 连接屏幕并启用播放

1. 进入“播放管理”。
2. 左侧选择播放形式：大屏幕照片墙、电视、电脑 Web 或墨水屏。
3. 进入“设备管理”。
4. 点击“添加新设备”，扫码或输入屏幕验证码。
5. 添加成功后打开“启用播放”。
6. 保存设备设置。

播放形式	注意
大屏幕照片墙-多图	LED 大屏、舞台大屏，动画在“大屏动画”里设置。
电视 / 电脑 Web 单图	一次显示一张图，可设置照片停留和视频规则。
墨水屏单图	只支持照片，不支持视频。

• 屏幕和主控电脑一般需要在同一个局域网。
• 方向不对时，先用“一键横屏”或“一键竖屏”。
• 多块屏幕顺序不对，用“通道测试”确认编号后再调排版。

6. 播放规则和大屏动画

1. 进入“播放管理”。
2. 选择要设置的播放形式。
3. 调整照片切换时长、接收内容、视频规则。
4. 点击“保存规则”。
5. 到素材监控或现场屏幕确认效果。

设置	建议
照片切换时长	常用 5 秒或 8 秒。
接收内容	按现场需要选择照片 + 视频、仅照片或仅视频。
视频规则	现场素材多时可限制播放时长；大多数现场建议静音。
多设备依次分配	多台电视希望显示不同素材时打开。

1. 进入“播放管理”，选择“大屏幕照片墙-多图”。
2. 选择要设置的大屏。
3. 在动画设计台添加动画片段。
4. 调整时间轴顺序和右侧参数。
5. 点击“保存方案”。

• 大屏动画只影响“大屏幕照片墙-多图”。
• 照片比例问题回素材来源处理，动画页主要调排版和动效。
• 多块大屏比例不同，不建议直接同步同一套方案。

7. 分配引擎保存生效

1. 进入“分配引擎”。
2. 左侧找到素材来源。
3. 从来源右侧“照片”或“视频”圆点拖线到右侧目标屏幕。
4. 看到绿色连线后，点击“保存并生效”。
5. 去素材监控或现场屏幕确认画面。

按钮	用途
全部测试	给屏幕发测试画面，确认哪块屏是哪台。
整理布局	整理画布，不改变播放关系。
全部恢复	取消临时上墙和驻留，恢复自动轮播。
存档	保存一份线路方案。
保存并生效	把当前连线真正下发到现场。

• “存档”不等于现场生效，现场生效必须点“保存并生效”。
• 照片线连照片入口，视频线连视频入口。
• 清空连线不会删除素材，但会影响现场播放。

8. 素材监控、上墙和固定显示

1. 进入“素材监控”。
2. 选择播放形式。
3. 左侧按全部、在大屏、已轮播、待轮播筛选素材。
4. 点击“上墙”临时显示素材。
5. 点击“驻留”让素材固定显示。
6. 需要撤回时点“下墙”“取消”，或到分配引擎点“全部恢复”。

• 素材监控右侧是设备预览，不是实时大屏画面；现场最终以真实屏幕为准。
• 上墙是临时插播，驻留是固定显示。
• 设备离线时，上墙可能失败或只对部分屏幕生效。

9. 外部输入和手机控制

1. 进入“分配引擎”。
2. 打开顶部“外部输入”总开关。
3. 按现场需要打开二维码或 NFC。
4. 选择驻留时长。
5. 打开目标屏幕上的“外部”开关。
6. 点击“保存并生效”。
7. 复制链接或下载二维码给现场使用。

• 外部输入不会自动发给所有屏幕，只发给打开“外部”的目标。
• 永久驻留不会自动恢复，需要人工取消或全部恢复。
• 活动结束后，不再使用外部输入时建议关闭总开关。

1. 电脑端点击手机 / iPad 控制入口。
2. 手机扫码或输入地址。
3. 电脑端弹出授权时点击允许。
4. 手机端即可进行现场常用操作。

10. 常见问题快速排查

问题	先检查
有素材不上屏	来源是否启用、有无素材数量、设备是否在线、是否启用播放、分配引擎是否保存。
改了连线没变化	是否点击“保存并生效”。
一直停在某张图	是否有上墙、驻留或外部驻留；必要时点“全部恢复”。
视频不播放	播放规则是否选了仅照片，来源是否关闭视频，目标是否是墨水屏。
扫码上传没显示	外部输入总开关、二维码开关、目标屏幕“外部”开关是否都打开并保存。
设备离线	检查网络、电源、播放端页面或程序是否打开。

• 现场不要随意点击删除、清空、恢复出厂等危险操作。
• 不确认来源用途时，不要删除素材来源。
• 排查顺序固定：素材来源 → 播放管理 → 分配引擎 → 素材监控 → 现场屏幕。