faceDetector（人脸检测）

在 HarmonyOS NEXT 中实现人脸 68 点检测，推荐使用 Core Vision Kit 的 faceDetector 模块（鸿蒙原生方案），无需下载独立 SDK，直接通过 import 引用即可。这是官方推荐的标准做法，兼容性和性能最佳。

官方资源与文档

1. 官方文档

• Core Vision Kit 人脸检测 API 文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/core-vision-face-detector-api
• Core Vision Kit 使用指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/core-vision-face-detector Huawei Developer

2. 示例代码下载

• Core Vision Kit 人脸检测示例：https://developer.huawei.com/consumer/cn/codelabsPortal/carddetails/tutorials_Next-CoreVisionKit Huawei Developer（页面提供 CoreVisionKit-SampleCode-ArkTS.zip 下载）

Core Vision Kit 是鸿蒙原生视觉服务，已集成人脸 68 点检测能力，无需额外下载 SDK，可直接在项目中引用。

一、Core Vision Kit 人脸检测模块获取方式

1. 使用方式（无需下载独立 SDK）

在 HarmonyOS NEXT 应用中，直接通过标准 import 语句引入：

import { faceDetector } from '@kit.CoreVisionKit';

这是鸿蒙原生 API，已随系统 SDK 集成，无需单独下载。

2. 若需 HMS Core 的 ML Kit 人脸检测（可选方案）

如果您特别需要使用 HMS Core 的 ML Kit（非必须），可通过以下方式集成：

通过 npm 安装：

# 安装HMS Core基础SDK
npm install @hw-hmscore/hms-js-base@latest

# 安装人脸检测相关模块（可选）
npm install @hw-hmscore/hms-ml-computer-vision-face@latest

或通过 oh-package.json5 添加依赖：

{
  "dependencies": {
    "@hw-hmscore/hms-js-base": "latest",
    "@hw-hmscore/hms-ml-computer-vision-face": "latest"
  }
}

二、Core Vision Kit 人脸检测使用示例

以下是使用 Core Vision Kit 实现人脸 68 点检测的基本步骤：

1. 初始化人脸检测器

// 初始化人脸检测服务
const initResult = await faceDetector.init();
if (initResult) {
  console.log('人脸检测器初始化成功');
}

2. 执行检测（以图片为例）

import { image, fileIo } from '@ohos';

async function detectFaceFromImage(imagePath: string) {
  // 读取图片文件
  const file = await fileIo.open(imagePath, fileIo.OpenMode.READ_ONLY);
  const imageSource = image.createImageSource(file.fd);
  const pixelMap = await imageSource.createPixelMap();

  // 创建视觉信息对象
  const visionInfo: faceDetector.VisionInfo = {
    pixelMap: pixelMap
  };

  // 执行人脸检测
  const faces = await faceDetector.detect(visionInfo);
  
  // 处理检测结果（获取68个关键点）
  if (faces.length > 0) {
    const face = faces[0];
    const keyPoints = face.getFaceKeyPoints(); // 获取68个关键点
    console.log('检测到人脸，68个关键点：', keyPoints);
  }

  // 释放资源
  pixelMap.release();
  await fileIo.close(file);
}

Huawei Developer