本文同步发表于我的微信公众号，微信搜索 程语新视界 即可关注，每个工作日都有文章更新

鸿蒙系统提供的FaceDetector组件能够高效检测图像或视频流中的人脸信息，支持多人脸检测、关键点定位和属性分析等功能。

一、核心能力矩阵

功能	精度	性能	支持格式
人脸检测	98%召回率	<200ms/帧	静态图/视频流
关键点定位	72~106点	+50ms/人脸	RGB/BGR
属性分析	年龄/性别/表情	+30ms/人脸	YUV/NV21
3D姿态估计	欧拉角±5°	+100ms/人脸	灰度图

二、开发全流程

1. 环境配置

在module.json5中添加必要权限：

"requestPermissions": [
  {
    "name": "ohos.permission.CAMERA"
  },
  {
    "name": "ohos.permission.MEDIA"
  }
]

2. 检测器初始化

import faceDetector from '@ohos.multimodalInput.faceDetector';

// 创建检测器实例
const detector: faceDetector.FaceDetector = faceDetector.createFaceDetector();

// 配置参数
const config: faceDetector.FaceDetectConfig = {
  performanceMode: faceDetector.PerformanceMode.FAST, // 速度优先
  landmarkMode: faceDetector.LandmarkMode.ALL, // 全关键点
  featureMode: faceDetector.FeatureMode.ON, // 开启属性分析
  interval: 0 // 每帧检测
};

// 初始化
detector.init(config, (err) => {
  if (err) {
    console.error(`初始化失败: ${JSON.stringify(err)}`);
    return;
  }
  console.log('人脸检测器就绪');
});

三、核心API

1. 静态图像检测

import image from '@ohos.multimedia.image';

// 从媒体库获取PixelMap
const imageSource = image.createImageSource(uri);
const pixelMap = await imageSource.createPixelMap();

// 执行检测
detector.detect(pixelMap, (err, result) => {
  if (err || !result?.faces) return;
  
  result.faces.forEach((face: faceDetector.Face) => {
    console.log(`人脸位置: ${JSON.stringify(face.rect)}`);
    console.log(`年龄估计: ${face.age}岁`);
    console.log(`微笑概率: ${face.smileProb}`);
    
    // 关键点数据
    if (face.landmarks) {
      face.landmarks.forEach(point => {
        console.log(`关键点${point.id}: (${point.x},${point.y})`);
      });
    }
  });
});

2. 视频流检测

import camera from '@ohos.multimedia.camera';

// 创建Camera会话
const cameraManager = camera.getCameraManager(context);
const cameras = cameraManager.getSupportedCameras();
const cameraInput = cameraManager.createCameraInput(cameras[0]);

// 配置人脸检测回调
cameraInput.on('faceDetect', (err, result) => {
  if (err || !result?.faces) return;
  
  // 实时绘制人脸框
  drawFaceRectangles(result.faces);
});

// 启动检测
cameraInput.startFaceDetection(config);

四、高级功能

1. 3D姿态估计

const advancedConfig: faceDetector.FaceDetectConfig = {
  poseMode: faceDetector.PoseMode.FULL, // 开启3D姿态
  // ...其他配置
};

detector.init(advancedConfig, () => {
  detector.detect(pixelMap, (err, result) => {
    const eulerAngles = result.faces[0].poseEuler;
    console.log(`头部偏航角: ${eulerAngles.yaw}°`);
    console.log(`头部俯仰角: ${eulerAngles.pitch}°`);
    console.log(`头部翻滚角: ${eulerAngles.roll}°`);
  });
});

2. 活体检测

const livenessConfig: faceDetector.FaceDetectConfig = {
  livenessMode: faceDetector.LivenessMode.RGB, // RGB活体检测
  // ...其他配置
};

detector.init(livenessConfig, () => {
  detector.detect(pixelMap, (err, result) => {
    console.log(`活体分数: ${result.faces[0].livenessScore}`);
  });
});

五、性能优化

1. 检测区域优化

// 设置ROI区域提升检测速度
const roi: faceDetector.Rect = {
  left: 100,
  top: 100,
  right: 500,
  bottom: 500
};
detector.setROI(roi);

2. 多线程处理

import taskpool from '@ohos.taskpool';

@Concurrent
async function asyncDetect(pixelMap: image.PixelMap) {
  return detector.detect(pixelMap);
}

// 在任务池执行检测
taskpool.execute(asyncDetect, pixelMap).then((result) => {
  processDetectionResult(result);
});