[TOC]

HHAROME接入文档

更新日志

2024/2/2 更新初始化刷脸，及传参 2024/2/18 更新小程序调试流程和命令 2024/2/20 更新scope注意点 2024/3/8 新增小程序登录代码逻辑、获取设备参数 2024/3/15 新增刷脸1：1人证 2024/3/19 新增语音播报 2024/3/25 更新常见问题 2024/3/26 新增手输身份证号和小票打印 2024/3/27 开启刷二维码监听和刷身份证监听 2024/4/16 更新常见问题 2024/4/23 新增刷证超时和取消、麦克风录音 2024/5/6 新增麦克风录音状态、红外感应 2024/5/9 新增小程序超时 2024/5/12 版式调整 2024/5/13 调整红外感应 2024/6/7 令牌授权的应用不相符问题新增解决方案。预览命令 2024/6/18 新增语音播报最新和语音停止。更新常见问题——物联网卡导致无法进入小程序 2024/6/19 更新常见问题——刷脸初始化失败提示E69015的解决方案 2024/6/24 新增功能双屏异现 2024/6/25 更新常见问题——设备连接有线网络无法进入小程序 2024/6/25 新增社保卡读取功能 2024/6/28 新增NFC 2024/7/01 更新常见问题——读取身份证问题 2024/7/08 更新常见问题 2024/7/16 关闭小程序、显示/隐藏导航栏，禁用/启用通知栏（本次运行有效） 2024/7/18 刷脸入库功能 2024/7/22 更新常见问题 2024/7/29 麦克风功能改版，发送源数据格式从MP3改为PCM，传送方式改为实时传送。 2024/7/31 更新红外感应问题 2024/8/01 CPU卡添加APDU命令数组执行能力。 2024/8/12 麦克风持续监听添加新的返回数据结构。 2024/8/14 更新常见问题——读取身份证问题、小票打印机。 2024/09/12 新增新的身份证阅读器模块。 2024/09/13 新增启动小程序时可配置跳转指定小程序页面。 2024/09/18 新增右上角悬浮按钮,关闭指定appId小程序。

小程序真机调试

开发工具：支付宝小程序开发工具

开发环境安装node，检查版本 >= 16
安装minidev插件，文档地址：https://opendocs.alipay.com/mini/02q17j
1. 安装插件 npm i -g minidev --registry=https://registry.npmmirror.com
2. 更新插件（按需即可） npm update -g minidev && minidev -v
3. 工具授权，终端输入minidev login，小程序开发者支付宝扫码授权
发起真机预览（预览当前的开发代码）
1. 终端指令：minidev remote-debug -c ampe -a [miniprogram_appid] --ampe-device-id [machine_sn] --ampe-product-id [machine_ productId] --ampe-host-app-id [ampe_appid]
2. 示例调试指令：minidev remote-debug -c ampe -a ==2021004113634033(改成服务商需要调试的小程序appid)== --ampe-device-id ==13AK008002200004(改成服务商设备的sn号)== --ampe-product-id 9705850 --ampe-host-app-id 2021004108608975
3. 预览指令：minidev preview -c ampe -a ==2021004113634033(改成服务商需要调试的小程序appid)== --ampe-device-id ==13AK008002200004(改成服务商设备的sn号)== --ampe-product-id 9705850 --ampe-host-app-id 2021004108608975

小程序接入代码

一. 消息发送接收主函数

/******* my.call方法支持小程序发送指令对象 params 给 app ，app 处理完后通过 res 返回，单次有效 *******/
my.call('ampeHHCommunication', params , res => {
    console.log(res)
});

/******* my.on方法支持小程序打开一个持续监听方法，app 会持续发送数据 res *******/
my.on('xxxxxxxxxx', res => {
    console.log(res)
});

二. params指令对象列表

请求参数

字段	是否必填	类型	说明
action	是	String	getQRCode---------二维码, getIDCardInfo-----身份证, getFaceInfo---------刷脸, getDeviceInfo------设备信息
event	是	String	open-开启/close-关闭
taskId	是	String	任务id耗时任务时与其他任务区分比对用
params	是	Object	配置参数，见下文

返回参数

字段	是否必填	类型	说明
action	是	String	与请求action对应
event	是	String	与请求event对应
taskId	是	String	与请求taskId对应
success	是	boolean	success-成功 / false-失败
message	是	String	结果描述
data	是	Object	返回结果数据

==指令是否成功执行可根据 success 参数判断==

==true----解析 data==

==false---处理 message==

1. 刷脸指令

1.1 初始化

/***建议在 app.js 的onLaunch 钩子里执行一次初始化即可（若失败，可以执行 3s 再次尝试初始化操作）***/

let params = {
	"action": "initFace",
	"event": "open",
	"taskId": "12345",
	"params": {
		"serviceId": "",
		"query": "",
		"scope": "auth_user,yingpin"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

字段	类型	说明	是否必填
scope	String	聚合授权参数，scope的值如果有多个，逗号后不要有空格，避免产生弹框不出来或者没有对应要授权的信息展示。正确值示例：auth_user,yingpin	必填
serviceId	String	刷脸参数，无特殊需要不填	非必填
query	String	刷脸参数，无特殊需要不填	非必填

返回值：

初始化调用后约两秒后返回结果，注意增加友好提示

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "initFace",
    "event": "open",
    "success": true,
    "taskId": "12345",
    "message ": "成功",
    "data": {}
	}
	****/
})

action和event的值固定，taskId可自定义

1.2 唤起 1：N 刷脸

let params = {
	"action": "getFaceInfo",
	"event": "open",
	"taskId": "2"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值：

/***extInfo中的authCode就是对应刷脸返回的结果，用来获取用户信息必备值
注意。刷脸失败的时候，success为false，需要展示下messge，防止看起来刷脸了，但没有反应和提示***/

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "getFaceInfo",
    "event": "open",
    "success": true,
    "taskId": "2",
    "message ": "成功",
    "data": {
      "alipayUid": "2088612116677214",
      "code": 1000,
      "extInfo": "{\"authCode\":\"5dc39621fe5a49deb21a87c98876HA21\"}",
      "ftoken": "fp19bcc44f3a8be610d4d6833607201ah99",
      "isvResult": true,
      "subCode": "",
      "subMessage": "",
      "vid": ""
    }
  }
	****/
})

