适合这些场景
- 企业展厅 / 党建展馆 / 博物馆导览
- 售楼处沙盘解说、户型与楼层指引
- 景区游客中心、商场导购、医院导诊
- 学校荣誉墙、图书馆查询机、会议签到机
- 任意 Windows 触摸一体机 / 立式广告机 / 拼接屏
01 · 软件定位
它是什么，解决什么问题
展厅、展馆、售楼处、党建文化墙、景区游客中心里的触摸一体机，过去要么用 PPT / 图片轮播凑合，要么花几万元外包定制。VIXSHIXTouch 把这套流程收敛成一个 exe：会做 PPT 就能做触摸节目。
VIXSHIXTouch 是面向触摸一体机、查询机、数字标牌的交互式内容展示系统。内置可视化编辑器、全屏播放端与网页管理后台：无需编程，拖拖拽拽即可做出带 视频、相册、3D 翻书、手写留言、硬件联动 的触摸节目，一键发布到展厅里的每一台机器。
相比传统方案
- 不用写代码：拖拽摆放、属性面板调参，即时预览
- 不用装环境：绿色版 exe，播放器自带解码器与运行库
- 不用跑现场：局域网一键发布，网页后台远程改内容
- 不怕没人管：自动返回首页、无人操作自动复位
- 素材不丢：工程目录集中管理，引用保护防止误删
02 · 三种身份
一个程序，三种身份
同一份 VIXSHIXTouch.exe 通过启动参数切换角色，也可以直接双击目录里的三个批处理文件。
启动器
--launcher先挑工程，再挑模式。列出工程目录里所有带 project.json 的项目，点一下即开，启动后自动退出不占内存。
设计版（编辑器）
--editor制作端。页面树 + 画布 + 属性面板三栏布局，拖控件、调属性、预览播放、发布节目都在这里完成。
编辑模式.bat播放端（全屏展示）
--player面向观众的那一端。全屏置顶、隐藏鼠标、无人点击自动回首页，可持续 7×24 运行。
播放模式.bat
编辑器与播放端都内置网页管理后台
启动后同一局域网内的电脑、平板、手机用浏览器即可编辑页面与元素，不必回到制作机上操作。
03 · 设计版编辑器
三栏式所见即所得
左边管页面结构，中间画布直接拖，右边改参数。画布排版与播出效果共用同一套渲染组件，编辑时看到的就是观众看到的样子。
项目 打开 · 保存 · 预览播放
编辑 撤销 · 重做 · 复制 · 粘贴
插入 图片 · 相册 · 文本 · 视频 · 网页 · 按钮…
设置 全局设置 · 素材管理 · 留言管理 · 管理后台
页面结构
首页
展厅介绍
景区导览
楼层指引
详情 A
详情 B
拖动调整顺序 / 层级；右键：复制 · 粘贴 · 合并 · 重命名
属性面板
位置和大小
X710
Y360
宽度500
高度350
圆角15 px
图层 / 动画
图层（1-10）5
入场动画淡入
持续呼吸开
交互
链接到页面展厅介绍
界面布局示意图，用于说明编辑器的三栏结构，非软件实际截图。
页面树，任意层级
首页 + 多级子页面，拖动即可改顺序或变成子页面；支持多选合并、复制粘贴子树（自动换新 ID，跳转不串页）。
精准排版与多选
方向键微调、Ctrl / Shift 多选、空白拖拽框选，提供左 / 右 / 顶 / 底 / 居中对齐与横向纵向等距分布，元素可锁定防误拖。
无限撤销
所有改数据的入口统一入栈，Ctrl+Z / Ctrl+Y 可回退任意步；连续拖同一个滑块只记一步，撤销不会一次退一像素。
04 · 交互模块
23 种开箱即用的交互模块
插入菜单里点一下就能用，不需要准备任何图片素材也能先搭出骨架（缺素材时显示占位块与提示文字）。
UDP 按钮的 20 种预置样式
经典蓝科技青清新绿活力橙热情红
优雅紫玫红渐层晚霞深海蓝夜空深蓝
曜石黑金属银香槟金玻璃拟态线框简约
霓虹青霓虹粉胶囊青圆形蓝钮圆形橙钮
由程序直接绘制，不依赖任何图片文件，工程拷到别的机器也不会丢样式。
23种
开箱即用的交互模块
20种
UDP 按钮预置样式
10种
内置按钮音效
3种
运行模式：启动器 / 编辑器 / 播放端
05 · 核心能力
让画面「活」起来的细节
这些能力是软件在实际展厅项目中被反复打磨出来的，也是它和普通图片轮播的本质区别。
入场与呼吸动画
每个图片 / 文字模块可配淡入、滑入、放大、缩小四种入场动画（方向、时长、延迟可调）；另有「持续呼吸」来回缩放用于长期吸引注意，围绕中心平滑缩放，不会跳档抖动。
按钮音效
10 种内置音效（可关闭），在全局设置里选一次，全工程图片、跳转按钮、UDP 按钮共用；音量烘焙进音频数据，避免声卡冷启动时音量突然变大。
自动返回首页
无人操作 N 秒后自动跳回首页，保证下一位观众看到的是完整内容起点；配合播放时隐藏鼠标，触屏机上不会出现光标残留。
UDP 远程控制
中控系统按文本指令即可控制播放端翻页、播放 / 暂停 / 跳转视频进度，也可由页面打开时自动向灯光、矩阵等第三方设备发送指令（支持 UTF-8 文本与十六进制两种格式）。
视频音画同步
画面由 OpenCV 解码并与所有元素在同一渲染管线合成（透明度、圆角、浮层都正常生效），音轨走随包 ffmpeg 子进程解码，不依赖系统解码器，精简版 Windows 也有声音。
素材库与引用保护
图片 / 视频 / 音频 / 网页分类存放，支持搜索、批量导入、批量删除；删除前自动扫描全工程引用，正在被使用的素材会被拦下并告知用在哪些页面。
06 · 上线流程
从制作到上线：四步走
建工程、排页面、预览调试、发布上屏，工程数据集中在一个可拷贝的文件夹里。
1
新建工程
设置分辨率 1920×1080，工程数据保存为 project.json，素材归入 images / videos。
2
拖拽排版
插入模块、调属性、设跳转，支持 Ctrl+Z 随时回退。
3
预览调试
Ctrl+P 全屏预览并保存，所见即所得。
4
发布上屏
局域网 / 手机 App / 后台三种方式下发，无需 U 盘拷贝。
工程数据保存在 project.json 中，素材按类型归入 images / videos / audio / web / files 目录，整个文件夹即一个可拷贝的工程。
07 · 发布与远程
发布、远程与多机管理
改完内容不用跑现场、不用拔 U 盘。编辑机与播放端在同一局域网即可完成发现、打包、下发、回执的完整闭环。
播放端 A
展厅入口一体机
播放端 B
二楼展区竖屏
播放端 C
会议室查询机
工程打包下发 · 下载完成后回执
编辑机（设计版）
打包工程 · 挂到内置后台 · UDP 广播发现 + fetch 指令
同一局域网访问 · 保存后自动刷新
手机 / 平板 App
连接电脑后自动下载
网页管理后台
页面树 / 属性 / 素材库
受控设备
灯光 · 矩阵 · 电脑开关
同一局域网（WiFi / 路由器）· 播放端下载完成后回执，编辑端显示进度。
发布到播放端
编辑器自动扫描局域网内的播放端（约 3 秒），选中一台、指定起始页，工程打包后由对方自动下载、解压、切换并回执；正在播放的目录不会被直接覆盖，换不动时下次启动继续。
网页管理后台
一键启动本地 HTTP 服务，浏览器里管理全部页面与元素、素材库、留言管理与全局设置；可设密码保护（存哈希），手机平板也能访问，保存后播放端自动刷新。
发布到手机 App
把工程打包成 zip 挂到后台，手机 App 点「连接电脑」后自动拉取并播放，适合演示与移动导览。
08 · 硬件联动
硬件联动与远程指令
在「全局设置」里填一个 UDP 控制端口，中控、单片机、灯光控制器就可以用纯文本指令驱动播放端。
| 指令 | 作用 | 示例 |
|---|---|---|
goto 页面ID |
跳转到指定页面 | goto page1 |
next / prev [模块ID] |
相册、照片墙翻页；省略模块 ID 时作用于整页 | next |
play / pause / stop [模块ID] |
控制视频播放、暂停、停止 | play elem_1 |
seek 模块ID 位置 |
跳转到视频指定位置，支持秒数 / 时间码 / 百分比 / 相对偏移 | seek v1 1:30、seek v1 50% |
纯文本即可驱动
指令以 UDP 文本发送，支持 UTF-8 文本与十六进制两种格式；页面上也可以配置进入时自动向灯光、矩阵等第三方设备发送指令。
页面打开自动发指令
每个页面可配置进入时自动发送的 UDP 指令（目标 IP、端口、延时、多行按序发送），并提供「发送测试」按钮现场验证，常用于切页时联动灯光场景。
UDP 按钮 / 滑动条
指令模板支持 {v} 当前数值、{vh} 两位十六进制占位符，可配弹起 / 按下两张图或使用 20 种预置样式。
电脑开关按钮
填 MAC 与 IP 后，一个按钮完成 WOL 网络唤醒开机、UDP 指令关机，并轮询显示在线 / 离线状态。
09 · 技术规格
技术规格与运行环境
Windows 下免安装运行，自带解码器与运行库；工程数据全部是明文文件，便于备份与迁移。
| 运行平台 | Windows 7 / 10 / 11（64 位），绿色版无需安装 Python 或 Qt |
| 技术栈 | Python 3.13 + PyQt5 + OpenCV + NumPy；PyInstaller 单目录打包 |
| 音视频解码 | 随包 ffmpeg（LGPL），不依赖系统媒体功能包 |
| 分辨率 | 任意自定义（常见 1920×1080 / 1366×768 / 竖屏 1080×1920），改分辨率可按比例缩放全部控件 |
| 素材格式 | 图片 png / jpg / jpeg / gif / bmp / webp；视频 mp4 / avi / mov / wmv / mkv；音频 mp3 / wav / ogg；网页 html |
| 工程数据 | project.json（页面树 + 元素）+ messages.json（留言），UTF-8 明文可读 |
目录结构
VIXSHIXTouch.exe— 主程序（三模式合一）启动器.bat / 编辑模式.bat / 播放模式.bat— 三种入口_internal/projects/— 工程目录（内置 demo 示例工程）_internal/sounds/— 10 种内置按钮音效_internal/ffmpeg/、cv2/、PyQt5/— 随包运行库license.dat— 注册授权文件（一机一码）
授权方式
首次启动显示机器码，填入注册码即可激活；授权与机器绑定。
授权文件为目录中的 license.dat，一机一码。
10 · 快速上手
六步做出第一屏内容
从启动器到发布上屏，一台电脑就能走完整个流程。
- 双击「启动器.bat」 选择 demo 工程或新建工程，点「启动编辑器」进入设计版。
- 搭建页面结构 左侧页面树右键新建子页面，拖动调整顺序与层级，双击重命名。
- 摆放模块 顶部「插入」菜单选择模块，在画布上拖动定位，右侧面板调尺寸、圆角、图层、动画与跳转。
- 准备素材 「设置 → 素材管理」批量导入图片视频，删除时有引用保护；也可直接把文件拖进素材库。
- 预览与调试 Ctrl+P 全屏预览，检查跳转、视频、动画与音效；Esc 退出。
- 保存并发布 Ctrl+S 保存，然后「发布到播放端」或启动「管理后台」远程维护。
常用快捷键
| 快捷键 | 说明 |
|---|---|
Ctrl + S | 保存工程 |
Ctrl + P | 预览播放（打开播放端） |
Ctrl + Z / Y | 撤销 / 重做 |
Delete | 删除选中模块 |
方向键 | 微调元素位置 |
Ctrl + 滚轮 | 缩放画布 |
Ctrl / Shift + 点击 | 多选模块（可对齐分布、整组移动） |
Ctrl + E（播放端） | 打开网页后台 |
F11（播放端） | 恢复全屏置顶播放 |
触屏现场无需键盘
所有操作都有对应的菜单、工具栏按钮与右键菜单；播放端右上角为长按退出区，避免观众误触退出。