0 特别注意!
⚠️ 故障补发顺序: 关机, 加入珠子, 再启动机器即可
1 退出原乐摇摇系统
⚠️ 此步骤为安装本 App 前的一次性操作, 完成退乐摇摇后, 主板按钮入口即被本 App 接管。
- 等待系统完全启动后, 使用钥匙打开售珠机面板, 打开主板保护壳, 主板中间位置有一个黑色小按钮, 按下后会进入乐摇摇系统的后台, 最下方有退出, 点击后如果需要输入密码, 请输入
[168168] - 进入系统 设置 > 应用 > 兑币级 , 点击[停用], 请勿删除!
- 安装并运行本 App 后, 该黑色按钮将不再进入乐摇摇后台, 而是直接进入本机系统配置界面(见第 4 节)
2 USB 安装盘制作
- 进入系统, 设置 > 存储 > 屏幕上方点击 [此设备] 选择我们的U盘, 然后右上角 [...] 选择 [格式化]
- 格式化U盘后, 把我们的售珠机程序复制到入U盘根目录
- APK下载地址 http://58.247.20.76/tools/弹珠机APK/
3 安装汤姆熊售珠机
- 使用钥匙打开售珠机面板, 打开主板保护壳, 找到USB接口, 接入U盘
- 进入系统 文件 > 点击左上角 [三] > 选择我们的U盘 > 选择我们的APK > [安装]
- 安装成功后打开, 引导页倒计时 3 秒后自动进入主界面(无手势密码)
4 进入系统配置(主板按钮)
- 系统配置(管理配置)界面是本机所有调试与配置功能的入口
- 在任意页面(引导页 / 主界面)按下主板中间的黑色小按钮, 即可直接进入系统配置, 无需手势密码
- 该按钮已由本 App 接管, 按下时会屏蔽乐摇摇后台, 不会误弹出
- 已在系统配置界面时, 重复按下不会重复进入; 退出请点击左上角返回箭头
5 绑定MAC地址
- 进入系统配置 > 选择本机授权, 你可以看到[本机MAC地址]
- 打开对应的小程序后台, 设备管理 > 导入购弹珠机MAC > [导入] > 选择[店号] > 通用珠 > MAC输入:
[名称(CSLB售珠机1)][空格][本机MAC地址]> 点击[导入]
6 Token测试
- 进入系统配置 > 选择本机授权, 点击TOKEN测试, 点击[发送], 成功提示文字为绿色的, 失败提示为红色
7 反扫器测试(扫码测试)
- 进入系统配置 > 设备配置 > [反扫器测试], 可用任意二维码测试扫码器是否正常开启
8 购珠测试
- 进入系统配置 > 设备配置 > [购珠测试]
[D10C]暂停出珠[D101]生成出珠数量[D102]启动出珠马达- 显示出珠数量
9 存珠测试
- 进入系统配置 > 设备配置 > [存珠测试]
[D601]打开存珠口[D606]关闭存珠口- 显示记录存珠数量
10 游客套餐设置
- 进入小程序后台 > 购弹珠设定 > 线下购弹珠设定, 设置门店相应的购珠套餐
- 售珠机 > 进入系统配置 > 套餐配置 > 同步套餐
- 💡 组合特惠套餐 / 大额套餐: 套餐子项多于 1 个, 或弹珠数 ≥ 500 颗的套餐, 点击后展示进入小程序的二维码, 引导顾客扫码前往小程序购买(不在本机出珠), 页面 60 秒无操作自动返回套餐列表
11 头图设置
- 设计制作头部图片, 尺寸16:9, 保存到U盘根目录
- 进入系统配置 > 头部图片 > 点击导入图片, 系统自动弹出图片选择
12 交易记录
- 购珠, 取珠, 存珠, 核销, 人工
- 库存用尽的出珠订单标记为「需要补」, 可在交易记录一键[补珠]继续出剩余珠, 补珠记录打「(补)」标记
- 本地保留7天的交易记录
13 平台核销
- 选择核销平台
- 本地保留7天的核销记录
14 其他管理配置介绍
进入系统配置后, 顶部 Tab 依次为: 基本设置、套餐配置、平台核销、交易记录、头部图片、设备配置、投币设置、本机授权
基本设置
- 剩余珠数: 补珠 / 重置(默认 10000 颗)
- 人工出珠: 输入数量一键出珠
设备配置
- 主界面底部导航按钮开关: 购珠 / 会员取珠 / 平台核销 / 会员存珠(至少保留一个)
- 调试工具: 反扫器测试 / 购珠测试 / 存珠测试
投币设置
- 投币设置: 投币兑换上报开关; 1元 = ?颗 投币套餐(5/10/20/50/100 元档位自动联动)
- 投币记录: 本地历史记录查询
- 套餐配置 / 平台核销 / 交易记录 / 头部图片 / 本机授权: 见上文第 10~13 节
附 附录
🔧 技术支持: 资讯部
📦 版本更新记录
v1.5.5
- 优化组合特惠套餐页与购珠页界面细节
v1.5.1
- 新增「组合特惠套餐」二维码引导购买: 子项多于 1 个或弹珠数 ≥ 500 的套餐, 点击后展示进入小程序二维码, 顾客扫码前往小程序购买(不在本机出珠)
- 购珠套餐列表新增灯带动画特效
- 补珠(续出)加入出珠看门狗
- 出珠完成后 3 秒自动返回首页
v1.4.2
- 补珠(续出)完成后自动返回首页
- 补珠出珠绕过 D103 unique_code 回匹配校验
v1.4.0
- 交易记录新增「补珠」功能: 库存用尽订单标记「需要补」, 可一键补珠继续出剩余珠, 补珠记录打「(补)」标记
- 库存用尽时屏蔽串口写帧
- 新增取珠套餐设定
v1.3.3
- 新增 D104 获取充值币总帐目: 进入首页后查询一次 + 每 15 分钟定时查询, 用于核对帐目(仅记录, 不自动对账)
- 出珠握手改为等待主板 D101 回包(3 秒超时)后再发 D102
- D103 出珠结果增加 unique_code 回匹配校验, 不匹配的帧忽略
- 停用出珠前「弹珠不足」库存预检(购珠/取珠/核销, 保留开关可恢复)
v1.3.0
- 统一出珠页面: 购珠 / 取珠 / 核销 共用一个通用出珠页(出珠进度、续出恢复、超时保护一致)
- 统一「库存 / 出珠」人工干预提示框: 库存用尽、自动暂停换珠、弹珠不足 三处提示统一为同一组件
- 出珠成功增加完成页展示; 出珠失败/超时停留提示, 点[已知晓, 返回]后离开
v1.2.2
- 新增「库存用尽」顶级故障保护: 出珠中连续 5 秒收不到计数信号即判定库存用尽, 全屏阻塞提示请联系工作人员补珠, 需重启机器恢复
- 出珠信号中断时自动补发暂停指令, 并停止一切串口写帧
v1.2.1
- 修复「出珠自动暂停」BUG: 单次出珠满 500 颗自动暂停出珠, 弹出提示框提示更换珠篮, 点击[继续]恢复出珠
- 引导页倒计时由 10 秒缩短为 3 秒
v1.2.0
- 主板黑色按钮改为直接进入本机系统配置(覆盖原乐摇摇后台入口, 并屏蔽乐摇摇弹出)
- 移除手势密码及引导页「进入设置」按钮, 引导页改为纯倒计时自动进入主界面
- 新增「投币兑换」上报开关(投币设置)
- 调试工具移至「设备配置」Tab, 「扫码测试」更名为「反扫器测试」
v1.1.0