刷脸成功后，会返回authcode（extInfo参数中），然后再去调用支付宝接口获取用户信息需要开发商自己申请带有用户信息三要素权限 https://opendocs.alipay.com/open/a74a7068_alipay.user.info.share?pathHash=af2476d4

刷脸失败，在data里会有originFaceInfo字段，里面是支付宝刷脸返回所有的信息

1.3 唤起 1: 1 刷脸

let params = {
	"action": "getFaceInfoPersonCard",
	"event": "open",
	"taskId": "7",
	"params": {
		"certName": "",
		"certNo": "",
		"certPhotoBase64Str": ""
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

字段	类型	说明	是否必填
certName	String	用户姓名	必填
certNo	String	用户身份证号	必填
certPhotoBase64Str	String	用户头像base64	非必填

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "getFaceInfoPersonCard",
    "event": "open",
    "success": true,
    "taskId": "7",
    "message ": "成功",
    "data": {
      "alipayUid": "2088612116677214",
      "code": 1000,
      "extInfo": "{\"authCode\":\"\"}",
      "ftoken": "fp19bcc44f3a8be610d4d6833607201ah99",
      "isvResult": true,
      "subCode": "",
      "subMessage": "",
      "vid": ""
    }
  }
	****/
})

注意。刷脸失败的时候，success为false，需要展示下messge，防止看起来刷脸了，但没有反应和提示

1.4.1 刷脸入库

仅适用于刷脸信息授权开通（1）通过 authCode 获取 auth_token 商家服务端调用 alipay.system.oauth.token（换取授权访问令牌），通过 authCode 换取 auth_token 。authCode 作为换取 access_token 的票据，authCode 只能使用一次，24 小时未被使用将自动过期。可查看换取 access_token 和 userId。（2）通过 auth_token 获取用户会员信息商家服务端调用 alipay.user.info.share（支付宝会员授权信息查询接口），通过 access_token 获取用户的 userId、昵称、头像等基础信息及手机号、身份证号、姓名等隐私信息。可查看获取用户信息。（3）记录授权成功后的返回参数中[vid]字段，用于绑定关系（授权用户信息：例如姓名、身份证等等）来实现自身业务。（4）机构用户出库 alipay.open.iotvsp.user.delete(机构用户出库)

let params = {
	"action": "doStorageFaceInfo",
	"event": "open",
	"taskId": "7",
	"params": {
		"appid": "",
		"orgOutId": "",
		"componentOutId": ""，
    "isvPid": ""
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

字段	类型	说明	是否必填
appid	String	商户appid	必填
orgOutId	String	机构编码	必填
componentOutId	String	组件编码，示例：老年食堂（day_label_sign_online）	必填
isvPid	String	支付宝平台ISV的PID	必填

注意：下方返回值中data对应的是JSONString，解析格式需注意！！！

返回值：新用户同意授权

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
   /**** todo
  {
	"action": "doStorageFaceInfo",
	"event": "open",
	"success": true,
	"taskId": "7",
	"message ": "成功",
	"data": "{
		"eventType": "rocketResult",
		"eventData": {
			"uid": "",
			"ftoken": "",
			"authCode": "",
			"vid": "",
			"subCode": "SUCCESS",
			"subMessage": "成功",
			"bizId": ""
		}
	}"
}
	****/	
})

返回值：老用戶

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
	"action": "doStorageFaceInfo",
	"event": "open",
	"success": true,
	"taskId": "7",
	"message ": "成功",
	"data": "{
		"eventType": "rocketResult",
		"eventData": {
			"ftoken": "",
			"uid": "",
			"vid": "",
			"subCode": "SUCCESS",
			"subMessage": "成功"
		}
	}"
}
	****/
})

返回值：新用户拒绝授权

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
	"action": "doStorageFaceInfo",
	"event": "open",
	"success": false,
	"taskId": "7",
	"message ": "失败",
	"data": "{
		"eventType": "rocketResult",
		"eventData": {
			"uniqueId": "5644040309543232",
			"subCode": "90001",
			"subMessage": "请走上传个人信息的链路"
		}
	}"
}
	****/
})

1.4.2 刷身份证或手动输入个人信息入库

