Android-中控指纹仪Live R20 开发注意事项

一.所需设备

• 1.一台支持USB接口的Android设备,某宝上面有的。例如:
  
  (这个屏幕大约32寸，操作系统是Android 5.1,支持触摸,支持USB接口，两个USB接口,支持插网线,支持打王者荣耀，吃鸡等~)
  这个超级重的倒是真的，只能挂墙上打。
• 2.一个或者两个指纹仪，这个指纹仪型号是Live R20的例如：
  
  附带USB接头。

二.所需JAR包

1.导入架包

架包怎么导入自己的Android工程项目里面我就不说了。

2.架包大致核心类

最主要的就是指纹仪管理类，事件监听类，以及指纹算法库了

三.使用方式以及注意事项

1.注意事项

• 1.指纹仪插入设备时候，如果要默认打开自己写的指纹仪软件，请在AndroidManifest.xml的主入口加上相关intent-filter配置。
  
  例如：
  
  
  
  
  
  
  
  
  
  
  

• 2 XML重的 @xml/device_filter 为：
  
  
  
  
  ）

• 3 所保存的指纹数据在APP关闭的时候，会全部丢失!需要自己做本地数据库的缓存，需要保存 byte[]数据。

1.使用方式

• 1.初始化
  
  初始化指纹仪，设置VID和PID
  
  LogHelper.setLevel(Log.WARN);
  Map<String, Object> fingerprintParams = new HashMap<>();
  //设置VID
  fingerprintParams.put(ParameterHelper.PARAM_KEY_VID, VID);
  //设置PID
  fingerprintParams.put(ParameterHelper.PARAM_KEY_PID, PID);
  fingerprintSensor = FingprintFactory.createFingerprintSensor(this, TransportType.USB, fingerprintParams);

• 2.定义采集回调事件
  
  private FingerprintCaptureListener FingerListener1, FingerListener2;

  构造方法:
  
  FingerListener1 = new FingerprintCaptureListener() {
  @Override
  public void captureOK(final byte[] fpImage) {
  runOnUiThread(new Runnable() {
  @Override
  public void run() {
  //任何处理只能在UI线程中进行
  }
  });
  }
  @Override
  public void captureError(FingerprintException e){
  }
  @Override
  public void extractOK(byte[] fpTemplate) {
  //指纹模板采集成功 一般在这里进行算法处理
  }
  @Override
  public void extractError(final int i) {
  }
  };
• 3 开启采集 绑定到指纹仪的管理
  
  try {
  //打开指纹仪1
  fingerprintSensor.open(0);
  //设置监听 将监听绑定到指纹1上面 先绑定监听 在启动异步采集
  fingerprintSensor.setFingerprintCaptureListener(0, FingerListener1);
  //启动采集
  fingerprintSensor.startCapture(0);
  } catch (FingerprintException f) {
  f.fillInStackTrace();
  ToastUtil.showToast("指纹仪1,启动异常!");
  }

• 4 停止采集和释放资源
  
  fingerprintSensor.stopCapture(0);//1.先停止采集
  fingerprintSensor.close(0);//2.关闭指纹仪
  fingerprintSensor.destroy(); //3.释放相关资源

四.API 接口相关

1.FingerprintSensor 指纹仪管理类API

• 1.连接设备：public void open(int index)
• 2.关闭设备：public void close(int index)
• 3.事件关联设备： ublic void setFingerprintCaptureListener(int index,
  FingerprintCaptureListener listener)
• 4.销毁资源:public static void destroy(FingerprintSensor fingerprintSensor)
• 5.获取指纹图像宽：public static int getImageWidth()
• 6.获取指纹图像高：public static int getImageHeight()
• 7.获取指纹模板数据长度：public static int getLastTempLen ()
• 8.设置防假开关(仅支持SILK20R)：public static void setFakeFunOn(int fakeFunOn)
• 9.获取当前指纹状态:public static int getFakeStatus()

2.FingerprintCaptureListener 事件监听类API

• 1.采集图像成功：void captureOK( byte[] fpImage
• 2.采集图像失败：void captureError(FingerprintSensorException e)
• 3.采集模板成功：void ex tractOK( byte[] fpTemplate );
• 4.提取模板失败：void extractError(int errno)

3.ZKFingerService 指纹算法处理类类API

• 1.比对两枚指纹模板：static public int verify(byte[] temp1, byte[] temp2)
• 2.将指纹模板与缓存中指定id的指纹模板进行匹配（即1:1比对），返回匹
  配分数。：static public int verifyId( byte[] temp, String id)
• 3.将指纹模板数据与缓存中的指纹模板数据进行匹配（即1:N比对):static public int identify(byte[] temp, byte []idstr, int threshold, int count)
• 4.合并 3 个指纹模板为登记模板:static public int merge(byte[] temp1, byte[] temp2, byte[] temp3, byte[]
  temp)
• 5.将指纹模板数据保存到缓存。用户将自己数据库中需要用到的指纹数
  据，通过调用save方法保存到缓存中:static public save ( byte[] temp, String id )
• 6.获取缓存中指定 id 的指纹模板数据:static public int get ( byte[] temp, String id )
• 7.从内存中删除登记的指纹模板:static public int del(String id)
• 8.清空缓存中的所有指纹数据:static public int clear ()
• 9.获取缓存中当前存储的指纹模板数:static public int count()

4.FingerprintStatusCode错误类对照表

-20001 打开设备失败

-20002 关闭设备失败

-20003 获取 GPIO 失败

-20004 设置 GPIO 失败

-20005 读 EEPROM 失败

-20006 从 USB 获取图像失败

-20007 探测 USB 图像失败

-20008 输入缓存不够

-20009 读取数据异常

-20010 采集指纹失败

-20011 解密图像数据失败

-20012 启动采集线程失败

-20013 停止采集线程失败

-20014 初始化指纹设备失败

-20015 设置校正参数失败

ERR_NOT_FOUND -5000 没有找到制定 id 指纹模板

ERR_PARAM -5002 参数错误

ERR_TEMPLATE -5003 指纹模板错误

ERR_METHOD -5004 方法错误

五.总 结

其实这里面还是有很多坑的，开始明明登记好的指纹，结果返回到另外一个页面，指纹就没了，指纹仪拔出来，然后指纹又没了，APP重启一下，登记的指纹也没有了，莫名奇妙。
后来发现是需要自己做缓存的，每一次启动，都要进行注册一下，不然就无法进行指纹认证，不过这个的指纹匹配度和灵敏度还是蛮高的，识别率也很高。

踩坑的过程还是蛮有趣的，然后自己又把坑填上，然后再解决，十分有意思。