logo
积分中心
鸿蒙开发——实现活体检测
头像 蓝亭书序 2026-11-18 14:47:48    发布
1 浏览 0 收藏

什么是活体检测?

人脸活体检测是指在一些身份验证场景中,确定对象真实生理特征的方法。

在人脸识别应用中,活体检测能实时捕捉人脸或者通过眨眼、张嘴、摇头、点头等组合动作。

动作活体检测支持实时捕捉人脸,需要用户配合做指定动作就可以判断是真实活体,还是非活体攻击(比如:打印图片、人脸翻拍视频以及人脸面具等)。

使用人脸关键点定位和人脸追踪等技术,验证用户是否为真实活体本人操作,可有效抵御照片、视频、面具、遮挡以及屏幕翻拍等常见的攻击手段,从而帮助用户甄别欺诈行为,保障用户的利益。

效果如下:

图片

interactiveLiveness

鸿蒙为开发者提供了一套基于端侧的活体检测方案,由interactiveLiveness模块提供。

核心接口有两个,一个用于唤起人脸检测服务、一个用于获取检测结果


// 跳转到人脸活体检测页面的入口。使用Promise异步回调。
startLivenessDetection(config: InteractiveLivenessConfig): Promise<boolean>

// 获取人脸活体检测的结果。使用Promise异步回调。
getInteractiveLivenessResult(): Promise<InteractiveLivenessResult>


其中入参InteractiveLivenessConfig类型定义如下:


class InteractiveLivenessConfig {
    // 表示的是人脸活体检测模式,默认动作活体检测模式。INTERACTIVE_MODE表示动作活体检测模式。
    isSilentMode: DetectionMode;
    /*
    表示动作活体检测的动作数量,数量范围3或4个,默认3个动作。随机生成,
    规则如下:
    当actionsNum=3时,[眨眼,注视]组合中的动作元素不会同时存在并且相邻的动作元素不会相同。
    当actionsNum=4时,眨眼动作元素有且仅有1次,注视动作元素最多出现1次,[眨眼,注视]组合中的动作元素不会相邻,相邻的动作元素不会相同。
    该参数只有当isSilentMode是INTERACTIVE_MODE的时候有效。
    */
    actionsNum?: ActionsNumber;

    // 表示人脸活体检测成功后跳转的页面路径。如果不填,系统有默认的检测成功页面。
    failedRouteUrl?: string;
    // 表示人脸活体检测失败后跳转的页面路径。如果不填,系统有默认的检测失败页面。
    successfulRouteUrl?: string;
    // 人脸活体检测完成后跳转模式。默认使用router.replaceUrl。
    // BACK_MODE: back 表示人脸活体检测完成后使用router.back返回到上一页。
    // REPLACE_MODE: replace 表示人脸活体检测完使用router.replaceUrl跳转。
    routeMode?: RouteRedirectionMode;

    /*
    挑战值。仅用于安全摄像头场景(对应initializeAttestContext方法中的“userData”字段)的活体检测。
    长度范围是16-128之间(challenge传空或者undefined表示不使用安全摄像头)。
    */ 
    challenge?: string;
    
    /*
    语音播报的开关。
    true表示开启语音播报。
    false表示关闭语音播报。
    默认开启语音播报。
    */
    speechSwitch?: boolean;
    
    /*
    是否设置隐私模式。
    true:设置隐私模式。
    false:不设置隐私模式。
    默认值为false。
    */
    isPrivacyMode?: boolean;
}


其中获取监测结果的InteractiveLivenessResult类型定义如下:


class InteractiveLivenessResult {
    // 活体检测模式的枚举值。
    // INTERACTIVE_LIVENESS 0 表示当前检测的结果是动作活体检测。
    // SILENT_LIVENESS 1 表示当前检测的结果是静默活体检测,暂未支持。
    // NOT_LIVENESS 2 表示当前检测的结果是非活体,跳转的是失败页面,不会返回错误信息。如果配置了失败页面或者back路由跳转,不建议有重新检测的场景。
    livenessType: LivenessType;

    // 检测成功后返回最具有活体特征的图片。
    mPixelMap?: image.PixelMap;

    // 安全摄像头场景返回的安全流。
    securedImageBuffer?: ArrayBuffer;
    // 安全摄像头场景返回的证书链。
    certificate?: Array<string>;
}


获取结果可能失败,我们可以通过catch捕获其错误码,常见的错误码如下:

  • 1008302000【错误描述】检测算法初始化未完成,无检测数据返回。【可能原因】获取结果时还未进行活体检测。【处理办法】调用活体检测API后,再获取结果。
  • 1008302001【错误描述】检测超时,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测时,长时间没有按照提示完成相关动作,导致检测超时了。【处理办法】检测时请按提示完成相关动作。
  • 1008302002【错误描述】动作错误,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测时,没有按照提示完成相关动作,导致检测失败了。【处理办法】检测时请按提示完成相关动作。
  • 1008302003【错误描述】连续性检测失败,跳转失败页面。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测多个动作时,没有按照提示完成相关动作,导致连续性检测失败了。【处理办法】检测时请按提示完成相关动作。
  • 1008302004【错误描述】检测未完成。如果配置了失败页面或者back路由跳转,建议有重新检测的场景。【可能原因】检测过程中退出检测。【处理办法】检测时请按提示完成相关动作。


