查看: 8|回复: 0

迟述智控服务端V1.0

[复制链接]

5

主题

0

回帖

24

积分

管理员

积分
24
发表于 4 小时前 | 显示全部楼层 |阅读模式

# 服务端说明(迟述智控服务端)

> 定位:整套系统的「大脑」。一台常开电脑即可,负责素材库、节目单、设备管理、指令下发,并内置播控台界面与 Pad 接口。

---

## 一、组成

| 组成 | 文件 / 位置 | 作用 |
|---|---|---|
| 播控台主程序 | `迟述智控服务端.exe` | Unity 界面:按钮面板、按钮编辑、F9 服务管理面板 |
| Node 服务 | `server\index.js` | Web 管理页 + REST API + 心跳/分发/播放看门狗 |
| Web 管理端 | `server\public\` | 浏览器访问 `http://服务端IP:8080/` |
| 数据库 | `server\data\platform.db` | SQLite(sql.js,免安装) |
| 媒体库 | `server\data\media\` | `video\`、`img\`、`tmp\` |
| Node 运行时 | `server\runtime\node\` | 按系统自动选择,免装 Node |
| 守护程序(可选) | `watchdog.exe` + `watchdog.ini` | 主程序退出后自动拉起 |

---

## 二、端口表

| 端口 | 协议 | 方向 | 用途 | 配置文件 |
|---|---|---|---|---|
| 8080 | TCP | 入站 | Web 管理页 + 全部 `/api/*` 接口 | `server\config.json` → `port` |
| 8888 | TCP | 入站 | 播控台 HTTP 接口(Pad / 第三方调用) | `StreamingAssets\config.json` → `httpPort` |
| 5020 | UDP | 入站 | 播控台指令/心跳监听(`HB:<clientId>`、触发码) | `StreamingAssets\config.json` → `listenPort` |
| 9100 | TCP | 出站 | 访问各客户端 agent(下发指令、读进度、文件操作) | 客户端 `config.json` → `listen_port` |
| 8888 | UDP | 出站 | 播控台向客户端发 UDP 指令(客户机端口) | 按钮指令中的 `ip 端口` |
| 19730 | TCP | 出站 | 播控台向客户端发 TCP 指令(客户机端口) | 按钮指令中的 `ip 端口` |

说明:

- 8080 支持热切换:Web 端「系统设置 → 端口」调用 `POST /api/system/port`(1024~65535,需未占用),切换后自动写回 `config.json` 并通知各 agent。
- 8080 启动失败会自动回退到上次端口,并修正 `config.json`。
- 环境变量 `PORT` 优先级高于 `config.json`。

---

## 三、配置文件参数表

### 1. `server\config.json`(Node 服务)

| 参数 | 默认值 | 说明 |
|---|---|---|
| `port` | `8080` | Web 与 API 监听端口 |
| `auth.username` | `admin` | 后台登录账号 |
| `auth.password_hash` | `scrypt$...` | 密码哈希(scrypt,不可逆) |
| `auth.secret` | 64 位十六进制 | 登录令牌签名密钥 |
| `auth.token_ttl_hours` | `168` | 登录令牌有效期(小时),默认 7 天 |

### 2. `迟述智控服务端_Data\StreamingAssets\config.json`(播控台)

| 参数 | 默认值 | 说明 |
|---|---|---|
| `listenPort` | `5020` | 播控台 UDP 监听端口(触发码、客户端心跳) |
| `httpPort` | `8888` | 播控台 HTTP 接口端口(Pad 默认连接此端口) |
| `webColumns` | `6` | 播控台 Web 配置页按钮列数 |
| `serialPorts` | `[]` | 串口列表(配合 `Serial.json` 使用) |
| `buttons` | `[]` | 按钮定义(实际明细在 `buttons\*.ini`) |

### 3. `StreamingAssets\server-manager.json`(F9 服务管理面板)

| 参数 | 默认值 | 说明 |
|---|---|---|
| `enabled` | `true` | 是否启用服务管理面板 |
| `autoStart` | `true` | 启动程序时是否自动拉起 Node 服务 |
| `autoStartDelaySec` | `5` | 自动启动延迟(秒) |
| `serverDir` | `""` | 服务端代码目录,空 = 自动识别 |
| `nodeExe` | `""` | 固定 node 路径,空 = 按系统自动选择(建议留空) |
| `port` | `0` | 记录用端口,0 = 跟随 `server\config.json` |

### 4. `StreamingAssets\ui.ini`(界面文字)

| 节点 / 键 | 默认值 | 说明 |
|---|---|---|
| `[窗口] title` | `迟述智控服务端 v26.11.16` | 窗口与任务栏标题 |
| `[界面] logo_text` | `多媒体展厅智能中央控制管理系统` | 界面左上角文字 |

### 5. `StreamingAssets\Serial.json`(串口触发)

| 字段 | 示例 | 说明 |
|---|---|---|
| `port` | `COM3` | 串口号 |
| `baudRate` | `9600` | 波特率 |
| `dataBits` | `8` | 数据位 |
| `stopBits` | `One` | 停止位 |
| `parity` | `None` | 校验位 |
| `format` | `HEX` | 匹配格式(`HEX` / `TEXT`) |
| `match` | `55 08 FF` | 匹配内容,命中即触发 |
| `trigger` | `allon` | 触发码(对应按钮) |

---

## 四、Node 运行时自动选择

| 运行环境 | 使用目录 | Node 版本 |
|---|---|---|
| Win10 / Win11(64 位包) | `server\runtime\node\win10\node.exe` | 24.x x64 |
| Win7 / Win8 / 8.1(64 位包) | `server\runtime\node\win7\node.exe` | 12.22.12 x64 |
| 32 位系统(32 位包) | `server\runtime\node\win32\node.exe` | 12.22.12 x86 |

判定顺序:

1. `RtlGetVersion` 读取真实 Build 号,`>= 10240` 视为 Win10/11;
2. 对候选 `node.exe` 实测 `--version`(5 秒超时,需退出码 0 且输出以 `v` 开头);
3. 首选失败自动回退另一版本,最后回退 `runtime\node\node.exe`。

> 32 位系统必须使用 32 位服务端包(主程序、`UnityPlayer.dll`、Node 全部为 x86)。

---

## 五、数据与日志

| 路径 | 内容 | 说明 |
|---|---|---|
| `server\data\platform.db` | 全部业务数据 | 建议定期备份 |
| `server\data\media\video\` | 视频素材 | 上传后原样存储 |
| `server\data\media\img\` | 图片素材 | 上传后原样存储 |
| `server\data\media\tmp\` | 上传临时文件 | 可清理 |
| `server\logs\server.log` | 服务运行日志 | 排障首选 |

数据表:`clients`(客户机)、`groups`(分组)、`media`(素材)、`media_sync`(下发状态)、`playlists` / `playlist_items` / `playlist_assignments`(节目单)、`playback_settings`(记忆播放)、`client_screensavers`(屏保)、`command_logs`(指令审计)、`settings`(系统设置)。

---

## 六、主要 API

| 分组 | 路径 | 说明 |
|---|---|---|
| 认证 | `POST /api/auth/login`、`logout`、`GET /me`、`POST /password` | 登录、登出、当前用户、改密 |
| 客户机 | `POST /api/clients/register`、`heartbeat` | agent 注册、心跳(10 秒) |
| 客户机 | `GET /api/clients`、`DELETE /api/clients/:id` | 列表、删除 |
| 客户机 | `POST /api/clients/:id/config`、`:id/restart-unity` | 屏保目录、远程重启播放器 |
| 客户机 | `GET/POST/DELETE /api/clients/:id/playback` | 记忆播放设置 |
| 分组 | `GET/POST /api/clients/groups`、`DELETE /api/clients/groups/:id` | 分组管理 |
| 素材 | `POST /api/media/upload`、`GET /api/media`、`GET /api/media/:id/file`、`DELETE /api/media/:id` | 上传、列表、下载、删除 |
| 分发 | `POST /api/media/:id/distribute`、`batch-distribute`、`GET /:id/sync-status` | 定向/批量下发与状态 |
| 同步 | `POST /api/sync/:id/progress`、`report`、`retry` | 下载进度、结果回报、重试 |
| 播控 | `POST /api/control/send`、`POST /api/control/progress`、`GET /api/control/logs` | 指令下发、进度、审计 |
| 节目单 | `/api/playlists` CRUD、`PUT /:id/items`、`POST /:id/assign`、`unassign` | 编排与分配 |
| 屏保 | `GET/POST/DELETE /api/screensaver`、`POST /redistribute` | 屏保配置与重新下发 |
| 系统 | `GET /api/system`、`POST /api/system/port` | 运行信息、端口热切换 |
| 健康检查 | `GET /api/health` | 返回 `{ok,time}` |

`/api/control/send` 允许的指令:`play`、`pause`、`volup`、`voldown`、`switch video`、`switch image`、`prev`、`next`、`qh`、`replay`、`restart`、`shutdown`、`abort`、`rescan`、`seek`、`saver`。

---

## 七、启动与运维

| 操作 | 方法 |
|---|---|
| 启动服务端 | 双击 `迟述智控服务端.exe`(默认自动拉起 Node 服务,延迟 5 秒) |
| 仅启动 Node | 双击 `启动服务.bat` |
| 服务管理面板 | 程序内按 `F9` 或 `Alt+G` |
| 打开 Web 管理 | `http://localhost:8080/` |
| 强制重启 Node | 面板「重启」;或结束 node.exe 后由面板/守护拉起 |

---

## 八、系统要求

| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 7 SP1 / 8 / 8.1 / 10 / 11(32 位系统需用 32 位包) |
| 内存 | 建议 ≥ 4 GB |
| 磁盘 | 按素材总量预留,另留 20% 余量 |
| 网络 | 与所有客户机、Pad 同一局域网;固定 IP 更佳 |
| 权限 | 首次运行允许防火墙放行 8080 / 8888 / 5020 |





普通下载64位


普通下载32位


您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关注公众号

相关侵权、举报、投诉及建议等,请发 E-mail:admin@discuz.vip

Powered by Discuz! X5.0 © 2001-2026 Discuz! Team.|浙ICP备19035960号-1

在本版发帖
关注公众号
QQ客服返回顶部