let params = {
	"action": "doStorageFaceInfo",
	"event": "open",
	"taskId": "7",
	"params": {
		"appid": "",
		"orgOutId": "",
		"componentOutId": "",
		"isvPid": "",
		"uniqueId": "",
		"name": "",
		"certNo": "",
		"phone": ""
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

字段	类型	说明	是否必填
appid	String	商户appid	必填
orgOutId	String	机构编码	必填
componentOutId	String	组件编码，示例：老年食堂（day_label_sign_online）	必填
isvPid	String	支付宝平台ISV的PID	必填
uniqueId	String	操作流水ID（用户拒绝授权返回的字段信息）	必填
name	String	用户姓名	必填
certNo	String	用户身份证	必填
phone	String	用户手机号	选填

返回值：与1.4.1返回的数据格式类似

常见错误码： | 错误码subCode | 错误信息subMessage | 备注 |
| -------------- | ------ | ------------------------------------------------- | | SUCCESS | 成功 | 用户开通成功 | | 90001 | 请走上传个人信息的链路 | 用户刷脸授权开通链路点击拒绝授权时会返回uniqueId，需要走传入身份信息开通链路 | | 90002 | 超时退出 | 20s倒计时结束退出 | | 90003 | 主动退出 | 用户点击右上角关闭按钮退出 | | 90004 | 参数有误 | 参数有误，可能原因如下：1、启动组件缺少必传参 2、刷脸信息授权链路多传uniqueId 3、传入身份信息链路没传uniqueId | | E90612 | ISV信息不存在 | 请咨询对接的支付宝业务同学进行申请 | | E90609 | ISV下线 | 请咨询对接的支付宝业务同学进行申请 | | E90604 | 应用信息不存在 | 请咨询对接的支付宝业务同学进行申请 | | E90201 | 组件不存在 | 请咨询对接的支付宝业务同学进行申请 | | E90204 | 组件下线 | 请咨询对接的支付宝业务同学进行申请 | | E90506 | 只支持机构刷脸入库 | 请咨询对接的支付宝业务同学进行申请 | | E90301 | 机构信息不存在 | 请咨询对接的支付宝业务同学进行申请 | | E90306 | 机构下线 | 请咨询对接的支付宝业务同学进行申请 | | E90305 | 机构关联的身份验证表信息不存在 | 请咨询对接的支付宝业务同学进行申请 | | E90703 | 未签约 | 请咨询对接的支付宝业务同学进行申请 | | E60002 | 网络异常 | 机具端网络连接异常 | | E60001 | BPaaS Service系统异常 | 系统异常 | | Z1006 | 刷脸重试次数超过阈值 | 请咨询对接的支付宝业务同学进行申请 | | Z1208 | 抱歉，无法认出你 | 抱歉，无法认出你没有识别到人脸，稍后重试 |

2.刷身份证

2.1 刷身份证（单次）

let params = {
	"action": "getIDCardInfo",
	"event": "open",
	"taskId": "3",
	"params": {
		"infoType": "base,photo,other"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

请求参数infoType中三个值分别对应data中返回结果

base

"name": "",
"idNum": "",

photo

"photoBase64": "/9j/4AAQSkZJRgABAgAAAQABABntRS5Sj//"

other

"signingOrganization": "杭州市公安局余杭分局",
"address": "杭州市XXX",
"nation": "汉",
"sex": "男",
"beginTime": "20230529",
"endTime": "20430529",
"birthDate": "19800101",

返回值-成功

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "getIDCardInfo",
    "event": "open",
    "success": true,
    "taskId": "3",
    "message ": "成功",
    "data": {
      "name": "姓名",
      "idNum": "身份证号",
      "signingOrganization": "杭州市公安局余杭分局",
      "address": "杭州市XXX",
      "nation": "汉",
      "sex": "男",
      "beginTime": "20230529",
      "endTime": "20430529",
      "birthDate": "19800101",
      "photoBase64": "/9j/4AAQSkZJRgABAgAAAQABABntRS5Sj//"
    }
  }
	****/
})

字段	类型	说明
name	String	姓名
idNum	String	身份证号
signingOrganization	String	签发机关
address	String	地址，注意门牌号返回的１３８，正常的数字是138。可能会搜索时对应不上
nation	String	民族
sex	String	性别
beginTime	String	有效期开始时间
endTime	String	有效期截止时间
birthDate	String	出身年月日
photoBase64	String	头像base64

返回值-15s 未刷证超时

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "getIDCardInfo",
    "data": {},
    "event": "open",
    "message": "超时",
    "success": false,
    "taskId": "3"
  }
	****/
})

2.2 关闭刷身份证（单次）

let params = {
	"action": "closeIDCardInfo",
	"event": "open",
	"taskId": "3",
	"params": {
		"infoType": "base,photo,other"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

若是持续监听时要关闭，my.on可以不写，不处理返回数据，会在app程序关闭时，自动处理关闭

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "closeIDCardInfo",
    	"data": {},
    	"event": "close",
    	"message": "关闭成功",
    	"success": true,
    	"taskId": "3"
    }
	****/
})

2.3 开启刷身份证监听（持续）

在线识别的暂不可用，离线识别可用该监听开启后，持续监听。若有刷身份证，则会回调以下函数。

my.on('initIDCardListener',res =>{
    console.log('刷身份证监听'，res.data)
})

返回结果同——刷身份证（单次）中的data

3.二维码

小程序代码生成二维码

3.1 开启刷二维码（单次）

请求一次，返回一次。无法持续监听

let params = {
	"action": "getQRCode",
	"event": "open",
	"taskId": "3"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "getQRCode",
    	"event": "open",
    	"success": true,
    	"taskId": "1",
    	"message ": "成功",
    	"data": {
    		"qrCode": "11"
    	}
    }
	****/
})

字段	类型	说明
qrCode	String	刷二维码返回的结果

3.2 开启刷二维码监听（持续）

开启后，持续监听。若有刷码，则会回调以下函数

my.on('initQRListener',res =>{
    console.log('刷二维码监听'，res.data)
})

返回结果同“开启刷二维码返回”中的data

4.麦克风

4.1 开启麦克风（持续），app持续发录音数据给小程序

先通过my.call的startMicrophoneListener开启录音，在my.on中持续接收（只需要开启一次），最后通过my.call的stopMicrophoneListener停止录音

4.1.1 开启麦克风监听

let params = {
	"action": "startMicrophoneListener",
	"event": "open",
	"taskId": "3",
	"params": {
           "intervalTime": 1000 ,//2.9.0版本及之后版本已废弃该字段
           "isMicrophoneSourceData":false //2.9.8版本添加
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

4.1.2 麦克风持续监听

返回值一：isMicrophoneSourceData=false

my.on('initMicrophoneListener',res =>{
    console.log('麦克风监听'，res.data)
 /**** todo
  {
    	"data": {
    		"voiceContent": "BwAHAAcABwAHAA=\n"
    	}
    }
	****/
})

返回值二：isMicrophoneSourceData=true

my.on('initMicrophoneListener',res =>{
    console.log('麦克风监听'，res.data)
 /**** todo
  {
    	"data": {
    	"voicecontent":"[-106,-1,-62.....]"
    	}
    }
	****/
})

字段	类型	说明
voiceContent	String（base64）	使用麦克风说话返回的结果，原始数据为采样率16K，采样位宽16bit的PCM。byte[]-->base64
isMicrophoneSourceData	boolean	是否返回源格式byte[]，true:byte[]字符串格式传输，false：byte[]转换为base64格式传输

4.1.3 停止麦克风监听

let params = {
	"action": "stopMicrophoneListener",
	"event": "open",
	"taskId": "3"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
	"action": "stopMicrophoneListener",
	"event": "open",
	"success": true,
	"taskId": "3",
	"message ": "成功",
	"data": {
	}
  }
	****/
})

4.2.1开启麦克风（单次）已废弃（2.9.0版本及之后版本）

