# CoreVisionKit-SampleCode-ArkTS-FaceDetectDemo

**Repository Path**: harmonyos_samples/core-vision-kit-sample-code-ark-ts-face-detect-demo

## Basic Information

- **Project Name**: CoreVisionKit-SampleCode-ArkTS-FaceDetectDemo
- **Description**: 本示例展示了检测图片中的人脸并返回各项数据的AI能力。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 3
- **Created**: 2024-06-18
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实现人脸识别

## 介绍

本示例展示了使用基础视觉服务提供的人脸识别能力。

本示例模拟了在应用里，选择一张图片，识别其多个人脸信息并展示出来。包括人脸框、五官点位、置信度、人脸朝向（欧拉角）

需要使用人脸识别接口@hms.ai.face.faceDetector.d.ts。

## 效果预览

|         **主窗口**          |             **选择图片**             |             **开始识别**             |
|:------------------------:|:--------------------------------:|:--------------------------------:|
| ![](screenshots/app.png) | ![](screenshots/selectImage.png) | ![](screenshots/faceResult.png) | 

使用说明：

1. 在手机的主屏幕，点击”faceDetectorDemo“，启动应用。
2. 点击“Select image”按钮，用户可以在图库中选择图片，或者通过相机拍照。
3. 点击“Start detection”按钮，识别人脸信息，结果通过文本展示。

## 工程目录
```
├─entry/src/main/ets
│  ├─entryability
│  │  ├─EntryAbility.ets            // 程序入口
│  └─pages
│     └─Index.ets                   // 应用主界面
└─entry/src/main/resources          // 资源文件目录
```

## 具体实现

本示例展示的控件在@hms.ai.face.faceDetector.d.ts定义了人脸检测API：
~~~
*   function detect(visionInfo: VisionInfo): Promise<Array<Face>>;
~~~
业务使用时，需要先进行import导入faceDetector
调用通用人脸识别接口，并传入想要识别的图片，接收处理返回的结果（文字信息）。参考entry/src/main/ets/pages/Index.ets.

## 相关权限

不涉及。

## 依赖

不涉及。

## 约束与限制

1. 本实例仅支持标准系统上运行，支持设备：华为手机、华为平板、2in1。
2. HarmonyOS系统：HarmonyOS 5.0.0 Release及以上。
3. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。