# 刷脸小程序专项

# 产品类

Q1. 小程序会员卡组件跳转会员开卡，提示请从商户⼩程序跳转

青蛙小程序暂时不支持跳转会员组件，待此组件更新后支持，但时间暂无法预估；

建议先使用小程序“请求手机号”的组件过渡。

Q2. 打开体验版版的小程序都需要刷脸

体验版需要校验用户身份，属于小程序基础限制。

Q3. 如何获取手机付款码？

青蛙小程序 - 特殊API接口 | 微信刷脸支付。

Q4. 设备的sn如何发送到收银端？

通过获取系统信息checkWxFacePayOsInfo接口osSerialNumber参数获取设备号。

Q5. 青蛙Pro前屏和背屏能否配置不同⼩程序？

可以是不同的小程序，也可以使用同一个小程序。

小程序可以被推送到青蛙的不同位置（背屏桌面，前屏常驻，刷脸会员等）;

推送的时候每个位置可以设置单独的小程序appid,页面 ;

推荐的方式是使用同一个小程序的不同页面，前屏为主，前屏通过launchApp唤起后屏小程序。

Q6. 后屏小程序调用facePay收不到付款码

运行在后屏的小程序不支持调用facepay。

Q7. 背屏能显示的小程序

1. 配置成刷脸会员的小程序；

2. 前屏通过接口调起；

3. 配置成背屏的小程序。

Q8. 背屏“点击登录”小程序的作用

1. 2.12官方提供的通用能力，在背屏需要登录的小程序，需要先点击这个按钮；
   

2. 扫码登录一下，才可以使用需要登录的小程序，仅针对背屏小程序。

Q9. 青蛙 pro 的前后屏是否必须运行两个小程序？

没有限制，服务商根据需求通过商户平台下发即可。

Q10. 青蛙设备提示“请与收银员确认支付结果”

没有收到支付返回结果，先检查小程序有没有收到付款码，是否已经支付成功。

Q11. 在服务商后台容器里，录入两个前屏小程序（a 和 b），如何操作实现从 a 切换到 b？

重新添加小程序。

Q12. 青蛙 pro 可以小程序去调起打印吗？

可以通过蓝牙调起打印外设。

Q13. 在设备上调试小程序如何查看日志？

青蛙设备上点击右上角，打开 vConsole。

Q14. 小程序如何监听外置扫码枪？

外置扫码枪无法监听，可以通过 input 方式获取外置扫码枪传的值。

Q15. 小程序支持 mqtt 吗？

支持。

Q16. 服务商平台提示：设备号不在设备列表中。

1. 京东或小程序购买的青蛙 pro，如何绑定到设备列表？
   设备签收后，次日可使用购买订单，前往商户平台设备列表自助绑定。
   操作指引：https://docs.qq.com/doc/DVnhkSURhVkFqQUhh
2. 商户平台申请的设备，如何绑定到设备列表？
   若申请的设备类型是青蛙 pro，设备物流签收后，次日会自动绑定；
   若申请的设备类型是非青蛙 pro，设备物流签收后，请在申请进度查询；
   手动点击”确认收货”，次日会自动绑定。

Q17. 青蛙 pro 屏幕提示：27138676 小程序权限校验失败。

体验版小程序需要使用人员添加试用权限。

Q18. 青蛙 pro 屏幕提示：27138675 小程序包下载失败。

先检查网络连接是否正常，确认网络正常后重新下发小程序。

Q19. 如何将设备上的小程序下架？

通过商户平台下架的小程序。

Q20. 青蛙 pro 屏幕提示：271378673 小程序核心属性拉去失败。

检查小程序下发信息，开发中请选择体验版小程序进行调试。

Q21. 设备上的小程序如何卸载？

无法卸载，可以通过商户平台在小程序投放记录中下架设备。

Q22. 是否一定要先激活设备才能将小程序下发到青蛙设备上？

没有强制要求，符合商户平台下发小程序的要求即可。

