活体检测 SDK 升级指南 (2D)

V2.2.1(2024.4.23)

New Features
Migration Guides
  1. 将依赖版本号修改为2.2.1

  1. 我们发现 LivenessActivity 这个类名被 Kaspersky 等平台标记为风险,请您务必修改此类名为其他名称,以解决Not-a-virus:HEUR:RiskTool.AndroidOS.SpyLoan.fk警告

V2.2.0(2024.2.23)

New Features
Migration Guides
  1. 将依赖版本号修改为2.2.0

V2.1.9(2024.1.23)

New Features
Migration Guides
  1. 将依赖版本号修改为2.1.9

  2. 打开审计图片列表功能。

V2.1.8(2023.12.14)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.1.8

  2. 开启审计图功能

  3. 获取审计图


V2.1.7(2023.12.1)

一、版本介绍

二、版本升级

  1. 参考此链接

V2.1.6(2023.11.14)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为 2.1.6


V2.1.5(2023.9.20)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为 2.1.5


V2.1.4(2023.9.7)

一、版本介绍

二、版本升级

一、. 将依赖版本号修改为 2.1.4


V2.1.3(2023.4.27)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.1.3

V2.1.2(2023.4.6)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.1.2


 

V2.1.1(2023.3.23)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.1.1


V1.3.9.x -> V1.4.0(2023.2.20)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为1.4.0


V2.0.2(2022.12.16)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.0.2


V2.0.1(2022.12.06)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.0.1

  2. 设置动作难度(在 setLicenseAndCheck() 方法之前调用,否则不生效

    您可以根据业务要求指定动作检测的难度(EASY,NORMAL,HARD),默认为 NORMAL


V1.3.9 -> V2.0.0(2022.11.25)

一、版本介绍

二、版本升级

  1. 将依赖版本号修改为2.0.0

  2. 新增提示语和检测时状态码,在状态码回调方法中增加对应提示,否则页面会提示空白。文字资源请参照集成文档下载 UI 源码。


V1.3.8 -> V1.3.9/V1.3.9.x(2022.8.10)

一、版本介绍

二、版本升级

  1. 在您项目的 build.gradle 中增加 maven 仓库配置:

  2. 在项目的 app 模块build.gradle增加库依赖:

  3. 删除 liveness_lib_vx.x.x.aarguardian_core_vx.x.aar 两个 aar 文件。

V1.3.7 -> V1.3.8(2022.7.12)

一、版本介绍

二、版本升级


V1.3.6 -> V1.3.7(2022.6.7)

一、版本介绍

二、版本升级


V1.3.5 -> V1.3.6(2022.5.27)

一、版本介绍

二、版本升级


V1.3.4 -> V1.3.5(2022.2.18)

一、版本介绍

二、版本升级


V1.3.2 -> V1.3.3/V1.3.4(2022.1.13)

一、版本介绍

二、版本升级


V1.3.1 -> V1.3.2

一、版本介绍

二、版本升级


V1.3.0 -> V1.3.1

一、版本介绍

二、版本升级


V1.2.9 -> V1.3.0

一、版本介绍

二、版本升级


V1.2.8 -> V1.2.9

一、版本介绍

二、版本升级


V1.2.7 -> V1.2.8

一、版本介绍

二、版本升级


V1.2.6 -> V1.2.7

一、版本介绍

二、版本升级


V1.2.5 -> V1.2.6

一、版本介绍

遮挡检测默认是关闭状态,如需开启遮挡检测,请在初始化SDK之后调用如下方法设置

二、版本升级


V1.2.4 -> V1.2.5

一、版本介绍

二、版本升级


V1.2.3 -> V1.2.4

一、版本介绍

二、版本升级


V1.2.1/V1.2.2 -> V1.2.3

一、版本介绍

二、版本升级


V1.2.0 -> V1.2.1

一、版本介绍

二、版本升级


V1.1.9 -> V1.2.0

一、版本介绍

二、版本升级


V1.1.8 -> V1.1.9

一、版本介绍

二、版本升级


V1.1.7 -> V1.1.8

一、版本介绍

二、版本升级


V1.1.6 -> V1.1.7

一、版本介绍

二、版本升级


V1.1.5 -> V1.1.6

一、版本介绍

二、方法变更

三、版本升级


V1.1.4 -> V1.1.5

一、版本介绍

二、方法变更

三、版本升级

建议使用全量升级,新版代码更加简洁,几乎无代码侵入。


V1.1.3 -> V1.1.4

一、版本介绍

二、方法变更

原先的handleResult(ResultEntity entity)方法变更为 onDetectionSuccess()中的回调方法onGetFaceDataSuccess(),方法内容如下:

三、版本升级

  1. 全量升级

    • 拷贝 liveness_lib_v1.1.4.aarguardian_core_v1.2.aar两个文件至 liveness/libs 目录,同时删除对应的旧版本 aar,如果您同时集成了 picture_quality SDK,请同时把该 SDK 依赖的 guardian_core_vxx.aar 替换为 1.2 版本,以免发生版本依赖冲突。
    • liveness/build.gradle 中的 dependencies 标签里增加对 constraint-layout 的依赖:implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    • 保存下您在 LivenessFragment 上做的更改。
    • 使用新版本 LivenessFragment 文件覆盖旧的文件,同时替换 fragment_liveness.xml 布局文件。
    • 还原您对 LivenessFragment 上的更改。
    • 重新编译项目即可。
  2. 简单升级:本次更新主要是对 UI 模块做了优化,同时解决了 aar 中少量存在的 bug,您可以选择只替换 aar 文件来修复 aar 中的已知问题。

    • 使用 liveness_lib_v1.1.4.aar 替换 1.1.3 版本文件,同时在 gradle 中将引用更新为 1.1.4 即可。

V1.1.2 -> V1.1.3

一、版本介绍

二、从 SDK 获取图片方式的更改

只有活体检测成功后才会有图片

三、版本升级


V1.0 -> V1.1.2

一、版本介绍

二、从 SDK 获取图片

三、版本升级

有以下两种方式升级 SDK 至 1.1.2 版本,您可以结合实际需求选择其一。
新版本 aar 中已包含了 armeabi 架构,如您在 1.0 集成过程中拷贝了 libaailiveness_v1.0.0.so 至 libs/armeabi 目录下,请删除此 .so

方式一 (强烈建议)

适用于对 liveness 模块代码 无自定义改动或改动较少 的情况。

  1. 保存您做的自定义更改
  2. 删除 liveness 模块,添加对新版的依赖
  3. 恢复您的自定义更改
方式二

适用于改动了 liveness 模块。无需删除旧版本 liveness 模块。

  1. 使用新的 liveness_lib_v1.1.2.aar 文件替换 libs 目录里的旧 aar 文件
  2. 拷贝 guardian_core_v1.0.aar 到 libs 目录,并添加对此 aar 的依赖 rebuild 工程即可。

tips: 如您未改动 res 目录,可使用新版 liveness 库工程中的 res 直接拷贝覆盖旧的