《增强现实引擎应用技术》课件-EasyAR Sense Unity Plugin4.6.5-基础知识

EasyARSenseUnityPlugin4.6.5基础授课人:时间:2025/09/01目录01准备开发环境02创建空项目与导入插件03搭建基础AR场景04图像跟踪CONTENTS准备开发环境01EasyARSenseUnityPlugin支持的操作系统与Unity长期支持版有明确要求。开发者需确保所用系统与Unity版本在官方支持列表内，避免因版本不兼容导致插件失效。操作系统与Unity版本显卡驱动、AndroidSDK/NDK、Xcode等开发工具的最低版本号需满足要求。64位系统与物理摄像头是调试必备，确保后续开发顺利。显卡驱动与开发工具建议初次开发者直接安装UnityLTS版本，降低因环境差异带来的踩坑概率，为后续导入插件奠定稳定基础。初次开发者建议在开始开发前，务必检查开发环境是否满足要求，避免后续开发过程中出现因环境问题导致的错误和问题。环境检查重要性Unity版本与系统要求速览从官网下载页获取zip压缩包，包含readme和tgz核心文件。仅解压zip，切勿二次解压tgz，确保插件文件完整。插件包下载注册官网账号，创建应用后获取LicenseKey。Key在后续Unity项目中具有唯一性，不可泄露。授权许可证获取若Key错误或与包名不符，运行时将直接黑屏报错。开发者需提前核对，避免后期返工。授权验证获取插件包与授权许可证创建空项目与导入插件02选择模板创建Unity项目时，模板必须选择3D而非URP/HDRP，防止渲染管线冲突。新建3D模板工程将tgz文件提前放入项目根级Packages文件夹，路径固定，便于多人协同。文件放置打开PackageManager，选择Addpackagefromtarball，点选tgz文件，等待进度条完成。安装过程导入成功后，Console无报错，Project视图出现EasyAR目录，验证插件安装完成。验证安装本地安装tgz插件包步骤本地安装tgz插件包步骤本地安装tgz插件包步骤通过菜单EasyAR>Sense>Configuration打开配置面板，在ProjectSettings中输入LicenseKey。配置路径运行时在Console看到“EasyARSenseinitialized”即配置成功，若提示InvalidLicense需检查包名与Key匹配。验证配置填写LicenseKey与全局配置填写LicenseKey与全局配置搭建基础AR场景03摄像机Tag可保持MainCamera或手动指定FrameSource.Camera，确保ARSession启动时正确绑定。Tag设置ClearFlags必须选择SolidColor，背景设为黑色，防止Skybox遮挡摄像头画面，提升体验。ClearFlags与背景ClippingPlanes的Near值建议设为0.1米，避免贴脸识别时模型被裁剪。ClippingPlanes调整若使用ARFoundation或NrealSDK，这些参数会被自动覆盖，无需手动调整。特殊情况说明配置主摄像机参数清单配置主摄像机参数清单GameObject>EasyARSense下有三类常用预设：ImageTracking、MotionTracking、Sparse&DenseSpatialMap。预设分类点击预设后，在Hierarchy得到ARSession节点，内含Camera、FrameSource、ImageTrackerFilter等子级。预设创建预设可反复创建，也可复制修改，适合不同场景复用，大幅降低手动拖曳组件的时间成本。预设优势快速创建ARSession预设快速创建ARSession预设

为了使用方便，在GameObject菜单中许多预设，可以在大多数情况下使用它们完成需要的功能，比如要使用图像跟踪，可以使用

EasyAR

Sense

>

Image

Tracking

>

AR

Session

(Image

Tracking

Preset)

来创建ARSession。快速创建ARSession预设

如果要像典型的类似ARCore或ARKit的方式来使用运动跟踪，可以使用

EasyAR

Sense

>

Motion

Tracking

>

AR

Session

(Motion

Tracking

Preset)

:

System

First

来创建ARSession。快速创建ARSession预设EasyAR

Sense

>

AR

Session

(Preset)

菜单收集了所有预设，如果在这个集合中和某个功能菜单中存在同名的预设，它们创建出来的ARSession也会是一样的。图像跟踪04手动创建StreamingAssets文件夹，放在Assets根目录，打包后会原样拷贝到移动端。StreamingAssets文件夹把名片图拖入该文件夹，文件名最好英文无空格，避免安卓路径解析失败。图片放置在Hierarchy用菜单创建ImageTarget，此时出现问号图标属正常。创建ImageTargetImageTargetController组件的SourceType选ImageFile、PathType选StreamingAssets，Path只需填相对路径，即可完成绑定。绑定图片制作可识别图片Target制作可识别图片Target

要使用图像跟踪，通过

EasyAR

Sense

>

Image

Tracking

>

Target

:

Image

Target

创建

ImageTargetController

。制作可识别图片Target制作可识别图片Target

要使用图像跟踪，通过

EasyAR

Sense

>

Image

Tracking

>

Target

:

Image

Target

创建

ImageTargetController

。设置物理尺寸与追踪器Scale字段填写真实宽度，单位米，名片90mm即0.09，误差过大会导致漂移。S