单次录音生成一整个mp3格式，转换后返回

let params = {
	"action": "startMicrophone",
	"event": "open",
	"taskId": "1"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
    {
    	"action": "startMicrophone",
    	"event": "open",
    	"success": true,
    	"taskId": "1",
    	"message ": "成功",
    	"data": {
    	}
    }
	****/
})

4.2.2 结束麦克风并返回录音结果（单次）已废弃（2.9.0版本及之后版本）

let params = {
	"action": "stopMicrophone",
	"event": "open",
	"taskId": "1"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "stopMicrophone",
    	"event": "open",
    	"success": true,
    	"taskId": "1",
    	"message ": "成功",
    	"data": {
    		"voiceContent": "11"
    	}
    }
	****/
})

字段	类型	说明
voiceContent	String（base64）	使用麦克风说话返回的结果，原始数据为采样率16K，采样位宽16bit的mp3。mp3-->byte[]-->base64

4.3 麦克风录音状态已废弃（2.9.0版本及之后版本）

当小程序崩溃，或者退出小程序时，录音可能还在继续。小程序可先通过该接口获取录音状态。如果在录音需要先停止，再开启

let params = {
	"action": "getMicrophoneState",
	"event": "open",
	"taskId": "1"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    "action": "getMicrophoneState",
    "event": "open",
    "success": true,
    "taskId": "1",
    "message ": "成功",
    "data": {
        "microphoneListenerState": 1,
        "microphoneState": 1
    }
   }
	****/
})

字段	类型	说明
microphoneListenerState	int	是否持续录音状态，1是在录音，0是不
microphoneState	int	是否单次录音状态，1是在录音，0是不

5.设备信息

5.1开启设备信息请求

let params = {
	"action": "getDeviceInfo",
	"event": "open",
	"taskId": "4"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
    {
    	"action": "getDeviceInfo",
    	"event": "open",
    	"success": true,
    	"taskId": "4",
    	"message ": "成功",
    	"data": {
    		"sn": "设备sn",
    		"deviceModel": "设备型号",
    		"appVersion": "app版本号",
    		"androidVersion": "7.1.2",
    		"deviceIP": "192.168.1.1",
    		"devicedDisplay": "设备固件号"
    	}
    }
	****/
})

字段	类型	说明
sn	String	设备sn
deviceModel	String	deviceModel
appVersion	String	app版本号
androidVersion	String	Android版本号
deviceIP	String	设备ip
devicedDisplay	String	设备固件号

6. 语音播报请求

6.1 语音播报请求


let params = {
	"action": "speech",
	"event": "open",
	"taskId": "8",
	"params": {
		"text": "要播报的文字内容",
		"pitch": 1.0f,
		"rate": 1.0f,
		"speechQueue": 0
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定，taskId可自定义 请求参数：

字段	类型	说明	是否必填
text	String	要播报的文字内容	必填
pitch	float	设置音调，值越大声音越尖（女声），值越小则变成男声，1.0f是常规	非必填
rate	float	设置语速，1.0f是常规	非必填
speechQueue	int	设置当前播报是否打断上次播报。0表示播完上次才开始播当前。1表示打断上一次播报内容，播报当前	非必填，默认0

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "speech",
    	"event": "open",
    	"success": true,
    	"taskId": "8",
    	"message ": "成功",
    	"data": {
    	}
    }
	****/
})

6.2 语音停止请求


let params = {
	"action": "speechStop",
	"event": "open",
	"taskId": "8"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
    {
    	"action": "speechStop",
    	"event": "open",
    	"success": true,
    	"taskId": "8",
    	"message ": "成功"
    }
	****/
})

7. 手输身份证号

7.1 手输身份证号


let params = {
	"action": "enterIDNumber",
	"event": "open",
	"taskId": "9"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "enterIDNumber",
    	"event": "open",
    	"success": true,
    	"taskId": "9",
    	"message ": "成功",
    	"data": {
    	    "idNum": "410922199611150054",
    		"alipayUid": "2088132815051624",
    		"code": 1000,
    		"extInfo": "{\"authCode\":\"\"}",
    		"ftoken": "fp1142504423f1f6fa7a618313e23919h60",
    		"isvResult": true,
    		"subCode": "OK_SUCCESS",
    		"subMessage": "SUCCESS",
    		"vid": ""
    	}
    }
	****/
})

超时返回，message返回手输证件号超时取消返回，message返回取消手输证件号

8. 小票打印机小程序

8.1 小票打印机小程序


let params = {
    	"action": "receiptPrinting",
    	"event": "open",
    	"taskId": "10",
    	"params": {
    		"printList": [{
    			"text": "测试文字打印",
    			"textSize": 26,
    			"bold": false,
    			"algin": "left"
    		}, {
    			"imageBase64": "测试图片打印，实际传入base64图片值/9j/4AAQSkZJRgABAgAAAQABABntRS5Sj//",
    			"width": 376,
    			"height": 376
    		}]
    	}
    }
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定，taskId可自定义

请求参数：

字段	类型	说明	是否必填
text	String	打印的文字内容，默认""	必填
textSize	int	字体大小，默认26	必填
bold	Boolean	是否加粗，默认false	必填
algin	String	对齐方式，默认left，left -左对齐 center -居中 right -右对齐	必填
imageBase64	String	Base64图片，不需要前缀，默认""	必填

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
   {
        	"action": "receiptPrinting",
        	"event": "open",
        	"success": true,
        	"taskId": "10",
        	"message ": "成功",
        	"data": {
        	}
        }
	****/
})

9. 小程序超时

9.1 小程序超时

在app.js中的onLaunch中写

my.on('ampeOperationTimeout', e => {
console.log("小程序超时", e);
})

然后在需要倒计时的地方去发送ampeStartOperationWatcher指令

my.call('ampeStartOperationWatcher', {}, res => {
    console.log(res)
});

超时时间配置，需要进app的设置，输入密码，功能配置，里面可以配置时间，默认30秒。如果不需要该超时功能，设置0即可。设置完时间后，设备重启，以便配置生效

10. 红外感应

