# 刷脸小程序专项

# 产品类

1. 小程序会员卡组件跳转会员开卡过去提示请从商户小程序跳转

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

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

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

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

3. 如何获取手机付款码

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

PS:青蛙一代是扫设备上方的区域 青蛙Pro是下方的扫描区;

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

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

5.Pro两边必须是两个小程序?

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

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

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

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

6.与刷脸小程序接口无关的问题的问题

此处支持有限建议到小程序社区自行查看。

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

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

8.背屏能显示的小程序

1、配置成刷脸会员的小程序;

2、前屏通过接口调起;

3、配置成背屏的小程序;

9.如何配置小程序到设备上

商户通过商户平台配置好小程序后,会根据对应的商户号下发到设备中 如若不生效,请看FAQ 流程.4。

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

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

扫码登录一下,才可以使用需要登录的小程序,仅针对背屏小程序;

11.青蛙小指令

青蛙小指令前正在测试中,我们确定功能对接顺利之后会公布在官网上,届时可以自主根据文档对接。目前我们还在活跃开发中。

# 流程类

1. 小程序正式发版审核

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

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

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

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

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

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

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

  1. 小程序最新配置已经上线,可以满足多种投放范围:按设备类型/设备型号/商户号(最多500个)/设备号(最多500个)

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

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

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

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

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

可参考:商户平台-青蛙APP小程序配置(服务商版)

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

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

2、浏览器兼容性问题,麻烦更换浏览器尝试一下,现已确定可使用的浏览器:chrome。

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

可参考;

6.小程序的审核

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

还请看FAQ 流程.1 小程序正式发版审核。

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

代码提审页面选择加急提审,具体方式可参考;

8.青蛙PRO版本小程序,后续是否具备API接打印设备进行打印

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

主要流程:

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

附: 小程序通用蓝牙能力

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

  1. 佳博(Gprinter)GP58MBIII
  2. 新品佳博(Gprinter)GP58MBIII
  3. 芯烨(XINYE) XP-58IIH
  4. 得力无线蓝牙DL-581PW
  5. 资江58mm外卖打印机

9.商户平台里面的小程序IOT配置,移动应用AppID是什么

开放平台需要申请一个 移动应用,作为小程序容器使用。

10.商户号和appid和hostappid是否必须一致

小程序APPID、小程序容器APPID必须一致。服务商可以推送其他服务商的小程序到自己的设备上。

11.小程序版本升级后,如何下发到设备中

前屏正式版小程序会自动进行更新,后屏小程序需要重启一下设备或切换一下登录态才会更新

12.刷脸小程序如何实现独立收银

默认不支持独立收银,需要开发小程序实现,小程序接收付款码、实现独立收银的能力,没有变化,可以照常使用。

# 软件类

1. 如何监听外接小键盘

青蛙Pro在2.14已支持外接键盘,具体调用方式请看软件类:青蛙小程序 - 特殊API接口 | 微信刷脸支付

2. 背屏登录已失效,请重新登录

背屏小程序登录态是23小时,超过此时间就会弹出提示

3. 前屏弹出提示操作超时是否退出

前屏小程序登录态有效期是4分钟,超过此时间就会弹出提示

4. 设备上如何调试小程序

现有方式是,发布一个体验版小程序,将其配置到青蛙上。注意,因为体验版小程序需要校验体验者权限,所以必须以登录状态拉起。

PS:青蛙特殊API不支持电脑和手机调试模拟器调试,只支持在刷脸设备上调试,如在本机运行会报错.

5. wxfaceapp.postMsg如何调试

无法调试,只能用体验版,开启debugInfo查看

6. 如何扫码获取手机付款码

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

PS:青蛙一代是扫设备上方的3D摄像头,青蛙Pro是下方的扫描区

7. 小程序的退出是否会影响刷脸

退出时小程序会自动退出,过一会会再次启动。无状态首屏小程序不会存在此问题

8.小程序支付成功后,能否不显示刷脸支付的成功页

不能,支付成功页是刷脸APP默认的.

建议:在微信默认成功页展示的同时,就同步在小程序里展示了自己的结果页,这样,客户不用等待加载,体验更平滑

9.quickpay的时间限制

quickPay有4分钟的时间限制,建议先调用ableToQuickPay进行判断,再调用quickpay

10.提示 首屏小程序只允许登录无登录态的正式小程序

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

原因:

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

若要登录怎么办?

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

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

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

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

12双屏小程序如何调试

目前最优的调试办法:

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

13.setStorage 保存成功,但是getStorage取不到数据

接口内部保存了一个用户的登录id,所以如果在A登录的情况下进行保存,会生成一个A的内部Key
PS:用户A登录了小程序,小程序调用setStorage保存信息。 用户A退出小程序,用户B登录了这个小程序,小程序调用getStorage, 是无法获取到刚才在A登录态下的信息的, 无登录态下,没有问题,因为这种情况下,使用的内部Key是机器的id。

14.前屏setStorage保存信息,后屏getStorage获取不到数据或后屏setStorage,前屏获取不到

2.20的版本中,小程序基础接口做了改动,为了保证用户数据安全,在不同的进程中,setStorage的存储数据无法共享。 对应到青蛙Pro中,前后屏分别是不同的进程,所以无法共享数据。

15.小程序获取用户信息

wx.login(Object object) | 微信开放文档

调用此接口之前,必须先调用一下facelogin或者打开刷脸支付 刷一下脸,否则,无法获取到登陆态.

16.wx.request能否设置端口

小程序暂不支持端口访问,但域名可以使用。

17.背屏小程序能否常驻

背屏小程序不能设置成常驻。

18.vConsole如何关闭

详情请看

19.271378673小程序核心属性拉取失败

请检查小程序下发信息,在后台获取小程序的信息时候,获取失败。
PS:开发版小程序,开放平台暂不支持此模式,如开发中还请选择体验版小程序进行调试

上次更新: 10/12/2020, 11:13:04 AM