安装 CV-Demo.apk 到您的手机，使用测试账号进行登录。
根据您项目依赖的 react-native 库版本，下载对应的 SDK，下载完成解压后将liveness文件夹拷贝至android目录中，与app文件夹同级。
修改liveness目录下 build.gradle 文件，将rn的版本修改为3.4.1
xxxxxxxxxx...dependencies {...api 'ai.advance.mobile-sdk.android:liveness-detection-rn:3.4.1'}
修改android/settings.gradle文件如下，增加对liveness模块的引用
xxxxxxxxxx...include ':app', ':liveness'
如果您项目的com.facebook.react:react-native库版本号大于等于0.60.0，需要在android/gradle.properties文件增加如下配置
xxxxxxxxxxandroid.enableJetifier=true
修改android/app/build.gradle文件，增加库依赖，然后同步gradle完成 SDK 依赖配置
xxxxxxxxxx...android {...}dependencies {...// 增加以下依赖api project(':liveness')}
如果拉取 aar 失败，建议尝试如下操作：
如果您的 gradle 版本小于 7.0，在项目的根目录下build.gradle增加 maven 仓库：
xxxxxxxxxxallprojects {repositories {...maven { url 'https://public-n3.advai.net/repository/maven-releases/' }}}
如果您的项目 gradle 版本大于7.0，在项目的根目录下settings.gradle增加 maven 仓库:
xxxxxxxxxxdependencyResolutionManagement {...repositories {...maven {url 'https://public-n3.advai.net/repository/maven-releases/'}}}
如果上述做法仍然无法拉取 aar，您可以通过下方链接下载 aar，然后手动依赖到项目中：
下方链接以 lib 3.4.1 和 core 5.5 为例，修改链接中的版本号可以下载对应的版本。
liveness/build.gradle中有 SDK 依赖的版本(版本记录)，通过修改版本号来更新SDK：
xxxxxxxxxxdependencies {implementation 'com.android.support:appcompat-v7:28.0.0'// You can view the list of SDK versions for updating the SDK at this link// http://public-n3.advai.net/repository/maven-releases/ai/advance/mobile-sdk/android/liveness-detection-rn/maven-metadata.xmlapi 'ai.advance.mobile-sdk.android:liveness-detection-rn:3.4.1'implementation 'com.android.support.constraint:constraint-layout:2.0.4'}
引入LivenessReactPackage。
在 android/app目录中找到实现了 ReactApplication 的类，默认名称为 MainApplication，增加LivenessReactPackage
xxxxxxxxxximport ai.advance.liveness.sdk.rn.LivenessReactPackage;public class MainApplication extends Application implements ReactApplication {private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {@Overrideprotected List<ReactPackage> getPackages() {return Arrays.<ReactPackage>asList(new MainReactPackage(), new LivenessReactPackage());}...}...}
初始化 SDK。
Market 的可用取值： [Indonesia, India, Philippines, Philippines2, Vietnam, Malaysia, Thailand, BPS, CentralData, Mexico, Singapore, Aksata, Pakistan, Nigeria]
xxxxxxxxxx// 最后一个布尔值代表是否开通的 Global 服务，如果是则设置为 true，反之为 false。NativeModules.LivenessModule.initSDKByLicense("your market",false);
设置检测超时时长
xxxxxxxxxx// 支持设置的入参范围：[10000,60000]，单位：毫秒。默认50000NativeModules.LivenessModule.set3DLivenessTimeoutMills(50000);
自定义返回的图像尺寸
xxxxxxxxxx// 支持设置的入参范围：[300,1000]，单位：像素NativeModules.LivenessModule.setResultPictureSize(600);
用户绑定(强烈建议)。
您可以通过该方法将自己的用户唯一标识传给我们，我们会根据该标识建立映射关系。当遇到问题时，方便同我们进行日志追踪。
xxxxxxxxxxNativeModules.LivenessModule.bindUser("your user id")
开启遮挡检测
遮挡检测默认是关闭状态，如需开启遮挡检测，请在初始化SDK之后调用如下方法设置
xxxxxxxxxxNativeModules.LivenessModule.isDetectOcclusion(true)
校验 license。
license 由您的服务端调用我们 openAPI 获取，启动活体检测之前调用
xxxxxxxxxxNativeModules.LivenessModule.setLicenseAndCheck("your license",(successCode)=>{// license 校验成功，可以启动活体检测},(errorCode)=>{// license 不可用，过期/格式错误/appId未备案})
启动活体检测与获取检测结果。
每次进行活体检测成功后，会返回唯一的 livenessId 和本次检测的 600*600 像素的清晰正面照片。
您需要将 livenessId 传给您的服务端，由服务端调用 openAPI 获取本次检测的分值。
您可以通过 SDK 提供的方法直接获取图片，也可以由服务端调用 openAPI 获取。
xxxxxxxxxx示例代码：NativeModules.LivenessModule.startLiveness((successJsonData)=>{// 该回调表示活体检测成功},(failedJsonData)=>{// 该回调表示活体检测失败或者用户取消了检测})}}
successJsonData数据结构：
|回调参数|类型|解释| |:--:|:--:|:--:| |livenessId|String|本次活体检测图片的 id| |livenessBase64Str|String|本次活体检测采集的 base64 格式的图片(远景)| |nearImageBase64Str|String|本次活体检测采集的 base64 格式的图片(近景)| |transactionId|String|追踪本次活体检测日志的事务id| |eventId|String|通过这个字段可以与我们排查问题| |isPay|Boolean|本次活体检测调用是否收费|
xxxxxxxxxxfailedJsonData 数据结构|回调参数|类型|解释||:--:|:--:|:--:||transactionId|String|追踪本次活体检测日志的事务id||eventId|String|通过这个字段可以与我们排查问题||errorMessage|String|本次活体检测失败的原因||errorCode|String|错误码
国际化
SDK 支持中文，英文，印尼文，越南语，泰国语，印地语，西班牙语 七种语言/语音，跟随手机系统语言自动切换，无需代码设置。
若没有跟随系统语言自动切换 ，请检查手机语言设置，确保【地区】和【语言】均已切换至对应的语言。
若仍然出现语言国际化问题，同时 app 仅支持某种语言，可以通过在android/app/build.gradle中增加如下配置，过滤掉不需要的语言
xxxxxxxxxxandroid {defaultConfig {...resConfigs("in-rID") // 以仅支持印尼语为例}}
运行时权限
必须权限
本 SDK 需要如下权限，并且已经在 aar 的清单文件中做了配置。
xxxxxxxxxx<uses-feature android:name="android.hardware.camera" /><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.CAMERA" />
代码混淆
SDK 已经做好了代码混淆，无需额外增加配置。
关于Androidx
考虑到 Androidx 与 support 包的互斥，本 SDK 的 .aar 全部是 support 包，如果您的项目是 androidX 类包，编译时遇到提示 support 包冲突错误，请将android/app/gradle.properties文件中增加下述配置，重新编译项目即可：
xxxxxxxxxxandroid.enableJetifier=true
SDK 兼容性
armeabi-v7a，arm64-v8aError Code:
| 错误码 | 解释 | 解决办法 |
|---|---|---|
| FACE_MISSING | 检测过程中人脸丢失 | / |
| ACTION_TIMEOUT | 动作超时 | / |
| MULTIPLE_FACE | 检测过程中出现多张人脸 | / |
| AUTH_BAD_NETWORK | 授权请求网络失败 | 翻墙后重试 |
| CHECKING_BAD_NETWORK | 动作结束后图像上传网络请求失败 | 翻墙后重试 |
| DEVICE_NOT_SUPPORT | 该设备不支持活体检测 | 设备无前置摄像头或不可用 |
| USER_GIVE_UP | 用户中途放弃检测 | / |
| UNDEFINED | 未定义的其他错误类型 | / |
| NO_RESPONSE | 请求网络超时 | 1.请检查您的网络;2.请检查是否调用了 init 方法；3.请确认 license 检查返回的是 SUCCESS |
| AUTH_PARAMETER_ERROR | 授权请求参数错误 | 请检查初始化方法传入的 key 是否为 SDK 的，并且确保 Market 匹配 |
| AUTH_IAM_FAILED | 包名未备案 | 在 SaaS 上自主配置(Personal Management -> ApplicationId Management)或联系我们添加 |
| WEAK_LIGHT | 光线太弱 | / |
| STRONG_LIGHT | 光线太强 | / |
| MODEL_ERROR | 模型错误 | / |
| ALREADY_INIT | 重复加载 | / |
| NO_UPLOAD_IMAGE | 截取最佳上传图片失败 | / |
| AUTH_TICKET_DISABLE | Ticket过期 | / |
| AUTH_ACCOUNT_ACCESS_DENIED | 拒绝访问此帐户 | / |
| ...(Other server side error codes) |
NoSuchMethodError
如果你遇到这样的错误：
java.lang.NoSuchMethodError: No virtual method putArray(Ljava/lang/String;Lcom/facebook/react/bridge/WritableArray;)V in class Lcom/facebook/react/bridge/WritableNativeMap; or its super classes (declaration of 'com.facebook.react.bridge.WritableNativeMap'请将集成方式改成如下：
xxxxxxxxxxai.advance.mobile-sdk.android:liveness-detection-rn-74:3.4.1
错误产生的原因是SDK使用了低版本的RN编译，集成SDK的项目使用的RN版本比较高，在编译时出现错误. 为了解决此问题，我们使用RN 0.74重新编译了一次SDK, RN官方推荐使用JDK17，过高或者过低可能都会出现其他错误，所以请确保当使用此种集成方式时你的JDK为17.