HoloLV 帮助手册

1. 认识 HoloLV

HoloLV 是一套由全息显示设备、手机 App、Windows 客户端与云端服务组成的多媒体展示系统，支持单台使用、局域网多设备管理、云端远程控制以及多台设备拼接联屏。

三种使用模式

• 单机模式：手机直接连接设备发出的 Wi-Fi 热点，无需路由器和互联网，适合单台设备与临时布展。
• 局域网模式：手机或电脑与设备连接同一路由器，可管理多台设备，传输走局域网，速度快且不消耗移动流量。
• 云端模式：登录 HoloLV 账号后经互联网管理设备，支持跨网远程控制、设备分享、离线暂存与传输任务追踪。

三个使用端

• 手机 App（iOS / Android）：包含设备、设计、图库、设置四个板块，是日常控制与内容管理的主要入口。
• Windows 客户端：用于联屏切割、批量传输、逐台局域网传片与电脑投屏，是拼接安装的必备工具。
• Web 管理端：用浏览器访问 cloud.beverg.com/admin，管理账号下的设备、同步组、媒体与传输任务。

本手册适用于 HoloLV 全系产品与各软件端。不同机型的随机配件可能不同，配件请以实物与包装清单为准。

2. 快速开始

第一次使用，建议按以下步骤进行：

1. 将设备固定稳妥后接通电源，用机身上的船型开关开机，等待叶片旋转、画面点亮。
2. 在手机应用商店搜索并安装 HoloLV App（支持 iOS 与 Android）。
3. 打开手机 Wi-Fi，连接设备发出的热点，默认密码为 12345678；热点名称因机型而异，请以实际搜索到的名称为准。
4. 打开 App，设备页会自动发现设备，点击设备卡片即可进入控制。
5. 在图库中选择视频或图片并点击传送，App 会自动转码为设备所需格式。
6. 如需远程管理，在设置中注册或登录 HoloLV 账号，并在设备页绑定设备。

单机模式下手机无法同时上网，属正常现象；需要联网时请改用局域网模式或云端模式。

3. 单机模式（热点直连）

单机模式指手机直接连接设备自身发出的 Wi-Fi 热点（AP）。所有控制与传输都在手机与设备之间直接完成，不经过路由器或云端。

连接步骤

1. 确认设备已开机。设备热点的默认密码为 12345678；热点名称因机型而异，请在手机 Wi-Fi 列表中查找。
2. 打开手机的“设置 → Wi-Fi”，在列表中选择该设备热点并输入密码。
3. 打开 HoloLV App，设备页会显示该设备，点击即可进入控制页面。

可以完成的操作

• 上传视频与图片（自动转码）、删除文件、播放/暂停、切换上一个/下一个、调节音量。
• 调节亮度、角度、播放模式（顺序播放 / 随机播放 / 单曲循环）与色彩模式。
• 修改设备名称、切换 Wi-Fi、重启设备、格式化存储卡、恢复出厂设置。

设备热点（AP）与连接路由器（STA）两种网络模式互斥，同一时间只能使用其中一种。

4. 局域网模式

局域网模式下，设备作为终端连接到您的无线路由器，手机或 Windows 电脑也接入同一网络，即可自动发现并管理设备。

配置步骤

1. 先在单机模式下进入设备的 Wi-Fi 设置，选择您的路由器并输入密码，设备将切换为局域网模式。
2. 将手机连接到同一路由器（需为同一网段）。
3. 打开 App，设备页会自动发现局域网内的在线设备，支持多台同时显示与管理。
4. Windows 客户端在同一网络内发现设备后，可逐台通过 HTTP 传输视频。

使用要点

• 设备发现依赖 SSDP 局域网广播，请确保手机、电脑与设备处于同一网段，且路由器未开启 AP 隔离。
• 局域网传输不经过云端、不消耗移动流量，适合大文件与多设备批量传输。
• 已绑定云端的设备在 App 中会显示“局域网 + 云端”标识，两种通道可同时使用。

5. 云端模式

登录 HoloLV 账号后，设备通过互联网与云端保持连接，可跨网络管理。设备约每 30 秒上报一次心跳，掉线超过约 90 秒后显示为离线。

绑定设备

1. 在 App 设置中注册或登录 HoloLV 账号。
2. 在设备页选择绑定设备：与设备处于同一局域网时可一键绑定；不在同一网络时使用配对码绑定。
3. 获取配对码：在设备旁长按遥控器中心键，屏幕会显示 4 位配对码，在 App 中输入即可。
4. 绑定者为设备拥有者，拥有该设备的全部管理权限。

分享与权限

