Q1. 小程序会员卡组件跳转会员开卡,提示请从商户⼩程序跳转
青蛙小程序暂时不支持跳转会员组件,待此组件更新后支持,但时间暂无法预估;
建议先使用小程序“请求手机号”的组件过渡。
Q2. 打开体验版版的小程序都需要刷脸
体验版需要校验用户身份,属于小程序基础限制。
Q3. 如何获取手机付款码?
青蛙小程序 - 特殊API接口 | 微信刷脸支付。
Q4. 设备的sn如何发送到收银端?
通过获取系统信息checkWxFacePayOsInfo接口osSerialNumber参数获取设备号。
Q5. 青蛙Pro前屏和背屏能否配置不同⼩程序?
可以是不同的小程序,也可以使用同一个小程序。
小程序可以被推送到青蛙的不同位置(背屏桌面,前屏常驻,刷脸会员等);
推送的时候每个位置可以设置单独的小程序appid,页面 ;
推荐的方式是使用同一个小程序的不同页面,前屏为主,前屏通过launchApp唤起后屏小程序。
Q6. 后屏小程序调用facePay收不到付款码
运行在后屏的小程序不支持调用facepay。
Q7. 背屏能显示的小程序
配置成刷脸会员的小程序;
前屏通过接口调起;
配置成背屏的小程序。
Q8. 背屏“点击登录”小程序的作用
2.12官方提供的通用能力,在背屏需要登录的小程序,需要先点击这个按钮;
扫码登录一下,才可以使用需要登录的小程序,仅针对背屏小程序。
Q9. 青蛙 pro 的前后屏是否必须运行两个小程序?
没有限制,服务商根据需求通过商户平台下发即可。
Q10. 青蛙设备提示“请与收银员确认支付结果”
没有收到支付返回结果,先检查小程序有没有收到付款码,是否已经支付成功。
Q11. 在服务商后台容器里,录入两个前屏小程序(a 和 b),如何操作实现从 a 切换到 b?
重新添加小程序。
Q12. 青蛙 pro 可以小程序去调起打印吗?
可以通过蓝牙调起打印外设。
Q13. 在设备上调试小程序如何查看日志?
青蛙设备上点击右上角,打开 vConsole。
Q14. 小程序如何监听外置扫码枪?
外置扫码枪无法监听,可以通过 input 方式获取外置扫码枪传的值。
Q15. 小程序支持 mqtt 吗?
支持。
Q16. 服务商平台提示:设备号不在设备列表中。
- 京东或小程序购买的青蛙 pro,如何绑定到设备列表?
设备签收后,次日可使用购买订单,前往商户平台设备列表自助绑定。
操作指引:https://docs.qq.com/doc/DVnhkSURhVkFqQUhh - 商户平台申请的设备,如何绑定到设备列表?
若申请的设备类型是青蛙 pro,设备物流签收后,次日会自动绑定;
若申请的设备类型是非青蛙 pro,设备物流签收后,请在申请进度查询;
手动点击”确认收货”,次日会自动绑定。
Q17. 青蛙 pro 屏幕提示:27138676 小程序权限校验失败。
体验版小程序需要使用人员添加试用权限。
Q18. 青蛙 pro 屏幕提示:27138675 小程序包下载失败。
先检查网络连接是否正常,确认网络正常后重新下发小程序。
Q19. 如何将设备上的小程序下架?
通过商户平台下架的小程序。
Q20. 青蛙 pro 屏幕提示:271378673 小程序核心属性拉去失败。
检查小程序下发信息,开发中请选择体验版小程序进行调试。
Q21. 设备上的小程序如何卸载?
无法卸载,可以通过商户平台在小程序投放记录中下架设备。
Q22. 是否一定要先激活设备才能将小程序下发到青蛙设备上?
没有强制要求,符合商户平台下发小程序的要求即可。
Q1. ⼩程序正式版提交审核注意点
小程序提交正式版审核时,建议这样做,有助于过审:
在备注中清晰说明:此小程序哪个功能需要配合青蛙设备使用,无法在移动端体验;
上传在青蛙内使用流程的视频;
如果200字够用,可再附上: 青蛙API 刷脸由青蛙原生实现,小程序只可获得登录权限和支付票据,不获取生物特征信息。
Q2. 商户平台配置小程序多久生效?
正常情况下5~10分钟后设备将会自动生效。
Q3. 小程序商户平台推送和使用
小程序最新配置已经上线,可以满足多种投放范围:按设备类型/设备型号/商户号(最多500个)/设备号(最多500个);
服务商(普通服务商或渠道商)需要把设备绑定在自己商户号名下,才能获得配置权限;
配置小程序,必须使用移动应用AppID绑定小程序,进行下发;
历史数据,需要修改,建议下线重新配置;
调试小程序,建议使用设备号下发;
详情请看【腾讯文档】商户平台-青蛙APP小程序配置(服务商版)。
可参考:商户平台-青蛙APP小程序配置(服务商版)。
Q4. 商户平台智能硬件小程序页面无法显示内容
现不支持通过链接直接打开小程序页面,麻烦先登录,然后,按照流程打开小程序页面,具体使用流程,请看FAQ 流程.2小程序商户平台配置和使用;
浏览器兼容问题,更换chrome浏览器。
Q5. 商户平台登录时安装安全控件后不生效,页面一直提示未安装
可参考:微信支付商户平台登录控件异常处理指引。
Q6. 小程序的审核
由于目前申请的商户较多,还请按照流程操作;
注意点请查阅:FAQ->刷脸⼩程序专项->流程类->Q1. ⼩程序正式版提交审核注意点。
Q7. 遇到特殊情况时小程序审核如何加急?
代码提审页面选择加急提审,具体方式可参考:加急审核的“高速直达通道”。
Q8. ⻘蛙Pro版本⼩程序,如何调⽤打印设备?
请尝试使用通用蓝牙能力,调用蓝牙外设。
主要流程:
- 打开设备蓝牙开关(青蛙v2.13提供,可先在手机调试);
- 在小程序上,基于小程序通用蓝牙能力+打印机开发文档,来连接打印机和调用打印命令。
附: 小程序通用蓝牙能力
理论上可调用支持 BLE 蓝牙传输协议的设备,已测试可行:
- 佳博(Gprinter)GP58MBIII
- 新品佳博(Gprinter)GP58MBIII
- 芯烨(XINYE) XP-58IIH
- 得力无线蓝牙DL-581PW
- 资江58mm外卖打印机
Q9. 商户平台里面的小程序IOT配置,移动应用AppID是什么?
开放平台需要申请一个 移动应用,作为小程序容器使用。
Q10. 商户号和appid和hostappid是否必须一致?
小程序APPID、小程序容器APPID必须一致。服务商可以推送其他服务商的小程序到自己的设备上。
Q11. 小程序版本升级后,如何下发到设备中?
前屏正式版小程序会自动进行更新,后屏小程序需要重启一下设备或切换一下登录状态才会更新。
Q12. 刷脸小程序如何实现独立收银?
默认不⽀持独⽴收银,需要开发⼩程序实现。⼩程序接收付款码,实现独⽴收银的能⼒。
Q1. 如何监听外接小键盘?
青蛙Pro在2.14已支持外接键盘,具体调用方式请看软件类:青蛙小程序 - 特殊API接口 | 微信刷脸支付。
Q2. 背屏登录已失效,请重新登录
背屏小程序登录态是23小时,超过此时间就会弹出提示。
Q3. 前屏弹出提示操作超时是否退出?
前屏小程序登录态有效期是4分钟,超过此时间就会弹出提示。
Q4. 设备上如何调试小程序?
现有方式是,发布一个体验版小程序,将其配置到青蛙上。注意,因为体验版小程序需要校验体验者权限,所以必须以登录状态拉起。
PS:青蛙特殊API不支持电脑和手机调试模拟器调试,只支持在刷脸设备上调试,如在本机运行会报错。
Q5. wxfaceapp.postMsg如何调试?
无法调试,只能⽤体验版,开启debuginfo查看。
Q6. 如何扫码获取手机付款码?
青蛙小程序 - 特殊API接口 | 微信刷脸支付 。
Q7. 小程序的退出是否会影响刷脸?
退出时小程序会自动退出,过一会再次启动,无状态首屏小程序不会存在此问题。
Q8. 小程序支付成功后,能否不显示刷脸支付的成功页?
不能,支付成功页是刷脸APP默认的。
建议:在微信默认成功页展示的同时,就同步在小程序里展示了自己的结果页,这样,客户不用等待加载,体验更平滑。
Q9. quickpay的时间限制?
quickPay有4分钟的时间限制,建议先调用ableToQuickPay进行判断,再调用quickpay。
Q10. 提示:首屏小程序只允许登录无登录态的正式小程序。
开机自启的常驻小程序,只能支持 “以[无登录]状态,打开[正式版]小程序”。
原因:
- 若要求先登录再打开,则会死循环导致小程序无法“自启”;
- 体验版小程序依赖登录态校验体验权限,所以开机自启只能以无登录状态打开正式版。
若要登录怎么办?
- 在运行过程中可以调起登录
建议:可先将小程序配置成会员小程序进行调试。
Q11. 背屏小程序无法调起刷脸支付
运行在背屏的小程序无法完成刷脸支付,建议:背屏小程序传指令给前屏小程序,前屏调起刷脸支付。
Q12. 双屏小程序如何调试?
目前最优的调试办法:
- 设置为体验版,前屏的会员小程序;
- 会员小程序启动后,通过api,启动背屏小程序;
- 进行调试。
Q13. setStorage 保存成功,但是getStorage取不到数据
接口内部保存了一个用户的登录id,所以如果在A登录的情况下进行保存,会生成一个A的内部Key。
PS:用户A登录了小程序,小程序调用setStorage保存信息。
用户A退出小程序,用户B登录了这个小程序,小程序调用getStorage,
是无法获取到刚才在A登录状态下的信息的,无登录态下,没有问题,因为这种情况下,使用的内部Key是机器的id。
Q14. 前屏setStorage保存信息,后屏getStorage获取不到数据或后屏setStorage,前屏获取不到
2.20的版本中,小程序基础接口做了改动,为了保证用户数据安全,在不同的进程中,setStorage的存储数据无法共享。 对应到青蛙Pro中,前后屏分别是不同的进程,所以无法共享数据。
Q15. 小程序获取用户信息
wx.login(Object object) | 微信开放文档
调⽤wx.login接口之前,必须先调⽤facelogin或者打开刷脸⽀付,完成刷脸。否则,⽆法获取到登录状态。
Q16. wx.request能否设置端口?
小程序暂不支持端口访问,但域名可以使用。
Q17. 背屏小程序能否常驻?
背屏小程序不能设置成常驻。
Q18. vConsole如何关闭?
详情请参考:小程序正式版本如何关闭vconsole按钮。
Q19. 271378673小程序核心属性拉取失败?
请检查小程序下发信息,在后台获取小程序的信息时候,获取失败。
PS:开发版小程序,开放平台暂不支持此模式,如开发中还请选择体验版小程序进行调试。
Q20. 为何通过 wxfaceapp.faceLogin 方法获取用户的 openid 和小程序正常获取的 openid 不一致?
通过 wxfaceapp.faceLogin 获取的是该用户基于小程序 appid 的openid,刷脸小程序获取的 openid 是基于商户绑定的 appid。
Q21. wxfaceapp.faceLogin({enableMultiLogin:true,relaunchUrl:"pages/pay/pay?a=xxx&b=xxx&c=xxxx"}),relaunchUrl 参数可否这样传递查询字符串?
传递额外参数暂时不支持。
Q22. 青蛙小程序特殊 api 回调函数里面可以使用 setData 赋值吗?
可以
Q23. 通过哪个接口可以获取商户号?
wx.getLaunchOptions 接口的 mchId 参数。
Q24. 青蛙小程序支持使用 webview 跳转吗?
可以
Q25. wxfaceapp.onFacePayFailedEvent、wxfaceapp.onQueryPaymentSucEvent、wxfaceapp.onQueryPaymentFailedEvent 这几个监听开启了需要关吗? 不关会不会导致小程序卡顿?
不需要关闭,不会影响。
Q26. wxfaceapp.faceLogin 这个 api 用了之后,会清除缓存吗?
会的。
Q27. 青蛙 pro 有操作语音播报的 api 吗?
没有特殊接口,建议使用外部 TTS 服务,再调用小程序通用音频播放能力。
Q28. facePay 刷脸支付页面除了手动关闭,可以通过程序控制关闭吗?
目前没有对应的控制接口。