HarmonyOS人脸比对技术自学指南与实战分享 原创

import { faceComparator, VisionInfo, FaceCompareResult } from '@kit.CoreVisionKit';
1.

"dependencies": {
  "@ohos.ai.cv.face": "5.0.3.15",
  "@ohos.image": "5.0.3.15"
}
1.
2.
3.
4.

"reqPermissions": [
  {
    "name": "ohos.permission.READ_MEDIA"
  },
  {
    "name": "ohos.permission.USE_CAMERA"
  }
]
1.
2.
3.
4.
5.
6.
7.
8.

// 界面布局（简化版）
@Entry
@Component
struct FaceCompare {
  @State images: Array<PixelMap> = [] // 存储选择的图片
  @State result: string = "点击比对"

  build() {
    Column() {
      // 图片展示区（支持2张图片）
      Grid({ columns: 2, gap: 10 }) {
        ForEach(this.images, (img, index) => {
          Image(img).height(300).width(300)
        }, img => img.hashCode)
      }

      // 操作按钮
      Button("选择图片").onClick(() => this.selectImages(2)) // 调整选择数量为2
      Button("开始比对").onClick(this.compareFaces)
      
      // 结果展示
      Text(this.result).fontSize(18).margin(20)
    }.padding(20)
  }
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.

private async compareFaces() {
  // 新增：尺寸校验（官方推荐640x480）
  const validateSize = (img: PixelMap) => 
    img.width >= 480 && img.height >= 640;

  if (!this.images.every(validateSize)) {
    this.result = "请选择高清图片（≥480x640）";
    return;
  }

  try {
    // 初始化（新增：超时处理）
    await faceComparator.init({ timeout: 5000 }); // 调整超时时间

    // 构建比对数据（修改：增加图像预处理）
    const visions: VisionInfo[] = this.images.map(img => ({
      pixelMap: img,
      format: ImageFormat.JPEG, // 显式指定格式
      quality: 90 // 调整压缩质量
    }));

    // 执行比对（修改：阈值从0.8→0.85）
    const result: FaceCompareResult = 
      await faceComparator.compareFaces(visions[0], visions[1]);

    // 结果处理（新增：置信度分级）
    this.result = `相似度：${(result.similarity * 100).toFixed(1)}%  
    ${result.isSamePerson ? "√ 匹配成功" : "× 匹配失败"}
    等级：${this.getLevel(result.similarity)}`;
    
  } catch (error) {
    this.result = `错误：${(error as BusinessError).message}`;
  } finally {
    await faceComparator.release();
  }
}

// 新增：置信度分级逻辑
private getLevel(score: number): string {
  if (score >= 0.95) return "极高（双胞胎级）";
  if (score >= 0.85) return "高（同 person）";
  if (score >= 0.7) return "中（相似脸）";
  return "低（不同人）";
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.

// 新增：图像预处理管道
private preprocessImage(uri: string): Promise<PixelMap> {
  return image.createPixelMap(uri)
    .then(img => img.resize({ width: 640, height: 480 })) // 尺寸标准化
    .then(img => img.convert(ImageFormat.RGBA8888)); // 格式统一
}

// 新增：缓存策略（LRU缓存最近10次特征）
private faceCache: LRUCache<string, FaceFeature> = 
  new LRUCache(10);
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

// 新增：错误码映射表
const ERROR_MAP: Record<number, string> = {
  1001: "图片解析失败（请检查格式）",
  2003: "人脸检测失败（无有效人脸）",
  3002: "特征提取超时（请优化图片质量）"
};

// 在catch中使用
catch((error: BusinessError) => {
  this.result = `[${error.code}] ${ERROR_MAP[error.code] || error.message}`;
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

// 支持最多3人比对（修改maxSelectNumber=3）
private selectImages(count: number = 3) { // 调整选择数量
  photoPicker.select({ maxSelectNumber: count })
    .then(uris => this.loadImages(uris));
}

// 多人比对逻辑
private async compareGroup(images: PixelMap[]) {
  const results: number[][] = [];
  for (let i = 0; i < images.length; i++) {
    results[i] = [];
    for (let j = 0; j < images.length; j++) {
      if (i === j) results[i][j] = 100; // 自比对100%
      else {
        const res = await faceComparator.compareFaces(
          { pixelMap: images[i] },
          { pixelMap: images[j] }
        );
        results[i][j] = res.similarity * 100;
      }
    }
  }
  return results; // 返回相似度矩阵
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.

// 结果展示优化
Grid({ columns: this.images.length }) {
  ForEach(results, (row, i) => {
    ForEach(row, (score, j) => {
      Text(`${score.toFixed(1)}%`)
        .backgroundColor(score > 85 ? Color.Green : Color.Red)
        .fontSize(14)
        .padding(5)
    })
  })
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

// 新增：多尺度检测参数（官方默认1.1→1.05）
faceComparator.setOption('scaleFactor', 1.05); 
faceComparator.setOption('minFaceSize', 30); // 最小人脸尺寸（像素）
1.
2.
3.

// 权限申请前提示
showDialog({
  message: "需要访问您的相册以进行人脸比对，数据仅本地处理",
  confirm: () => requestPermissions(["ohos.permission.READ_MEDIA"])
});
1.
2.
3.
4.
5.