# HarmonyOS_AREngine_Tuanjie

**Repository Path**: XRfans/harmonyos_arengine_tuanjie

## Basic Information

- **Project Name**: HarmonyOS_AREngine_Tuanjie
- **Description**: 在团结引擎中调用HarmonyOS NEXT AR Engine能力
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2024-09-26
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

HarmonyOS_AREngine_Tuanjie_v4.0

### 介绍
在HarmonyOS_AREngine_Tuanjie_v3.0版本（平面检测，运动跟踪，平面语义，命中测试，图像跟踪深度估计，环境Mesh，体积、容积测量，稠密点云能力）基础上新增了人脸识别与跟踪功能。

### 环境要求
团结引擎:推荐最新版本 手机系统版本：HarmonyOS NEXT 6.1.0(API23)及以上，

### 运行结果
打包成功后，您可以体验AR Engine的平面检测、运动跟踪、平面语义、命中测试、图像跟踪、深度估计、环境Mesh、体积测量、容积测量/稠密点云、人脸识别与跟踪等AR能力

### 使用说明
在团结引擎中选中Asset文件夹，点击Import Package导入该SDK。 相对于之前的v3.0版本上新增了人脸识别与跟踪功能

### 演示demo
FaceAR.unity，在次场景中可以改变FaceARConfig中的CameraLensFacing字段的值设置为前置摄像头或者后置摄像头，和改变FaceMultiMode的值设置是否激活多人模式（目前仅最大支持三个人）

### 入口
SessionComponent.cs脚本是该插件开启AR能力的入口。

### FAQ
Q：导入插件并打包为什么没有正常打开相机预览流,怎么解决？

A：打开预览流需要申请相对应的权限，相机权限，陀螺仪权限。

Q：权限都申请成功，预览流还是为什么没有打开？

A：在Tuanjie编辑器Project Setting去选Multithreaded Rendering选项，暂不支持该渲染模式，并且不支持Vulkan。

Q：为什么打开相机预览流画面不清晰，很糊？

A：Project Setting里把Color Space设置Gamma模式。

Q：体积、容积测量时为什么一直没反应，检测不出来？

A：SessionComponent.cs中的Config的Plane Finding Mode是HORIZONTAL_ONLY或VERTICAL_ONLY会出现该问题，Plane Finding Mode必须是ENABLE。