微信支付商店智能硬件支持运行小程序。 目前我们已经为“微信青蛙”系列设备提供了更丰富的能力支持。 其他软硬件请耐心等待。 如果您有任何建议,欢迎反馈。
最新更新
青蛙App版本2.12 [2024.11.28]
新的
1. 核心概念 1.1 门店智能硬件小程序
小程序可以在不同的终端上运行。 商店智能硬件或手机微信App上运行的小程序本质上是相同的,具有相同的技术原理和账户体系。 开发者可以直接将现有的小程序配置到门店智能硬件中,也可以根据门店智能硬件的特点进行差异化设计。
在不同的运行环境下,能力上确实存在一些差异,但更重要的是应用场景上存在差异。 例如:
硬件运行小程序,轻松获得以下特性:
以上可能会带来创新的机会。 如何对接微信,构建多终端综合服务场景,值得思考和探索。 1.2 软件和硬件适用范围软件
Frog App(仅支持系统)
硬件
单屏:青蛙和开放平台设备
双屏:仅支持Frog Pro,尚不支持开放平台双屏设备
推荐配置
四核 2GHz CPU
内存 2GB RAM+8GB ROM
安卓7.1及以上版本
1.3 软件架构
青蛙App与小程序的关系如下:
2. 关键能力描述 2.1 如何启动小程序
2.2 登录能力
手机微信App提供了一个小程序运行环境,持续维护用户的微信登录状态(所有用户必须先登录微信账号才可以进入并使用微信)。 因此,在手机微信App中,小程序可以轻松调用wx.、wx. 等API请求当前登录用户的手机号码授权等
与此不同的是,商店智能硬件上的青蛙App默认运行在“未登录状态”,只有在必要时才会请求用户“暂时登录”。 用户可以“刷脸”或“手机扫描二维码”临时获取青蛙App的登录状态。
开发者无需了解或维护登录流程,登录状态由Frog App管理。 登录后,小程序可以像往常一样调用依赖于用户身份的API。
Frog App请求用户登录的时机:
打开小程序前,要求用户登录(可在配置小程序到设备时设置)。 小程序运行过程中,请求用户登录(通过小程序调用API实现)
清除青蛙App登录状态的时序:
登录状态超时后,自动清除登录状态并关闭小程序(弹窗询问)
小程序可以调用API请求清除登录状态并自行关闭。
特别的
对于双屏Frog Pro设备,Frog App可以获得前后屏环境2种独立的登录状态。 登录方式不同:
前屏(刷脸摄像头一侧):仅支持刷脸登录; 登录状态有效期短
背屏:仅支持点击背屏桌面“登录”图标,用手机扫描二维码登录; 登录状态有效期较长
2.4 支付能力
青蛙设备支持通过“刷脸”或“扫码”获取用户支付码,商户后台可通过“支付码支付”通道下单、支付。 上述支付方式也可以被Frog中运行的小程序调用。
小程序可以调用API通知青蛙发起刷脸支付(仅支持前屏小程序),类型如下:
刷脸支付:支付码目的地可选(传回小程序,或通过USB-HID传输到收银机) 免刷脸快捷支付:用户刷卡登录小程序后刷脸,短时间无需刷卡即可使用小程序 通过刷脸获取支付码,支付码的去向可选(回传给小程序,或者传给现金)通过 USB-HID 注册)
小程序还可以调用API监控青蛙扫码器的输入,扫码类型不限。
至于小程序原来的“小程序支付”,会弹出二维码组件,用手机扫码即可完成支付。
使用小程序接收支付码并实现“独立收银”的特别说明:
2.4 外部通讯能力
当frog连接到外部设备(如收银机)时,它可以与外部设备进行单向或双向通信。 上述通信能力可以被Frog中运行的小程序调用或响应。
传出:调用API,通过USB-HID模拟键盘输入,将定制的数据信息传输到外部设备,如支付码、会员识别码、手机号码等(外部设备无需开发) 传入:外部设备可以与 frog 通信 发起“启动小程序”命令,也可以通过 frog 将自定义信息透传给正在运行的小程序(外部设备需要提前接入命令 SDK) 2.5 双屏联动能力
这是Frog Pro 的独特功能。
前后双屏支持同时运行小程序(可以相同也可以不同,并且可以指定打开的页面)。 前屏运行的小程序可以随时联动打开后屏特定小程序的特定页面,在前后屏上运行。 两个小程序可以实时来回通信,通信内容由开发者自由约定。
所有硬件扩展能力的详细信息请参考附录《硬件运行小程序扩展API接口文档》。
3.3.1基本属性的开发、调试、交付
屏幕分辨率
微信青蛙基础版、微信青蛙专业版(前屏、后屏)
800×1280像素
场景值
当小程序运行在手机微信App以外的环境时,场景值ID=1133
参考:
3.2 小程序准备
1、为经营主体准备小程序(获取小程序)
2. 开发并使用微信开发者工具开发小程序
3、调试现阶段在硬件上调试小程序存在一定的局限性。
4. 发布
1)提交审核并发布小程序“正式版”
备注中明确说明:本小程序哪些功能需要配合刷脸设备使用,无法在移动端体验
上传设备上使用小程序过程的视频
2)给硬件配置“正式版”
3.3 Frog 设备准备 3.3.1 激活 Frog 设备
青蛙设备激活前,需要完成设备序列号SN与支付商户号的绑定。
目前支持的方法:
连接收银机激活并完成微信支付码支付 3.3.2 发送小程序配置至青蛙设备
1)为微信开放平台准备移动应用
如果移动应用为服务提供商所有,请通过电子邮件申请MA绑定。 邮件模板如下:
接受者:
邮件标题:【服务商MA绑定申请】+商户名称
正文必须包含以下内容:
移动应用程序(最多三个)
服务名称
有认证吗?
移动应用主体名称(认证企业名称)
商户实体名称
是否启用微信支付
2)登录微信支付商户平台
3)进入小程序配置下发页面
直接连接商户
产品中心→我的产品→刷脸支付→进入功能(请先开启人脸识别权限)→运行青蛙APP小程序
服务提供者
产品中心→特约商户授权产品→服务商刷脸支付→进入功能(请先开启刷脸权限)→运行青蛙APP小程序
4)配置操作说明
5)硬件上的小程序代码将保持最新,但“体验版”和“正式版”版本不会改变。
6)备用流程:手动申请将小程序分发到硬件上
附录 相关文档链接 应用场景 小程序硬件运行示例
整体工具解决方案