先通过my.call的startInfraredInductionListener开启红外感应，在my.on中持续接收（只需要开启一次），最后通过my.call的stopInfraredInductionListener停止红外感应

10.1 开启红外感应监听

let params = {
	"action": "startInfraredInductionListener",
	"event": "open",
	"taskId": "3",
	"params": {
		"intervalTime": 3000
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

请求参数

字段	类型	说明	是否必填
intervalTime	int	间隔多久返回红外感应信息，（取值范围2000-5000，建议3000）毫秒	非必填，默认3000

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
  	"action": "startInfraredInductionListener",
  	"event": "open",
  	"success": true,
  	"taskId": "3",
  	"message ": "成功",
  	"data": {
  	}
  }
	****/
})

10.2 红外感应持续监听

my.on('initInfraredInductionListener',res =>{
    console.log('红外感应监听'，res.data)
})

返回值

 {"inductionCode":"1"}

字段	类型	说明
inductionCode	int	1是代表感应到有人，0是未感应到

10.3 停止红外感应监听

let params = {
	"action": "stopInfraredInductionListener",
	"event": "open",
	"taskId": "3"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
	"action": "stopInfraredInductionListener",
	"event": "open",
	"success": true,
	"taskId": "3",
	"message ": "成功",
	"data": {
	}
  }
	****/
})

红外感应持续返回的数据，在my.on中

11. 双屏异显

11.1 副屏显示不同页面


let params = {
	"action": "openSecondaryScreen",
	"event": "open",
	"taskId": "11",
	"params": {
		"secondaryScreenBase64": "xx"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

请求参数

字段	类型	说明	是否必填
secondaryScreenBase64	String	图片的base64	必填

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "openSecondaryScreen",
    	"event": "open",
    	"success": true,
    	"taskId": "11",
    	"message ": "成功",
    	"data": {
    	}
    }
	****/
})

11.2 副屏关闭不同页面


let params = {
	"action": "closeSecondaryScreen",
	"event": "open",
	"taskId": "12"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "closeSecondaryScreen",
    	"event": "open",
    	"success": true,
    	"taskId": "12",
    	"message ": "成功",
    	"data": {
    	}
    }
	****/
})

11.3 获取副屏显示关闭的状态


let params = {
	"action": "getSecondaryScreenState",
	"event": "open",
	"taskId": "13"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

返回值：

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
  {
    	"action": "getSecondaryScreenState",
    	"event": "open",
    	"success": true,
    	"taskId": "13",
    	"message ": "成功",
    	"data": {
    	    "getSecondaryScreenState": 0
    	}
    }
	****/
})

返回参数

字段	类型	说明	说明
getSecondaryScreenState	int	副屏状态	显示1 close 0 没加载到副屏-1

12.社保卡

12.1 读取社保卡信息（单次）

请求一次，返回一次。无法持续监听

let params = {
	"action": "getSocialSecurityCardInfo",
	"event": "open",
	"taskId": "14"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "getSocialSecurityCardInfo",
        "event": "open",
        "success": true,
        "taskId": "14",
        "message ": "成功",
        "data": {
                 "cardNumber": "",
                 "name": "",
                 "sex": "",
                 "idNumber": "",
                 "birthDate": "",
                 "issueDate": "",
                 "expireDate": "",
                 "nation": "",
                 "cityCode": "",
                 "address": "",
                 "fullVersion": ""
        }
    }
	****/
})

字段	类型	说明
cardNumber	String	卡号
name	String	姓名
sex	String	性别
idNumber	String	社会保障号码
birthDate	String	出生日期
issueDate	String	发证日期
expireDate	String	有效日期
nation	String	民族
cityCode	String	城市代码
address	String	地址
fullVersion	String	社保卡版本

12.2 获取社保卡配置信息（单次）

请求一次，返回一次。无法持续监听

let params = {
	"action": "socialSecurityCardConfig",
	"event": "open",
	"taskId": "15"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "socialSecurityCardConfig",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
    }
	****/
})

12.3 开启社保卡读取监听（持续）

开启后，持续监听。若读取社保卡信息，则会回调以下函数

my.on('socialSecurityCardListener',res =>{
    console.log('读取社保卡信息'，res.data)
})

返回值

my.on('socialSecurityCardListener',res =>{
    console.log('读取社保卡信息'，res.data)
  /**** todo
 {
        "data": {
                 "cardNumber": "",
                 "name": "",
                 "sex": "",
                 "idNumber": "",
                 "birthDate": "",
                 "issueDate": "",
                 "expireDate": "",
                 "nation": "",
                 "cityCode": "",
                 "address": "",
                 "fullVersion": ""
        }
    }
	****/
})

字段	类型	说明
cardNumber	String	卡号
name	String	姓名
sex	String	性别
idNumber	String	社会保障号码
birthDate	String	出生日期
issueDate	String	发证日期
expireDate	String	有效日期
nation	String	民族
cityCode	String	城市代码
address	String	地址
fullVersion	String	社保卡版本

13.NFC

CPU卡

监听卡片是否放置步骤： ①.开启监听（startCPUCardLoopRead） ②.接收监听结果（CPUCardListener） ③.关闭监听（stopCPUCardLoopRead）
单次对卡片进行单条APDU命令操作步骤：

①.获取卡信息"上电"（readOnceCPUCardInfo） ②.执行APDU命令一（sendCPUCardCommand） ③.执行APDU命令二（sendCPUCardCommand） ④.命令三、命令四....
单次对卡片进行多条APDU命令操作步骤：

①.获取卡信息"上电"（readOnceCPUCardInfo） ②.执行APDU命令集（sendCPUCardApduCommands）

注意：①.部分类型卡片时间间隔不能过长，执行命令时酌情删减使用。
②.单次对卡片进行APDU命令操作时，请先停止监听（stopCPUCardLoopRead）！！！

PSAM卡

单次对PSAM卡进行操作步骤： ①.冷复位（psamCardColdReset） ②.执行APDU命令（sendCPUCardCommand）

13.1 开启监听（startCPUCardLoopRead）

请求一次，返回一次。无法持续监听