# 流程类

Q1. ⼩程序正式版提交审核注意点

小程序提交正式版审核时，建议这样做，有助于过审：

1. 在备注中清晰说明：此小程序哪个功能需要配合青蛙设备使用，无法在移动端体验；

2. 上传在青蛙内使用流程的视频；

3. 如果200字够用，可再附上： 青蛙API 刷脸由青蛙原生实现，小程序只可获得登录权限和支付票据，不获取生物特征信息。

Q2. 商户平台配置小程序多久生效？

正常情况下5~10分钟后设备将会自动生效。

Q3. 小程序商户平台推送和使用

1. 小程序最新配置已经上线，可以满足多种投放范围：按设备类型/设备型号/商户号（最多500个）/设备号（最多500个）；
   

2. 服务商（普通服务商或渠道商）需要把设备绑定在自己商户号名下，才能获得配置权限；
   

3. 配置小程序，必须使用移动应用AppID绑定小程序，进行下发；
   

4. 历史数据，需要修改，建议下线重新配置；
   

5. 调试小程序，建议使用设备号下发；
   

6. 详情请看【腾讯文档】商户平台-青蛙APP小程序配置（服务商版）。
   

可参考：商户平台-青蛙APP小程序配置（服务商版）。

Q4. 商户平台智能硬件小程序页面无法显示内容

1. 现不支持通过链接直接打开小程序页面，麻烦先登录，然后，按照流程打开小程序页面，具体使用流程，请看FAQ 流程.2小程序商户平台配置和使用；

2. 浏览器兼容问题，更换chrome浏览器。

Q5. 商户平台登录时安装安全控件后不生效，页面一直提示未安装

可参考：微信支付商户平台登录控件异常处理指引。

Q6. 小程序的审核

由于目前申请的商户较多，还请按照流程操作；

注意点请查阅：FAQ->刷脸⼩程序专项->流程类->Q1. ⼩程序正式版提交审核注意点。

Q7. 遇到特殊情况时小程序审核如何加急？

代码提审页面选择加急提审，具体方式可参考：加急审核的“高速直达通道”。

Q8. ⻘蛙Pro版本⼩程序，如何调⽤打印设备？

请尝试使用通用蓝牙能力，调用蓝牙外设。

主要流程：

1. 打开设备蓝牙开关（青蛙v2.13提供，可先在手机调试）；
2. 在小程序上，基于小程序通用蓝牙能力+打印机开发文档，来连接打印机和调用打印命令。

附： 小程序通用蓝牙能力

理论上可调用支持 BLE 蓝牙传输协议的设备，已测试可行：

1. 佳博（Gprinter）GP58MBIII
2. 新品佳博（Gprinter）GP58MBIII
3. 芯烨（XINYE） XP-58IIH
4. 得力无线蓝牙DL-581PW
5. 资江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. 提示：首屏小程序只允许登录无登录态的正式小程序。

开机自启的常驻小程序，只能支持 “以[无登录]状态，打开[正式版]小程序”。

原因：

1. 若要求先登录再打开，则会死循环导致小程序无法“自启”；
2. 体验版小程序依赖登录态校验体验权限，所以开机自启只能以无登录状态打开正式版。

若要登录怎么办？

• 在运行过程中可以调起登录

建议：可先将小程序配置成会员小程序进行调试。

Q11. 背屏小程序无法调起刷脸支付

运行在背屏的小程序无法完成刷脸支付，建议：背屏小程序传指令给前屏小程序，前屏调起刷脸支付。

Q12. 双屏小程序如何调试？

目前最优的调试办法：

1. 设置为体验版，前屏的会员小程序；
   
2. 会员小程序启动后，通过api，启动背屏小程序；
   
3. 进行调试。
   

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 刷脸支付页面除了手动关闭，可以通过程序控制关闭吗？

目前没有对应的控制接口。

Q29. 设备上调试小程序如何查看日志呢？

打开 vconsole。