• 可将设备分享给其他 HoloLV 账号，权限分为查看者与控制者。
• 查看者可观看与浏览；控制者可进行播控并推送内容。
• 被分享者不能删除设备，也不能再次分享设备。

远程控制

云端模式下即使不在设备身边也可进行播控与内容推送。内容经云端传输任务下发，可跨网络完成；云端传输单文件大小上限为 50 MB。

云端暂存（设备离线时）

• 设备离线时推送的内容会先暂存云端，设备重新上线后自动下载，无需人工值守。
• 暂存任务设有有效期，列表中显示“已暂存云端·剩 N 天”，到期后标记为已过期。
• 传输任务状态包括：已暂存、传输中、下载中、已完成、失败、已取消、已过期；失败任务可在任务列表中点击重试。

解除绑定仅移除该账号对设备的云端访问权限，不会删除设备本地的媒体文件。

6. 同步组与拼接

同步组用于多台设备协同工作。一台设备同一时间只能属于一个同步组。同步组有两种工作方式：

• 联屏同步（拼接）：多台设备组成一块大屏幕，共同显示一个完整画面，由一台主机（master）统一调度。
• 独立播放（集群）：组内设备各自播放同一个完整视频，实现多台设备整齐同播。

联屏同步（拼接）

画面切割只能在 Windows 客户端完成。支持 1×2、1×3、2×2 以及自定义布局（最大 9×9）。

1. 在 Windows 客户端确认所有设备在线（局域网或云端均可）。
2. 创建同步组并选择联屏同步，设置行数、列数，指定一台设备作为主机。
3. 按实际安装位置设置每台设备的角度与前后排深度；1×3 布局默认中间设备位于后排。
4. 选择源视频与切割方式：外切（外接矩形，视野更大）或内接（内接矩形，画面完整、留白更多）；设置重叠 overlap（默认 0.08）与羽化 feather（默认 20）。源片比例不足时会自动居中补黑。
5. 客户端调用 FFmpeg 自动切割，生成每台设备的 1024×1024 圆形画面片段与清单文件。
6. 将片段传输到对应设备（自动 / 局域网 / 云端）；Wi-Fi 环境差或设备较多时，可导出 TF 卡逐台拷贝。
7. 播放控制只需发给主机，主机通过 433 MHz 无线信号向从机广播同步指令，各屏幕起播误差在约 80 毫秒以内。

• 布局在创建时确定，之后不可更改；如需调整行列或成员，需要重新建组并重新切割。
• 联屏播放时仅主机出声，从机自动静音。
• 相邻画面的重叠透镜区域会涂黑，以消除拼缝亮带。
• 联屏组不接受直播投屏，直播功能仅支持单台设备。

独立播放（集群）

• 没有主机与从机之分，组内成员均为普通成员，App 与 Windows 客户端均可向整组下发同一个完整视频。
• 适用于多台设备阵列整齐播放，不切割画面，也不依赖 433 无线信号。
• 在 App 中可使用“传输视频到组（独立播放）”进行批量推送。

TF 卡导出部署

当设备数量较多或现场 Wi-Fi 条件差时，可在 Windows 客户端按设备导出各自的画面片段与配置文件（hololv/sync_group/config.json）到 TF 卡，将卡插入对应设备即可完成部署。

7. 手机 App 使用指南

App 底部包含四个板块：

• 设备：发现并控制设备，查看设备信息与视频库，管理同步组与云端传输任务。
• 设计：在线模板创作，提供图片魔方、3D 文字球、旋转文字、艺术字/挤压文字等模板；作品导出后保存在图库的本地分类中。
• 图库：管理本地与云端媒体，按图片、视频、3D 模型、音频分类，支持多选与批量传送到设备，可开启“仅在 Wi-Fi 下载”。
• 设置：云端账号、深色模式（跟随系统 / 浅色 / 深色）、语言、清除缓存、检查更新、隐私政策等。

拍照与录像

图库中可调用相机：轻触快门拍照，长按快门录像，素材会直接保存到本地图库。

设备页常用操作

• 播放控制：播放/暂停、上一个/下一个、音量，以及顺序播放、随机播放、单曲循环三种播放模式。
• 画面调节：亮度、角度、色彩模式（标准 / 鲜艳 / 柔和），以及正常、演示、节能三种设备模式。
• 桌面时钟：不显示桌面、整点显示、每十分钟显示一次。
• 电机开关：控制叶片是否随开机旋转。
• 蓝牙音箱：扫描、连接或断开支持 A2DP 的蓝牙音箱；联屏时由主机出声。
• 维护入口：固件升级（选择 .swu 文件，经存储卡自动安装并重启）、格式化 SD 卡、重启设备、恢复出厂设置、查看存储空间、修改设备名称。