let params = {
	"action": "startCPUCardLoopRead",
	"event": "open",
	"taskId": "15",
	"params": {
		"intervalTime": "1000",
    "isComeBackFailed":true //2.9.8版本添加
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

请求参数

字段	类型	说明	是否必填
intervalTime	Integer	同卡推送间隔时间(ms),默认1000ms	选填
isComeBackFailed	boolean	是否返回寻卡失败结果，true:返回寻卡失败结果	选填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "startCPUCardLoopRead",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
    }
	****/
})

13.2 接收监听结果（CPUCardListener）

开启后，持续监听。若读取CPU卡信息，则会回调以下函数

my.on('CPUCardListener',res =>{
    console.log('CPU卡信息'，res.data)
})

返回值

my.on('CPUCardListener',res =>{
    console.log('CPU卡信息'，res.data)
/**** todo
 {
    "data": {
      "nfc_cardInfo": "1078809002209000000000002E20419F",
      "code":0  //2.9.8版本添加
    }
 }
****/
})

字段	类型	说明
nfc_cardInfo	String	cpu卡读取信息
code	Integer	-1:寻卡失败，0：成功

13.3 关闭监听（stopCPUCardLoopRead）

请求一次，返回一次。无法持续监听

let params = {
	"action": "stopCPUCardLoopRead",
	"event": "open",
	"taskId": "15"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "stopCPUCardLoopRead",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
    }
	****/
})

13.4 获取卡复位信息"上电"（readOnceCPUCardInfo）

请求一次，返回一次。无法持续监听

let params = {
	"action": "readOnceCPUCardInfo",
	"event": "open",
	"taskId": "15"
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "readOnceCPUCardInfo",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功",
        "data": {
         "nfc_cardInfo": "1078809002209000000000002E20419F"
        }
    }
	****/
})

字段	类型	说明
nfc_cardInfo	String	cpu卡读取信息

错误码 | 错误码 | 说明 | | ------ | ---------- | | -1 | 初始化失败 | | -2 | 寻卡失败 | | -3 | 防碰撞失败 | | -4 | 选卡失败 | | -5 | 上电失败 |

错误示例


 {
    "action": "readOnceCPUCardInfo",
    "event": "open",
    "success": true,
    "taskId": "15",
    "message ": "成功"
    "data": {"nfc_cardInfo": "-1"}
}

13.5 执行APDU命令（sendCPUCardCommand）

请求一次，返回一次。无法持续监听

let params = {
	"action": "sendCPUCardCommand",
	"event": "open",
	"taskId": "15",
	"params": {
		"commandApdu": "0084000008",
		"type": "1",
		"slot": "1"
		
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

字段	类型	说明	是否必填
commandApdu	String	APDU命令	必填
type	Integer	1-CPU卡命令，2-PSAM卡命令	必填
slot	Integer	选择卡槽（1-SAM1，2-SAM2）,默认SAM1，搭配type=2使用	选填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "sendCPUCardCommand",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功",
        "data": {
         "nfc_resultInfo": ""
        }
    }
	****/
})

字段	类型	说明
nfc_resultInfo	String	APDU命令返回结果：<=0执行失败;>0执行APDU命令成功并作为有效数据的长度

错误码 | 错误码 | 说明 | | ------ | ------------ | | -1 | 初始化失败 | | -2 | 执行APDU失败 |

错误示例

 {
    "action": "sendCPUCardCommand",
    "event": "open",
    "success": true,
    "taskId": "15",
    "message ": "成功"
    "data": {"nfc_resultInfo": "-1"}
}

13.6 执行APDU命令集（sendCPUCardApduCommands）

请求一次，返回一次。无法持续监听

let params ={
	"action": "sendCPUCardApduCommands",
	"event": "open",
	"taskId": "15",
	"params": {
		"commandApdus": ["0084000008", "0084000008", "0084000008"],
		"type": "1",
		"slot": "1"

	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

字段	类型	说明	是否必填
commandApdus	String[]	APDU命令集	必填
type	Integer	1-CPU卡命令，2-PSAM卡命令	必填
slot	Integer	选择卡槽（1-SAM1，2-SAM2）,默认SAM1，搭配type=2使用	选填

返回值：执行成功

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "sendCPUCardApduCommands",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
        "data": {
         "nfc_commandResults": ["A8742A99CB4F90189000","D4C111A02852E9C09000","5E60C64C6E436E6A9000"]
        }
    }
	****/
})

字段	类型	说明
nfc_commandResults	String[]	APDU命令结果

返回值：执行失败

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "sendCPUCardApduCommands",
        "event": "open",
        "success": false,
        "taskId": "15",
        "message ": "失败：-2" //-2为错误码
        "data": {
         "nfc_commandResults": ["A8742A99CB4F90189000","D4C111A02852E9C09000","5E60C64C6E436E6A9000"]
        }
    }
	****/
})

字段	类型	说明
nfc_commandResults	String[]	APDU命令返回结果

错误码 | 错误码 | 说明 | | ------ | ------------ | | -1 | 初始化失败 | | -2 | 执行APDU失败 | | -100 | 执行APDU命令成功但状态不对 |

13.6 冷复位（psamCardColdReset）

请求一次，返回一次。无法持续监听

let params = {
	"action": "psamCardColdReset",
	"event": "open",
	"taskId": "15",
	"params": {
		"slot": "1"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

请求参数

字段	类型	说明	是否必填
slot	Integer	选择卡槽（1-SAM1，2-SAM2）,默认SAM1	选填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "psamCardColdReset",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
        "data": {
         "nfc_resultInfo": ""
        }
    }
	****/
})

字段	类型	说明
nfc_resultInfo	String	冷复位命令返回结果

错误码 | 错误码 | 说明 | | ------ | ---------- | | -1 | 初始化失败 | | -2 | 冷复位失败 |

错误示例

 {
    "action": "psamCardColdReset",
    "event": "open",
    "success": true,
    "taskId": "15",
    "message ": "成功"
    "data": {"nfc_resultInfo": "-1"}
}

13.7 蜂鸣器（startBuzzer）

请求一次，返回一次。无法持续监听

