功能:大屏 APK 原生播报及项目入口

具体项目页由 APK 原生轮询并播报三次,总览页不播报。总览项目卡片通过项目编码进入对应大屏。
This commit is contained in:
2026-08-11 00:58:17 +08:00
parent 5ad8bfcd03
commit e4e3e6a735
27 changed files with 728 additions and 236 deletions

View File

@@ -2,19 +2,27 @@
这是景区排队叫号系统的原生 Android 薄壳,只承载两个公开页面:
- 项目列表`https://queue.nianxx.cn/admin/display`
- 单项目展示`https://queue.nianxx.cn/display/{项目编或公示 Token}`
- 总览页面`https://queue.nianxx.cn/admin/display`
- 单项目页面`https://queue.nianxx.cn/display/{项目编或公示 Token}`
## 现场能力
- 无浏览器地址栏的沉浸式展示,并保持屏幕常亮
- 总览页面只展示项目状态,不进行语音播报
- 单项目页面由 APK 每 3 秒读取公开快照接口,发现新叫号批次后调用系统中文 TTS
- 每次叫号由 Android 原生层连续播报三次,并使用系统媒体音量通道
- 接管项目卡的网页全屏请求,返回键退出全屏
- 允许叫号音频无需额外手势播放
- 支持上述两个 HTTPS 页面作为 Android 深链
- 仅允许 `queue.nianxx.cn` 的公开公示路径,阻止后台、员工端、外域和明文 HTTP 导航
- 网络证书异常时显示原生重试页
- 网络证书或中文语音引擎异常时显示原生提示
APK 仍依赖线上服务和 Android System WebView不会把实时队列数据离线复制进安装包。
APK 仍依赖线上服务和 Android System WebView不会把实时队列数据离线复制进安装包。叫号检测和播报都由 APK 原生层负责,不依赖线上网页是否包含语音代码;普通浏览器访问单项目页面时不会播报。
## 设备要求
- 系统已安装并启用支持简体中文的文字转语音引擎
- 设备媒体音量已打开
- Android System WebView 可以访问 `https://queue.nianxx.cn`
## 构建