试用&购买授权

商米人脸识别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. 点击“删除”，则删除此行人脸记录，此用户将无法被识别。