Android开发文档
# Android 开发文档
# 手写签字
注意
2 种方式任选 1 种即可
# 浮窗方式
# 新建签字窗体对象
SignWindow (Context ct, int w, int h)
使用方式：new
入参：Context，窗体宽度，窗体高度返回：签字窗体对象
# 设置签字图片完成监听
void setImageConmpletelListener(SignListener captureListener)
使用方式：SignWindow 对象方法
入参：SignListener 接口对象，新建此接口，实现其方法，在方法中获取返回数据（详见 3） 返回：空
接口 onCaptureComplete 方法
void onCaptureComplete(Bitmap bitmap, List< SignPoint > points)
参数 1：返回的签字图片Bitmap
参数 2：返回的签字点对象列表（对象属性见下表）
# 表1
| 参数 | 数据类型 | 含义 | 值说明 |
|---|---|---|---|
| action | int | 签字点类型 | 0:按下；1:离开；2:移动 |
| timestamp | long | 签字时间戳 | |
| x | float | 签字x 坐标 | |
| y | float | 签字y 坐标 | |
| pressure | float | 签字压力值 | 0~2047 |
void onCancel();
入参：无返回：空
# 设置签字笔宽度
void setPaintWidth(float mMinWidth, float mMaxWidth)
使用方式：SignWindow 对象方法入参：最小宽度，最大宽度
返回：空
# 设置签字笔颜色
void setPaintColor (int color)
使用方式：SignWindow 对象方法入参：颜色值
返回：空
# 显示签字窗体
void show(Activity activity)
使用方式：SignWindow 对象方法入参：Activity
返回：空
# 隐藏签字窗体
void dismiss ()
使用方式：SignWindow 对象方法入参：无 返回：空
# 签字控件方式
# 引用签字控件
使用方式：在布局中引用SignView 控件
# 设置签字笔颜色
void setPenColor(int color)
使用方式：SignView 控件方法入参：颜色值
返回：空
# 设置签字笔最小宽度
void setMinWidth(float minWidth)
使用方式：SignView 控件方法入参：最小宽度值
返回：空
# 设置签字笔最大宽度
void setMaxWidth(float maxWidth)
使用方式：SignView 控件方法入参：最大宽度值
返回：空
# 获取签字 Bitmap
Bitmap getSignatureBitmap()
使用方式：SignView 控件方法入参：无
返回：签字Bitmap
# 获取所有签字点对象
List<SignPoint> getAllPoints()
使用方式：SignView 控件方法入参：最大宽度值
返回：签字点对象列表（属性见表 1）
# 清空签字
void clear()
使用方式：SignView 控件方法入参：无
返回：空
# 指纹采集
# 新建指纹助手
FingerHelper (Context context)
使用方式：new 入参：Context
返回：指纹助手对象
# 设置指纹采集监听
void setFingerListener (FingerListener listener)
使用方式：FingerHelper 对象方法
入参：指纹采集监听，实现其方法，在此方法中获取返回数据（详见 3）
返回：空
# FingerListener 接口方法
void onCatched(int quality, Bitmap image, byte[] fingerData)
参数 1：指纹质量
参数 2：指纹图片bitmap
参数 3：指纹图片字节数组数据
void onError(int code, String msgStr)
参数 1：错误代码参数 2：错误信息
# 打开指纹设备
int open()
使用方式：FingerHelper 对象方法入参：无
返回：1 打开成功；其他值打开失败。
# 关闭指纹设备
boolean close()
使用方式：FingerHelper 对象方法入参：无
返回：true（关闭成功）、false（关闭失败）
# 采集指纹
void getFingerImage (boolean isLive)
使用方式：FingerHelper 对象方法
入参：true（持续采集）、false（采集一次） 返回：空
# 停止采集
void stopGetFinger ()
使用方式：FingerHelper 对象方法
入参：无返回：空
# 设置指纹颜色
void setFingerColor(int color)
使用方式：FingerHelper 对象方法入参：颜色值[默认红色]
返回：空
# 设置指纹背景颜色
void setFingerBackColor (int color)
使用方式：FingerHelper 对象方法入参：颜色值[默认透明
返回：空
# 释放资源
void release()
使用方式：FingerHelper 对象方法入参：无
返回：空
# 身份证读取
# 获取身份证服务
static CardServer initCardServer(Context context)
使用方式：静态方法，直接调用入参：Context
返回：身份证服务对象
# 设置刷（读）卡监听
void setSwipingCardListener(OnSwipingCardListener swipingCardListener)
使用方式：CardServer 对象方法
入参：读卡监听，实现其swipingCard 方法，在此方法中获取返回数据（详见 3） 返回：空
# 刷卡监听接口 swipingCard 方法
void swipingCard(IDCardInfoBean ic)
返回参数：身份证数据对象，主要属性说明见下表
| 属性名 | 数据类型 | 含义 | 备注 |
|---|---|---|---|
| name | String | 姓名 | |
| sex | String | 性别 | |
| nation | String | 民族 | |
| birth | String | 出生日期 | |
| address | String | 住址 | |
| id | String | 身份证号 | |
| depart | String | 发证机关 | |
| validityTime | String | 有效期限 | |
| imagBase64 | String | 照片 | base64 字符串 |
# 开始读身份证
void OnBnBegin()
使用方式：CardServer 对象方法入参：无
返回：空
# 暂停读身份证
void OnPause()
使用方式：CardServer 对象方法入参：
返回：空
# 继续读身份证
void OnResume()
使用方式：CardServer 对象方法入参：无
返回：空
# 关闭读取功能
void OnClose()
使用方式：CardServer 对象方法入参：无
返回：空
# 人脸比对
# 新建人脸比对管理类
FacePassManager(Context ct, CameraPreview RGBCameraView, CameraPreview IRCameraView, FaceView faceView)
使用方式：new
入参：Context，彩色相机控件，红外相机控件，人脸识别框控件返回：人脸比对管理对象
# 打开相机（开始预览）
void openCamera()
使用方式：FacePassManager 对象方法入参：无
返回：空
# 开始人脸比对
void startFacePass(Bitmap photo, FacePassManager.FacePassListener listener)
使用方式：FacePassManager 对象方法入参 1：包含人脸照片
入参 2：人脸比对监听，实现其 onPacePassed 方法，在此方法中获取返回数据（详见 3） 返回：空
# 接口 onPacePassed 方法
void onPacePassed(int result, float score, float liveScore, Bitmap face)
参数 1：比对结果（值含义见下表） 参数 2：人脸相似度值（越大越相似）
参数 3：活体度值（越大越为活体） 参数 4：抓取的人脸bitmap
| 参数 | 含义 |
|---|---|
| FacePassManager.PASS_RES_SUCCESS | 比对正常（非比对通过，通过与否由相似度值判断） |
| FacePassManager.PASS_RES_IDCARD_NO_FACE | 传入的照片（比如身份中读取的）未识别到人脸 |
| FacePassManager.PASS_RES_PHOTO_NO_IMAGE | 抓取的照片无图像（抓取失败） |
| FacePassManager.PASS_RES_PHOTO_NO_FACE | 抓取的照片未识别到人脸 |
# 停止人脸比对
void stopFacePass()
使用方式：FacePassManager 对象方法入参：无
返回：空
# 设置活体检测使能
void setLivenessEnable(boolean enable)
使用方式：FacePassManager
入参：true（默认，进行活体检测，需要红外相机）、false（不进行活体检测） 返回：空
# 设置彩色相机 VID/PID
void setRgbCameraVidPid(int vid, int pid)
使用方式：FacePassManager 对象方法入参：彩色相机的vid 和pid
返回：空
# 设置红外相机 VID/PID
void setIrCameraVidPid(int vid, int pid)
使用方式：FacePassManager 对象方法入参：红外相机的vid 和pid
返回：空
# 释放资源
void release()
使用方式：FacePassManager 对象方法入参：无
返回：空