简体中文
收款播报 APP:概览与链路
收款播报 APP 是运行在安卓手机上的收款提醒工具。装上 APP 并激活后,手机就是一台「虚拟设备」:收款成功时语音播报到账金额,连接小票打印机后还能同时出票。不需要采购云音箱、云打印机等实体硬件,用闲置手机补齐「听得到到账、留得下小票」的收款体验。
核心能力
| 能力 | 说明 |
|---|---|
| 语音播报 | 收款成功后播报到账金额与收款渠道;播报语音由内置词元拼接,不依赖手机 TTS 音色 |
| 小票打印 | 连接小票打印机后收款成功自动出票,支持 58 / 80mm 两种纸宽 |
| 在线状态 | APP 定时向平台上报心跳,运营端与商户端都能看到设备是否在线 |
| 多语言界面 | 界面支持简体中文、繁体中文(台湾 / 香港)、英语、日语、韩语、印尼语、马来语、泰语、越南语共 10 种语言,可跟随系统或在 APP 内手动指定,通知、桌面小部件与错误提示随语言切换(入口:设置 → 显示与语言);播报语音为内置中文词元,不随界面语言变化 |
| 应用级开关 | 每个支付应用可独立开启 / 关闭语音播报与小票打印,并选择小票版式(入口:应用列表 → 进入配置 → 应用工作台 → 收款播报) |
| 试播 / 试打 | 运营端与商户端的设备列表均提供测试入口,不发起真实收款即可验证播报与打印链路 |
| 手机侧附加能力 | 桌面金额小部件、本机收款流水查询、免打扰时段,均在 APP 内使用 |
一条收款消息怎么走
- 平台收到收款成功结果,按设备号发布消息;
- 消息经 Artemis broker 通过 MQTT over WebSocket(wss)长连接推送到手机;
- APP 解密消息,播放语音;需要打印时按纸宽取出平台下发的小票指令流;
- APP 向平台回报播报回执,并保持 5 分钟一次的心跳。
消息管道的主题契约、小票渲染方式与激活回执机制见设计架构。
设备与打印兼容
| 项 | 支持范围 |
|---|---|
| 手机 | 安卓 8.0 及以上,安装 APK |
| 打印机 | 58 / 80mm ESC/POS 热敏小票机 |
| 连接方式 | 经典蓝牙(SPP)、USB、网络打印机(RAW TCP 9100) |
| 打印数据 | 平台渲染好的 ESC/POS 指令流,APP 原样输出,不做本地排版 |
手机与网络打印机须在同一局域网,填写打印机 IP 与端口即可。APP 内的纸宽设置必须与实际用纸一致,纸宽不符会导致小票排版异常。
两条设计边界
- 线上 API、易支付来源的订单默认不播报、不打印:该功能面向人工收银场景,接口类订单没有店内播报需求;
- 播报消息经设备密钥加密:接入账号在消息服务侧只允许订阅、不允许发布,防止伪造到账消息(平台已内置,无需配置)。
获取方式
收款播报 APP 按 DaxPay 生态扩展包档位交付,以源码形式提供(含源码授权)。安装包(Android 8.0+)可从官网产品页与系统演示页的下载区获取,也可直接下载 daxpay-virtual-device-release.apk;获取方式与授权条款以官网定价页为准。
服务器地址由安装包编译期内置,APP 不提供运行时输入。换用指向其他环境的安装包后需重新激活,属预期行为。