let params = {
	"action": "startBuzzer",
	"event": "open",
	"taskId": "15"
	"params": {
		"beep": "50"
	}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

请求参数

字段	类型	说明	是否必填
beep	Integer	蜂鸣器时长	必填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "startBuzzer",
        "event": "open",
        "success": true,
        "taskId": "15",
        "message ": "成功"
    }
	****/
})

14.关闭小程序、显示/隐藏导航栏，禁用/启用通知栏（仅本次运行有效）

请求一次，返回一次。无法持续监听

let params = {
	"action": "deviceConfig",
	"event": "open",
	"taskId": "15"
	"params":{
	"deviceConfig": {
		"exitApplet": 1,
		"hideNavigationBar": 1,
		"hindeNotificationBar": 1
	}
}
}
my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

请求参数

字段	类型	说明	是否必填
exitApplet	Integer	关闭小程序：1-关闭	选填
hideNavigationBar	Integer	导航栏：1-隐藏 2-开启	选填
hindeNotificationBar	Integer	通知栏：1-禁用 2-开启	选填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "deviceConfig",
        "event": "open",
        "success": true,
        "taskId": "16",
        "message ": "成功"
    }
	****/
})

15.右上角悬浮关闭小程序按钮（根据指定AppId）

请求一次，返回一次。无法持续监听

let params = {
	action: "floatingExitButton",
	event: "open",
	taskId: "16"
  params:{
          isOpen: true,
          appId: "1234567"
       }
}

my.call("ampeHHCommunication", params, (res)=>{
  //todo
})

action和event的值固定如上，taskId可自定义

请求参数

字段	类型	说明	是否必填
isOpen	Boolean	是否打开右上角悬浮按钮，true:打开 false:关闭	必填
appId	String	小程序appId，isOpen=true时必填	选填

返回值

my.call("ampeHHCommunication", params, (res)=>{
  console.log(res)
  /**** todo
 {
        "action": "floatingExitButton",
        "event": "open",
        "success": true,
        "taskId": "16",
        "message ": "成功"
    }
	****/
})

调试运行常见问题

如何判断小程序运行在AMPE 设备上还是手机端

