Files
XQKqueue/android
brother7 e4e3e6a735 功能:大屏 APK 原生播报及项目入口
具体项目页由 APK 原生轮询并播报三次,总览页不播报。总览项目卡片通过项目编码进入对应大屏。
2026-08-11 00:58:17 +08:00
..
2026-08-01 21:44:59 +08:00
2026-08-01 21:44:59 +08:00
2026-08-01 21:44:59 +08:00
2026-08-01 21:44:59 +08:00
2026-08-01 21:44:59 +08:00
2026-08-01 21:44:59 +08:00

Android 公示屏 APK

这是景区排队叫号系统的原生 Android 薄壳,只承载两个公开页面:

  • 总览页面: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 可以访问 https://queue.nianxx.cn

构建

需要 JDK 17+ 和 Android SDK 36Build Tools 36.1.0

$env:ANDROID_HOME = 'C:\Users\你的用户名\AppData\Local\Android\Sdk'
.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

可安装 APK 位于 app/build/outputs/apk/debug/app-debug.apk。Debug APK 适合现场安装验证;正式发布前应使用单位自有密钥生成签名 Release APK。

安装与深链验证

& "$env:ANDROID_HOME\platform-tools\adb.exe" install -r .\app\build\outputs\apk\debug\app-debug.apk
& "$env:ANDROID_HOME\platform-tools\adb.exe" shell am start -a android.intent.action.VIEW -d 'https://queue.nianxx.cn/display/YYHHC'