查看: 7|回复: 0

中控 Pad APK V1.0

[复制链接]

5

主题

0

回帖

24

积分

管理员

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

# 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 英寸以上 |





普通下载


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

本版积分规则

关注公众号

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

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

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