活体检测SDK接入说明文档1

【活体检测SDK接入说明】 在移动应用开发中，尤其是涉及到身份验证或支付安全的场景，活体检测是一项重要的技术，用于确保用户是真人而非照片或模型。本篇将详细介绍如何在Android应用中接入并使用活体检测SDK，主要包括SDK的集成、接口使用以及回调监听器的设置。 一、SDK集成 1. 获取SDK 你需要从GitHub或其他指定的源下载SDK的aar（Android Archive）包。下载完成后，将其放入项目工程的`libs`目录下。 2. 手动导入SDK 在你的`app`模块的`build.gradle`文件中，添加对aar包的依赖。示例如下： ```groovy dependencies { // 其他依赖... implementation(name:'alive_detected_libary', ext: 'aar') implementation(name: 'openCVLibrary343-release', ext: 'aar') // OpenCV库依赖 implementation 'com.squareup.okhttp3:okhttp:3.3.1' // OkHttp依赖 implementation 'com.google.code.gson:gson:2.8.5' // Gson依赖 } ``` 确保aar名称和版本号与你下载的版本一致，并添加对OpenCV库和其他可能需要的第三方库的依赖。 二、SDK接口 1. 活体检测功能类 活体检测主要通过`AliveDetector`类来实现。你需要通过`getInstance()`方法获取`AliveDetector`的单例对象，然后使用`init()`方法进行初始化。初始化需要传入`Context`对象、用于相机预览的`NISCameraPreview`视图以及从易盾官网申请的业务ID。 ```java AliveDetector aliveDetector = AliveDetector.getInstance(); aliveDetector.init(this, cameraPreview, businessId); ``` 2. 设置回调监听器 为了获取活体检测的结果，你需要创建一个实现了`DetectedListener`接口的类，并设置为`AliveDetector`的监听器。`DetectedListener`包含以下几个关键方法： - `onReady(boolean isInitSuccess)`：初始化完成后的回调，检查初始化是否成功。 - `onActionCommands(ActionType[] actionTypes)`：接收活体检测动作序列。 - `onStateTipChanged(ActionType actionType, String stateTip)`：实时检测状态变化的回调。 - `onPassed(boolean isPassed, String token)`：检测结果回调，判断是否通过活体检测。 - `onError(int errorCode, String errorMessage)`：错误处理回调，用于捕获检测过程中的异常。 示例： ```java class MyDetectedListener implements DetectedListener { @Override public void onReady(boolean isInitSuccess) { // 初始化完成后的处理 } @Override ... } ``` 3. 开始与停止检测 调用`startDetect()`启动活体检测，`stopDetect()`则用于关闭检测。你可以通过`setTimeOut(long timeout)`设置检测超时时间，`setDebugMode(boolean isDebug)`开启或关闭调试模式，以及`setSensitivity(int sensitivity)`调整动作灵敏度等级。 ```java aliveDetector.setDetectedListener(new MyDetectedListener()); aliveDetector.startDetect(); ``` 三、活体检测动作序列类型枚举 `ActionType`枚举定义了活体检测的动作序列类型。每个值代表不同的检测动作，如摇头、眨眼等。在`onActionCommands()`回调中，你可以接收到这些动作指令序列，以便在应用中提示用户执行相应的动作。 四、注意事项 在实际开发中，确保相机权限已获取，并且在使用相机预览时处理好横竖屏切换的问题。同时，对于网络不佳或设备性能较低的情况，可能需要优化检测流程，以保证用户体验。 总结： 活体检测SDK的接入涉及SDK的获取与导入、初始化、设置监听器以及调用相关方法来控制检测流程。通过理解`AliveDetector`类的接口和`DetectedListener`回调，开发者可以顺利地将活体检测功能集成到Android应用中，提高服务的安全性和用户体验。