|
|
# Pad 端说明(中控 Pad APK)
> 定位:安卓平板上的「移动遥控器」。连上播控台的 HTTP 接口,按现场按钮布局触发指令,并实时显示执行进度。
---
## 一、运行形态
| 项目 | 说明 |
|---|---|
| 安装包 | `中控Pad.apk`(Unity Android) |
| 连接对象 | **播控台**(服务端主程序的 8888 端口),不是 Node 的 8080 |
| 网络 | 与播控台同一局域网(WiFi) |
| 配置方式 | 应用内设置页,或直接编辑 `pad_config.txt` |
---
## 二、配置项 `pad_config.txt`
文件位置:
- 主配置:`Application.persistentDataPath/pad_config.txt`(卸载应用会删除)
- 备份:`/storage/emulated/0/Download/pad_config.txt`(卸载重装后自动恢复)
格式:`key=value` 明文,`#` 开头为注释;修改后重启应用生效(`pad.host` / `pad.port` 立即生效)。
| 键 | 默认值 | 说明 |
|---|---|---|
| `pad.host` | `192.168.88.8` | 播控台 IP |
| `pad.port` | `8888` | 播控台 HTTP 端口 |
| `pad.onCode` | `dmton` | 一键全开触发码 |
| `pad.offCode` | `dmtoff` | 一键全关触发码 |
| `pad.presetGroups` | 空 | 预设分组(逗号分隔) |
| `pad.deviceGroups` | 空 | 设备分组(逗号分隔) |
| `pad.preset.0.name` | `预设 1` | 第 1 个预设名称(0~19 共 20 组) |
| `pad.preset.0.mmOn` | 空 | 第 1 个预设的「矩阵开」触发码 |
| `pad.preset.0.mmOff` | 空 | 第 1 个预设的「矩阵关」触发码 |
| `pad.preset.0.ltOn` | 空 | 第 1 个预设的「大屏开」触发码 |
| `pad.preset.0.ltOff` | 空 | 第 1 个预设的「大屏关」触发码 |
> `pad.preset.N.*` 的 `N` 取 `0~19`,与上表同理。
---
## 三、接口表
| 接口 | 方法 | 超时 | 说明 |
|---|---|---|---|
| `/api/config` | GET | 8 秒 | 拉取按钮布局与配置 |
| `/api/trigger/{触发码}` | POST | 8 秒 | 触发一组指令(URL 编码) |
| `/api/progress/{触发码}` | GET | 3 秒 | 查询该组指令的执行进度 |
基础地址:`http://{pad.host}:{pad.port}`。
### 1. `GET /api/config` 返回
| 字段 | 说明 |
|---|---|
| `ok` | 是否成功 |
| `config.listenPort` | 播控台 UDP 端口(5020) |
| `config.httpPort` | 播控台 HTTP 端口(8888) |
| `config.webColumns` | 按钮列数 |
| `config.buttons[]` | 按钮数组 |
| `buttons[].buttonName` | 按钮名称 |
| `buttons[].trigger` | 触发码 |
| `buttons[].group` | 所属分组 |
| `buttons[].commands[]` | 该按钮包含的指令列表(用于显示条数) |
### 2. `POST /api/trigger/{触发码}` 返回
| 字段 | 说明 |
|---|---|
| `ok` | 是否已执行 |
| `trigger` | 触发码 |
| `cmds` | 指令条数 |
| `totalTime` | 预计总时长(秒) |
### 3. `GET /api/progress/{触发码}` 返回
| 字段 | 说明 |
|---|---|
| `ok` | 是否成功 |
| `current` | 当前执行到第几条 |
| `total` | 总条数 |
| `label` | 当前指令描述 |
| `running` | 是否执行中 |
| `elapsed` | 已用时(秒) |
| `totalTime` | 预计总时长(秒) |
> 若播控台配置了 HTTP Token(`AppController.httpToken` 非空),请求需携带对应鉴权参数;内网可信环境可留空。
---
## 四、使用流程
1. Pad 连接与播控台同一 WiFi;
2. 打开应用 → 设置 → 填写播控台 IP 与端口(默认 `192.168.88.8:8888`)→ 保存;
3. 应用自动拉取 `/api/config`,按现场按钮布局生成界面;
4. 点击按钮 → `POST /api/trigger/{码}` → 轮询 `/api/progress/{码}` 显示进度条;
5. 一键全开 / 全关分别走 `pad.onCode` / `pad.offCode`。
---
## 五、常见问题
| 现象 | 排查 |
|---|---|
| 界面空白、拉不到按钮 | 检查 `pad.host/port` 是否指向播控台;浏览器访问 `http://IP:8888/api/config` 是否有 JSON |
| 点击无反应 | 播控台是否在线;该触发码是否在播控台配置中存在 |
| 进度条不动 | 播控台与本机时间/网络是否正常;`/api/progress/{码}` 是否返回 `running=true` |
| 换平板后配置丢失 | 从 `/storage/emulated/0/Download/pad_config.txt` 复制回应用私有目录(应用会自动恢复) |
| 升级 APK 后配置还在吗 | 在,`pad_config.txt` 位于应用数据目录,覆盖安装不影响 |
---
## 六、环境要求
| 项目 | 要求 |
|---|---|
| 系统 | Android 7.0 及以上(建议 8.0+) |
| 网络 | 与播控台同一局域网,能访问 8888 端口 |
| 屏幕 | 横屏使用,建议 10 英寸以上 |
普通下载
|
|