试用&购买授权

商米人脸识别SDK的试用和购买都需要获得设备授权,试用授权主要用于调试阶段,一般软件开发方可以免费获得1-3台设备的三个月试用授权,购买授权将获得设备的终身授权。

请联系您的商米销售获取试用授权或者直接购买授权,若无专属销售,请邮件发送详细需求至AI部门(meijuan@sunmi.com)获取试用授权。另,若设备可正常连接wifi,推荐使用第一种远程授权方式,操作更简便快速。

1.授权方式

1.1 远程授权

1.获取设备SN号发送给商米,并保持设备wifi在线;
2.商米将通过远程协助功能,发送授权文件至设备,默认路径为” /sdcard/SunmiRemoteFiles/licence_valid.txt “;
3.重启APP即可试用。

注:1)若三个月免费授权到期,可联系商米继续申请三个月免费授权,一般商米提供试用授权至开发调试结束。
2) 远程授权默认路径为”/sdcard/SunmiRemoteFiles/licence_valid.txt”, 开发者可根据需求移动授权文件,可以存放在SD卡某个路径下,也可以存放在APP文件路径下 ,能够被正常读取即可。

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.商米将根据硬件指纹信息提供授权文件” licence_valid.txt “;

3.将 ” licence_valid.txt ” 授权文件上传至APP可读取路径,命令行代码如下:

adb -s E26J117D3520363 push licence_valid.txt /sdcard/SunmiRemoteFiles

注:1) 需保证wifi开关为打开状态
2)建议上传至路径”/sdcard/SunmiRemoteFiles/licence_valid.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。

2.2 SunmiSDKDemo的使用

在Demo使用前,请打开apk的所有权限。开启APP时会显示“初始化人脸识别API成功”,则说明设备已授权,Demo可正常使用。

注:很多错误的原因都是权限问题。

2.2.1 人脸注册

在识别人员身份前,先要为人员进行注册。请被采集人来到摄像头前,使用如下步骤注册人脸到离线人脸库:

  1. 点击“人脸注册”
  2. 输入“会员ID”
  3. 点击“开始采集人脸”
  4. 点击“为会员拍照”

2.2.2 人脸识别

人脸识别模块包含实时识别和活体识别功能,具体操作步骤如下:

  1. 点击“人脸识别”
  2. 点击“开始识别”, 如检测到人脸库中人员,屏幕左上方将显示人员入库时的原始照片;否则会显示“该用户尚未注册为会员”。
  3. 点击“开启活体检测”,如检测到真人人脸,屏幕左上方如上一步骤显示;否则会显示“未通过活体检测”。
  4. 点击“停止活体识别”则关闭活体检测功能;点击“停止识别”则关闭人脸识别功能。

注:1)建议使用红外摄像头进行人脸识别时,非使用状态及时退出APP防止长时间使用导致摄像头过热损坏。
2)若正常人脸识别过程中, 屏幕左上方显示“未检测到人脸特征”,需检查授权文件是否有效。

2.2.3 人脸库管理

人脸库管理模块主要包括人脸注册信息的搜索、查看和删除等基本功能。

  1. 输入查询的用户名,点击“搜索”进行人脸记录查询;
  2. 对于单行人脸记录,点击“查看”,则显示人脸注册时录入的照片;
  3. 点击“删除”,则删除此行人脸记录,此用户将无法被识别。