需要注意,使用活体检测功能时,由于需要调用摄像头,需要申明摄像头权限,同时,模拟器中暂时不支持此能力。


"requestPermissions":[
  {
    "name": "ohos.permission.CAMERA",
    "reason": "$string:camera_desc",
    "usedScene": {"abilities": []}
  }
]


示意如下:

图片


Demo案例

实现一个案例,点击开始检测,跳转到活体检测界面,检测完成后回到页面,显示出成功与否。

效果如下:

图片

代码如下(88 ~ 96行 启动检测的代码,117 ~ 126 获取结果的代码):


import { common, abilityAccessCtrl, Permissions } from '@kit.AbilityKit';
import { interactiveLiveness } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 默认的错误码,表示还未唤起活体检测服务就获取结果
const DEFAULT_ERROR_CODE = 1008302000;
interface FailResultType {
  code: number;
  message: string;
}
function getDefaultFailResult(): FailResultType {
  return {
    "code": DEFAULT_ERROR_CODE,
    "message": ""
  };
}
function getDefaultResultInfo(): interactiveLiveness.InteractiveLivenessResult {
  return {
    livenessType: 0
  };
}
@Entry
@Component
export struct Index {
  private context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
  private array: Array<Permissions> = ["ohos.permission.CAMERA"];
  @State resultInfo: interactiveLiveness.InteractiveLivenessResult = getDefaultResultInfo();
  @State failResult: FailResultType = getDefaultFailResult();
  onPageShow() {
    this.resetResult();
    this.getDetectionResultInfo();
  }
  private getResultMsg() {
    // 有活体检测结果
    if (this.resultInfo.mPixelMap) {
      return '活体检测成功';
    }
    // 还未唤起活体检测
    if (this.failResult.code === DEFAULT_ERROR_CODE) {
      return '';
    }
    return '活体检测失败';
  }
  @Builder
  ShowResultInfo() {
    Text(this.getResultMsg())
      .width("100%")
      .height(26)
      .fontSize(20)
      .fontColor("#000000")
      .fontFamily("HarmonyHeiTi")
      .margin({ top: 50 })
      .textAlign(TextAlign.Center)
      .fontWeight("Medium")
      .margin({ bottom: 240 })
    if (this.failResult.code != DEFAULT_ERROR_CODE) {
      Text(this.failResult.message as string)
        .width("100%")
        .height(26)
        .fontSize(16)
        .fontColor(Color.Gray)
        .textAlign(TextAlign.Center)
        .fontFamily("HarmonyHeiTi")
        .fontWeight("Medium")
        .margin({ bottom: 200 })
    }
  }
  build() {
    Column() {
      this.ShowResultInfo()
      Button("开始检测", { type: ButtonType.Normal, stateEffect: true })
        .width(192)
        .height(40)
        .fontSize(16)
        .backgroundColor(0x317aff)
        .borderRadius(20)
        .margin({
          bottom: 56
        })
        .onClick(() => {
          this.startDetection();
        })
    }
  }
  // 跳转到人脸活体检测控件
  routerLibrary() {
    if (canIUse("SystemCapability.AI.Component.LivenessDetect")) {
      // 跳转到活体检测服务
      interactiveLiveness.startLivenessDetection({
        isSilentMode: 'INTERACTIVE_MODE' as interactiveLiveness.DetectionMode,
        routeMode: 'back' as interactiveLiveness.RouteRedirectionMode,
        actionsNum: 4 // 检测4个动作,默认是3个
      }).then((DetectState: boolean) => {
        console.info(`跳转成功`);
      }).catch((err: BusinessError) => {
        console.error(`跳转失败. 错误码:${err.code},信息:${err.message}`);
      })
    } else {
      // 当前API不支持此能力
    }
  }
  // 校验CAMERA权限
  private startDetection() {
    abilityAccessCtrl.createAtManager().requestPermissionsFromUser(this.context, this.array).then((res) => {
      for (let i = 0; i < res.permissions.length; i++) {
        if (res.permissions[i] === "ohos.permission.CAMERA" && res.authResults[i] === 0) {
          this.routerLibrary();
        }
      }
    }).catch((err: BusinessError) => {
      console.error(`权限申请失败. 错误码 ${err.code}, 信息 ${err.message}`);
    })
  }
  // 获取验证结果
  private getDetectionResultInfo() {
    // getInteractiveLivenessResult接口调用完会释放资源
    if (canIUse("SystemCapability.AI.Component.LivenessDetect")) {
      let resultInfo = interactiveLiveness.getInteractiveLivenessResult();
      resultInfo.then(data => {
        console.log('获取结果成功 ' + JSON.stringify(data))
        this.resultInfo = data;
      }).catch((err: BusinessError) => {
        this.failResult = {
          "code": err.code,
          "message": err.message
        }
      })
    } else {
      // 当前API不支持此能力
    }
  }
  // result release
  private resetResult() {
    this.resultInfo = getDefaultResultInfo();
    this.failResult = getDefaultFailResult();
  }
}



❓思考一下

活体检测可能有哪些异常情况?这些异常情况我们分别怎么处理?



©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255