通过 App 上传视频时会自动转码为设备规格（H.264 Baseline、无 B 帧、1024×1024、25fps），无需自行处理格式。

8. Windows 客户端

环境准备

• 电脑需安装 Python 3.11 或更高版本，以及 FFmpeg（加入系统 PATH，或放置到 C:\ffmpeg\bin）。
• 双击 start.bat 启动客户端（默认 PySide6 界面，run_ctk.py 为旧版界面）。

设备发现

启动后通过 SSDP 自动发现在线设备，也可手动输入设备 IP。登录云端账号后，云端设备会与局域网结果合并，并标注“局域网”“云端”或“局域网 + 云端”。

主要功能

• 同步组配置与联屏切割，详见第 6 章。
• 视频传输提供三种方式：auto（自动探测，局域网可达走局域网，否则走云端）、lan（强制逐台 HTTP 传输，不并发）、cloud（走云端）。
• TF 卡导出：按设备导出画面片段与同步组配置。

电脑投屏（仅单台设备）

• 可将视频文件、摄像头画面或电脑桌面实时投屏到单台设备，仅支持局域网。
• 电脑端通过 FFmpeg 实时编码为 1024×1024、H.264 Baseline、无 B 帧、25fps，并以 HLS 提供给设备拉流，端到端延迟约 1–2 秒。
• 受 DRM 保护的内容或独占全屏模式可能导致黑屏，请改用窗口模式播放。

联屏组不接受直播投屏；需要拼屏显示时，请使用切割后的视频文件。

9. Web 管理端

Web 管理端是运行在浏览器中的管理后台。使用 HoloLV 账号登录 https://cloud.beverg.com/admin/ 即可访问。

主要页面

• 概览：账号与设备的整体状态。
• 设备：设备列表、绑定信息、在线状态、远程播控与解绑。
• 同步组：创建和管理联屏同步组与独立播放组。
• 私有媒体：管理账号的私有媒体库。
• 传输任务：查看单设备与拼接任务的状态，失败任务可重试。
• 公共素材：浏览与使用公共素材库。
• 用户管理：仅管理员可见，初始管理员通过 ADMIN_BOOTSTRAP_EMAILS 指定。

Web 端与 App 使用同一账号体系：角色分为普通用户与管理员；设备分享权限分为查看者与控制者。

10. 安装与摆放

安全注意事项

• 设备工作时叶片高速旋转，严禁在旋转过程中触碰叶片或将手指伸入设备；请安装在行人无法触碰的位置。
• 请远离儿童活动区域；吊装或壁挂必须使用可靠的固定件，并确认墙面或顶面承重足够。
• 严禁带电插拔电源或在叶片旋转时移动设备；请先关机，待叶片完全停止后再操作。

摆放与供电

• 设备应固定平稳、避免震动；多台拼接时按设计位置摆放，并在同步组中配置对应的角度与前后排。
• 请使用配套电源适配器，保持接口不受力、电源线不被拉扯。
• 保持设备周围通风，远离热源、雨水与阳光直射，建议工作环境温度为 5℃–35℃。
• 避免强光直射灯珠面，以获得最佳全息显示效果。

本手册不包含具体配件清单；不同机型的挂架、底座、遥控器等配件请以包装实物为准。

11. 维护与固件升级

日常保养

• 清洁前请先关机断电，等待叶片完全停止；用柔软干布轻轻擦拭，勿使用有机溶剂或湿布。
• 定期检查固定件是否松动、电源线与接口是否完好。
• 请勿自行拆机，设备内部除尘请联系售后。

固件升级

1. 从官方渠道获取对应机型的 .swu 升级文件。
2. 在 App 设备设置中选择固件升级并选取该文件，文件会先传入设备存储卡。
3. 设备将自动完成安装并重启，升级过程中请勿断电。

重启、恢复出厂与存储卡

• 设备出现异常时，可先尝试在 App 中重启设备。
• 恢复出厂设置会清空设备配置（含 Wi-Fi、设备名称、绑定信息），请谨慎操作。
• 格式化 SD 卡会清除卡内全部媒体文件，如有需要请先备份。

恢复出厂设置不会自动解除云端绑定；转让设备前，请先在 App 中解除绑定。

12. 常见问题

13. 技术规格与支持

通过 App 可上传常见视频与图片格式并自动转码；图库同时支持 3D 模型与音频的分类管理。

获取支持

如果本手册未能解决您的问题，请在 App“设置 → 检查更新”中保持客户端为最新版本，并联系购买渠道的售后支持。