商米人脸识别SDK的试用和购买都需要获得设备授权,试用授权主要用于调试阶段,一般软件开发方可以免费获得1-3台设备的三个月试用授权,购买授权将获得设备的终身授权。
请联系您的商米销售获取试用授权或者直接购买授权,若无专属销售,请邮件发送详细需求至AI部门(meijuan@sunmi.com)获取试用授权。另,若设备可正常连接wifi,推荐使用第一种远程授权方式,操作更简便快速。
1.授权方式
1.1 远程授权
1.获取设备SN号发送给商米,并保持设备有线网在线(仅支持1.6及以上版本)或wifi在线;
2.商米将通过远程协助功能,发送授权文件至设备,默认路径为” /sdcard/SunmiRemoteFiles/license_face.txt “;
3.重启APP即可试用。
注:1)若三个月免费授权到期,可联系商米继续申请三个月免费授权,一般商米提供试用授权至开发调试结束。
2) 远程授权默认路径为”/sdcard/SunmiRemoteFiles/license_face.txt”, 开发者可根据需求移动授权文件,可以存放在SD卡某个路径下,也可以存放在APP文件路径下 ,能够被正常读取即可。
3)通过wifi在线授权,之后在使用过程中需要保持wifi开关为打开状态(无需联网),通过有线网授权可直接使用。
1.2 离线授权
1. 取设备硬件指纹信息发送给商米,具体有以下两种方式:
方式一:通过调用”商米人脸识别SDK”的接口获取硬件指纹信息,示例代码如下:
String fingerprint = SunmiFaceSDK.getDeviceFingerprint(context);
方式二:通过”adb命令”获取硬件指纹,命令行代码如下(SN示例:E26J117D3520363 ):
adb -s E26J117D3520363 pull /sdcard/device_fingerprint.txt ./
// 注:运行一次demo APP后,在/sdcard下面会生成device_fingerprint.txt,即可获得硬件指纹。
2.商米将根据硬件指纹信息提供授权文件” license_face.txt “;
3.将 ” license_face.txt ” 授权文件上传至APP可读取路径,命令行代码如下:
adb -s E26J117D3520363 push license_face.txt /sdcard/SunmiRemoteFiles
注:1) 需保证wifi开关为打开状态;
2)建议上传至路径”/sdcard/SunmiRemoteFiles/license_face.txt”(与远程授权路径保持一致,若无 SunmiRemoteFiles文件夹,可自行创建);
3)”E26J117D3520363 “为示例SN号,需要修改成当前设备的SN号;
2. Demo试用
2.1 SunmiSDKDemo的安装
Step1:确保adb命令已安装。如没有安装,可参考如下步骤安装。
- Mac:在Terminal终端,使用“brew cask android-platform-tools”命令进行安装。
- Windows:将包含adb工具的文件夹路径配置到环境变量中即可。
安装完成打开cmd终端,输入“adb”命令进行查看,出现版本信息则可正常使用。
Step2:连接商米设备,使用“adb devices”命令查看设备名称。
Step3:使用“cd”命令进入到apk的存放路径,使用“adb -s E26J117D3520363 install app-debug.apk”安装apk。(注:如果设备上已安装人脸识别apk,则会显示安装失败,apk的名称已最新发布为准)。
Step4:获取授权,保持设备在线并发送SN号给商米,可远程获取授权。
具体可参考上文授权方式,若无法连接wifi,可使用离线授权方式。
Step5:使用“adb -s E26J117D3520363 logcat”命令查看log。(adb logcat > 1.log保存至本地)
2.2 SunmiSDKDemo的使用
在Demo使用前,请打开apk的所有权限。开启APP时会显示“初始化人脸识别API成功”,则说明设备已授权,Demo可正常使用。
注:很多错误的原因都是权限问题。
2.2.1 人脸注册
在识别人员身份前,先要为人员进行注册。请被采集人来到摄像头前,使用如下步骤注册人脸到离线人脸库:
- 点击“人脸注册”;
- 输入“会员ID”;
- 点击“开始采集人脸”;
- 点击“为会员拍照”。
2.2.2 人脸识别
人脸识别模块主要包含实时识别功能,具体操作步骤如下:
- 点击“人脸识别”;
- 点击“开始识别”, 如检测到人脸库中人员,屏幕左上方将显示人员入库时的原始照片;否则会显示“该用户尚未注册为会员”。
注:1)建议使用红外摄像头进行人脸识别时,非使用状态下及时退出APP ,防止长时间使用导致摄像头过热损坏。
2)若正常人脸识别过程中, 屏幕左上方显示“未检测到人脸特征”,需检查授权文件是否有效。
2.2.3 人证比对
人证比对模块包含“拍摄身份证比对”和“选择身份证照片”比对两个功能,具体操作步骤如下:
拍摄身份证比对:
- 点击“拍摄身份证”;
- 点击“开始核验”,可实时进行比对,并在左上方显示比对结果。
选择身份证照片比对:
- 通过“浏览”获取照片路径;
- 点击“获取身份证照片特征”进行特征提取,提取成功之后会直接进入到识别界面;
- 点击“开始核验”,可实时进行比对,并在左上方显示比对结果。
2.2.4 人脸库管理
人脸库管理模块主要包括人脸注册信息的搜索、查看和删除等基本功能。
- 输入查询的用户名,点击“搜索”进行人脸记录查询;
- 对于单行人脸记录,点击“查看”,则显示人脸注册时录入的照片;
- 点击“删除”,则删除此行人脸记录,此用户将无法被识别。