鸿蒙人脸检测实战:教你快速实现图片人脸识别与信息提取

// 导入需要的工具包import { faceDetector } from '@kit.CoreVisionKit';import { image } from '@kit.ImageKit';import { hilog } from '@kit.PerformanceAnalysisKit';import { BusinessError } from '@kit.BasicServicesKit';import { fileIo } from '@kit.CoreFileKit';import { photoAccessHelper } from '@kit.MediaLibraryKit';const TAG = "FaceDetectionDemo";@Entry@Componentstruct FaceDetectorPage {  // 选中的原始图片（PixelMap格式）  @State originalImage: PixelMap | undefined = undefined;  // 检测结果信息（人脸个数、位置、五官等）  @State detectionResult: string = "检测结果会显示在这里...";  // 图片资源对象  private imageSource: image.ImageSource | undefined = undefined;  build() {    Column({ space: 20 }) {      // 显示原始图片      Image(this.originalImage)        .objectFit(ImageFit.Contain)        .height('40%')        .width('90%')        .border({ width: 2, color: 0x317AE7, radius: 8 })        .backgroundColor('#F5F5F5')        .accessibilityDescription("待检测图片")      // 显示检测结果（支持复制）      Scroll() {        Text(this.detectionResult)          .copyOption(CopyOptions.LocalDevice)          .margin(10)          .width('90%')          .fontSize(14)      }      .height('25%')      .border({ width: 1, color: '#E0E0E0', radius: 8 })      .width('90%')      // 选择图片按钮      Button('从图库选择图片')        .type(ButtonType.Capsule)        .backgroundColor(0x317AE7)        .fontColor(Color.White)        .width('90%')        .height(45)        .onClick(() => this.selectImageFromGallery())      // 开始检测按钮      Button('开始人脸检测')        .type(ButtonType.Capsule)        .backgroundColor(0x317AE7)        .fontColor(Color.White)        .width('90%')        .height(45)        .onClick(() => this.startFaceDetection())    }    .padding(20)    .width('100%')    .height('100%')    .justifyContent(FlexAlign.Center)  }  // 第一步：从图库选择图片  private async selectImageFromGallery() {    try {      const photoPicker = new photoAccessHelper.PhotoViewPicker();      const selectResult = await photoPicker.select({        MIMEType: photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE, // 只选图片        maxSelectNumber: 1 // 最多选1张      });      const imageUri = selectResult.photoUris[0];      if (imageUri) {        await this.loadImageToPixelMap(imageUri); // 转换图片格式      } else {        this.detectionResult = "未选中图片，请重新选择";      }    } catch (err: BusinessError | any) {      hilog.error(0x0000, TAG, `选图失败：${err.message}`);      this.detectionResult = `选图失败：${err.message}（错误码：${err.code}）`;    }  }  // 第二步：将图片转换为人脸检测能识别的PixelMap格式  private async loadImageToPixelMap(uri: string) {    try {      // 打开图片文件      const file = await fileIo.open(uri, fileIo.OpenMode.READ_ONLY);      // 创建图片资源对象      this.imageSource = image.createImageSource(file.fd);      // 转换为PixelMap格式      this.originalImage = await this.imageSource.createPixelMap();      // 关闭文件，避免资源泄露      await fileIo.close(file);      // 重置结果      this.detectionResult = "已选中图片，点击「开始人脸检测」按钮...";    } catch (err: BusinessError | any) {      hilog.error(0x0000, TAG, `图片加载失败：${err.message}`);      this.detectionResult = `图片加载失败：${err.message}`;    }  }  // 第三步：初始化服务并调用人脸检测接口  private async startFaceDetection() {    // 先判断是否选中了图片    if (!this.originalImage) {      this.detectionResult = "请先选择一张图片！";      return;    }    try {      // 初始化人脸检测服务      await faceDetector.init();      this.detectionResult = "正在检测人脸，请稍候...";      // 配置检测参数：传入待检测的图片（PixelMap格式）      const visionInfo: faceDetector.VisionInfo = {        pixelMap: this.originalImage      };      // 调用检测接口，获取结果      const faceResult: faceDetector.Face[] = await faceDetector.detect(visionInfo);      // 解析检测结果      if (faceResult.length === 0) {        this.detectionResult = "未在图片中检测到人脸，请选择包含清晰人脸的图片";      } else {        let resultText = `共检测到 ${faceResult.length} 个人脸\n\n`;        // 遍历每个人脸，解析详细信息        faceResult.forEach((face, index) => {          resultText += `=== 人脸 ${index + 1} 详细信息 ===\n`;          // 1. 人脸位置（矩形框坐标）          const faceRect = face.faceRectangle;          resultText += `人脸位置：\n`;          resultText += `左上角X：${faceRect.left.toFixed(2)}，Y：${faceRect.top.toFixed(2)}\n`;          resultText += `宽度：${faceRect.width.toFixed(2)}，高度：${faceRect.height.toFixed(2)}\n`;          // 2. 人脸置信度（0-1，越接近1越准确）          resultText += `检测置信度：${face.confidence.toFixed(4)}（数值越高越准确）\n`;          // 3. 人脸朝向（基于世界坐标系判断）          resultText += `人脸朝向：${this.getFaceOrientation(face.orientation)}\n`;          // 4. 五官位置（如果有数据则显示）          if (face.faceFeatures) {            resultText += `五官位置：\n`;            resultText += `左眼：X=${face.faceFeatures.leftEye.x.toFixed(2)}，Y=${face.faceFeatures.leftEye.y.toFixed(2)}\n`;            resultText += `右眼：X=${face.faceFeatures.rightEye.x.toFixed(2)}，Y=${face.faceFeatures.rightEye.y.toFixed(2)}\n`;            resultText += `鼻子：X=${face.faceFeatures.nose.x.toFixed(2)}，Y=${face.faceFeatures.nose.y.toFixed(2)}\n`;            resultText += `嘴巴：X=${face.faceFeatures.mouth.x.toFixed(2)}，Y=${face.faceFeatures.mouth.y.toFixed(2)}\n`;          }          resultText += "\n";        });        // 显示解析后的结果        this.detectionResult = resultText;      }      // 检测完成后释放服务，避免占用内存      await faceDetector.release();    } catch (error: BusinessError) {      // 处理错误      this.detectionResult = `检测失败：${error.message}（错误码：${error.code}）`;      hilog.error(0x0000, TAG, `检测失败：${error.message}，错误码：${error.code}`);      // 出错后也释放服务      await faceDetector.release();    }  }  // 辅助函数：将人脸朝向枚举转换为通俗描述  private getFaceOrientation(orientation: number): string {    // 鸿蒙人脸朝向基于世界坐标系，不同数值对应不同方向    switch (orientation) {      case 0:        return "正面朝上（正常方向）";      case 1:        return "逆时针旋转90度";      case 2:        return "旋转180度（倒立）";      case 3:        return "顺时针旋转90度";      default:        return "未知朝向";    }  }}