my.getSystemInfo({
	success: (res) => {
			// 判断获取设备系统信息中arome.deviceId参数是否为空
			if (res.arome_deviceId != null) { 
          	//todo 设置信标，当前为 ampe 设备
        		//todo 获取用户信息
        		my.call(...)
          }else{          
              //todo 设置信标，当前为手机端 
            	//todo 获取用户信息
              my.getAuthCode({              
                  scopes: 'auth_user',              
                  success: res => {                
                      const authCode = res.authCode;                   
                  });                  
              }    
        }    
  fail: (err) => {        
      console.log(err);    
      }
  })

获取设备参数（包含设备号、当前小程序运行环境）

my.getSystemInfo({
    success: (res) => {
        console.log(res);
    },
    fail: (err) => {
        console.log(err);
    }
})

success结果

{
    "apiLevel": 31,
    "app": "alipay",
    "appMode": "normal",
    "bluetoothEnabled": false,
    "bluetoothAuthorized": true,
    "brand": "Redmi",
    "cameraAuthorized": true,
    "currentBattery": "46%",
    "fontSizeSetting": 16,
    "isIphoneXSeries": false,
    "language": "zh-Hans",
    "locationAuthorized": true,
    "locationEnabled": true,
    "microphoneAuthorized": false,
    "model": "Xiaomi M2012K11AC",
    "notificationAuthorized": true,
    "overlayAuthorized": false,
    "performance": "high",
    "pixelRatio": 2.75,
    "platform": "Android",
    "screen": {
        "height": 828, 
        "width": 393
    },
    "screenHeight": 2276,
    "screenWidth": 1080,
    "statusBarHeight": 30,
    "storage": "242 GB",
    "system": "12",
    "titleBarHeight": 48,
    "transparentTitle": false,
    "version": "10.3.50.8100",
    "wifiEnabled": false,
    "windowHeight": 725,
    "windowWidth": 393
}

以上每个参数含义，参考 https://opendocs.alipay.com/mini/api/system-info 中的success 回调函数

运行命令后提示——移动应用未绑定该小程序

1.先必须有个正式版 2.有正式版后，就可以用文档里的小程序调试代码进行真机预览

运行命令后提示——业务请求失败:设备不存在

检查sn有没有错，再检查sn是否有进件授权，@xinxin 授权

运行命令后提示——移动应用未关联设备产品

一般是命令输错，有空格啥的，仔细检查下

真机调试无反应

minidev真机调试是有这个毛病，我们自己调试时也经常遇到，发现最好的解决办法是，重启设备且进入小程序，新增一个终端，再minidev login 登陆一下，再执行真机调试 minidev remote

minidev这两个命令，需要进入小程序后，新增一个终端运行，才能生效

还不行的话。再尝试以下关掉开发者工具，重新打开换好点的wifi

小程序启动后——进度卡在99%，或页面提示“该小程序已暂停服务”

首先检查网络

https://open.alipay.com/ 进开放平台查一下，是不是把小程序暂停了检查小程序类型，不支持支付宝iot小程序，必须是支付宝小程序才行

页面提示ampe启动失败

提供sn号，@xinxin检查进件和配置。若已经进件和配置，查看iot相关的所有安装包（含小程序引擎）是否都已经安装

小程序运行后，卡在小程序服务引擎界面

停在小程序服务引擎界面的话要技术支持查一下，一般都是网络状态不好再重新拉要打开的小程序运行包

调试时，刷脸提示“点击过快”

点击过快可能是由于反复真机预览造成的，反复初始化刷脸。建议重启设备

刷脸提示“关闭服务时找不到当前任务(E69016)”

一般是刷脸未初始化成功，就调用刷脸 1.app确认是否为2.7.5及以后的版本 2.smile版本确认是否为2455及以后的版本 3.建议小程序开发者在 app.js 的onLaunch 钩子里执行一次初始化initFace即可（若失败，可以执行 3s 再次尝试初始化操作）。要等到initFace返回成功后，才能调用刷脸getFaceInfo的指令

刷脸初始化失败。Message提示E69015

点击设备上的IoT，查看smile。一般是smile未安装如果没有，联系厂商人员安装下

刷脸初始化成功，但是没有唤起刷脸页面

1.一般是网络连接问题，建议在小程序页面上增加网络监听提示，方便排查原因 2.启动时的小程序调用了各类刷脸、获取设备信息等初始化指令，再运行mindev调试命令，调试小程序就不会再收到上述的返回结果。解决方案就是启动一个不会各类初始化指令的小程序，再运行调试小程序

刷脸获取用户信息

刷脸成功后，会返回authcode，然后再去调用支付宝接口获取用户信息

刷脸后一直刷脸

提供sn号，@xinxin检查配置，看看是否场景配置政务。

刷脸后无反应

看下刷脸getFaceInfo结果是否有返回。如果有返回，但刷脸失败success为false，展示message

刷脸获取用户信息提示——获取支付宝AccessToken失败:Invalid Arguments,调用接口的应用标识(app_id)与令牌授权的应用不相符

需要开发商自己申请带有三要素权限 https://opendocs.alipay.com/open/a74a7068_alipay.user.info.share?pathHash=af2476d4

如已经提供，@xinxin进行配置和检查要检查下公私钥是不是这个appid下

如果已经配置，且平常使用ok，偶现后，重启可以。那就需要替换成smile6.1.0.2455

支付宝接口获取用户信息接口

需要开发商自己申请带有用户信息三要素权限 https://opendocs.alipay.com/open/a74a7068_alipay.user.info.share?pathHash=af2476d4

刷脸失败

返回系统异常(E69001)，检查smile版本，建议6.1.0

刷脸授权框出现HHK8

由merchantAppid小程序名称决定，检查startBasspass入参当merchantAppid 为空时，会拿初始化用的刷脸应用 appid 的三要素权限，应该是配置问题

进入小程序出现扫码授权弹框

这个扫码弹框，不是我们app端弹出的是支付宝小程序引擎和ampe弹出的，具体由@去央解决处理支付宝技术反馈是触发了my.getauthcode

小程序更新

小程序更新后，在设备上进入小程序，会有更新弹框，然后工作人员点击更新就行

设备使用了物联网卡，导致无法进入小程序

联系去央，找支付宝人员，将支付宝的ip和域名加到了物联网卡的白名单中

设备连接有线网络，导致无法进入小程序

更新小程序引擎版本到10.3.34.725及以后更新smile版本到6.1.0.2455及以后

更新完后，重启

如果还有问题。安装浏览器查看下网络

小程序出错排查日志

1.iot和小程序引擎等apk已安装，且已进件和配置 2.安装下debug的apk版本 3.进入小程序，右上角会有三个小圆点，长按，进入日志上传页面，点确定就行，然后拍下日志ID 4.@对接群中的支付宝技术支持进行排查

ampe小程序与app互通硬件调用对接文档.md 61 KB 永久連結 文件歷史 原始文件

HHAROME接入文档

更新日志

小程序真机调试

小程序接入代码

一. 消息发送接收主函数

二. params指令对象列表

请求参数

返回参数

1. 刷脸指令

1.1 初始化

1.2 唤起 1：N 刷脸

1.3 唤起 1: 1 刷脸

1.4.1 刷脸入库

1.4.2 刷身份证或手动输入个人信息入库

2.刷身份证

2.1 刷身份证（单次）

2.2 关闭刷身份证（单次）

2.3 开启刷身份证监听（持续）

3.二维码

3.1 开启刷二维码（单次）

3.2 开启刷二维码监听（持续）

4.麦克风

4.1 开启麦克风（持续），app持续发录音数据给小程序

4.1.1 开启麦克风监听

4.1.2 麦克风持续监听

4.1.3 停止麦克风监听

4.2.1开启麦克风（单次）已废弃（2.9.0版本及之后版本）

4.2.2 结束麦克风并返回录音结果（单次）已废弃（2.9.0版本及之后版本）

4.3 麦克风录音状态 已废弃（2.9.0版本及之后版本）

5.设备信息

5.1开启设备信息请求

6. 语音播报请求

6.1 语音播报请求

6.2 语音停止请求

7. 手输身份证号

7.1 手输身份证号

8. 小票打印机小程序

8.1 小票打印机小程序

9. 小程序超时

9.1 小程序超时

10. 红外感应

10.1 开启红外感应监听

10.2 红外感应持续监听

10.3 停止红外感应监听

11. 双屏异显

11.1 副屏显示不同页面

11.2 副屏关闭不同页面

11.3 获取副屏显示关闭的状态

12.社保卡

12.1 读取社保卡信息（单次）

12.2 获取社保卡配置信息（单次）

12.3 开启社保卡读取监听（持续）

13.NFC

CPU卡

PSAM卡

13.1 开启监听（startCPUCardLoopRead）

13.2 接收监听结果（CPUCardListener）

13.3 关闭监听（stopCPUCardLoopRead）

13.4 获取卡复位信息"上电"（readOnceCPUCardInfo）

13.5 执行APDU命令（sendCPUCardCommand）

13.6 执行APDU命令集（sendCPUCardApduCommands）

13.6 冷复位（psamCardColdReset）

13.7 蜂鸣器（startBuzzer）

14.关闭小程序、显示/隐藏导航栏，禁用/启用通知栏（仅本次运行有效）

15.右上角悬浮关闭小程序按钮（根据指定AppId）

调试运行常见问题

如何判断小程序运行在AMPE 设备上还是手机端

运行命令后提示——移动应用未绑定该小程序

运行命令后提示——业务请求失败:设备不存在

运行命令后提示——移动应用未关联设备产品

真机调试无反应

小程序启动后——进度卡在99%，或页面提示“该小程序已暂停服务”

页面提示ampe启动失败

小程序运行后，卡在小程序服务引擎界面

调试时，刷脸提示“点击过快”

刷脸提示“关闭服务时找不到当前任务(E69016)”

刷脸初始化失败。Message提示E69015

刷脸初始化成功，但是没有唤起刷脸页面

刷脸获取用户信息

ampe小程序与app互通硬件调用对接文档.md 61 KB

永久連結文件歷史原始文件

4.3 麦克风录音状态已废弃（2.9.0版本及之后版本）