快速开始

更新时间：2025-03-12 GMT+08:00

查看PDF

创建Unity项目。

新建一个Unity Project，“Template”选择“3D”。
导入ARFoundation包，并配置ARCore XR Plugin和ARKit XR Plugin。
1. 打开工程里自动创建的Packages文件夹目录下的manifest.json文件，在manifest.json输入如下内容，Unity3D将会自动导入所添加的插件。
```
"com.unity.xr.arfoundation": "4.1.13",
"com.unity.xr.arcore": "4.1.13",
"com.unity.xr.arkit": "4.1.13",
```
  说明：
  
  您也可以在菜单栏“Windows”里找到“Package Manager”，单击“Package Manager”直接选择需要添加的插件。
2. 插件包导入完成后配置平台支持ARCore XR Plugin和ARKit XR Plugin。
  在菜单栏“Edit > ProjectSettings > XR Plug-in Management”路径下：
  - 选择平台，勾选“ARCore”。
  - 选择iOS平台，勾选“ARKit”。
导入HTFoundation示例。

说明：

请先在“File > Build Settings > Player Settings > Player > Other Settings”中找到“Allow 'unsafe' Code”，并将其勾选。
1. 解压SDK压缩包Cyberverse-HTFoundation.zip。压缩包下载地址请参考下载SDK。
2. 在解压的文件夹中找到CloudBuildOutput文件夹，并将该文件夹里面的Demo-xx.zip解压到同级目录，解压后得到一个Assets文件夹。
  图1 解压Demo压缩包
3. 在解压的“Cyberverse-HTFoundation > CloudBuildOutput”下，找到HTFoundation文件夹，并将其合并到“Cyberverse-HTFoundation > CloudBuildOutput > Assets”的HTFoundation文件夹。
4. 将以上合并后的Assets文件夹合并到1新建的Unity工程的Assets目录。
配置Plugins文件夹里的文件。

在新建的Unity工程的“Assets > HTFoundation”找到Plugins文件夹，文件夹中包含Android、iOS文件夹以及HT开头的SDK功能模块dll，请依照如下指引进行配置：
- 选中Android文件夹下的so文件，在Inspector窗口中，“Select platforms for plugin”勾选“Android”，“Platform settings”中的“CPU”选择“ARM64”。
- 选中iOS文件夹下后缀为.h、.mm和.a的文件，在Inspector窗口中，“Select platforms for plugin”勾选“iOS”。
- 选中文件名包含Android的dll，在Inspector窗口中，“Select platforms for plugin”勾选“Android”。
- 选中文件名包含iOS的dll，在Inspector窗口中，“Select platforms for plugin”勾选“iOS”。
配置项目选项。

完成以上操作后，找到菜单栏的“Custom Tools”并单击“Set HTFoundation Config”配置项目选项，Unity将会自动进行以下设置：
- 通用设置：
  - 添加Tag：Photo、Object。
  - 添加Layer：
    - Layer6：HTUI
    - Layer17：Danger
  - 不使用垂直同步。
  - 默认使用竖屏。
  - 允许不安全代码。
  - 关闭代码裁剪。
- iOS设置：
  - iOS相机权限描述。
  - iOS定位权限描述。
  - IL2CPP脚本运行时环境。
- Android设置：
  - 使用OpenGLES3图形API。
  - 关闭多线程渲染。
  - 使用最小的SDK版本29。
  - 使用目标的SDK版本29。
  - IL2CPP脚本运行时环境。
  - 支持ARM64位处理器。
配置域名及密钥。

工程运行需要证书校验，请将申请到的AK/SK以及固定的BASE_URL填写在新建Unity工程的“Assets > HTFoundation > Scripts > BaseUtils > HTStringRes.cs”中的HTStringConfig里面。
说明：
- 申请AK/SK详情请参考获取AK/SK。
- 固定BASE_URL为：https://koomap.cn-north-4.myhuaweicloud.com。
```
// 认证用的AK、SK硬编码到代码中或明文存储都有很大的安全风险，建议在代码中配置加密后的AK、SK，在使用的地方解密。
public class HTStringConfig
{
    public const string AK = "加密后的内容";
    public const string SK = "加密后的内容";
    public const string BASE_URL = "";
}
```
验证结果。

在菜单栏单击“File > Build Settings > Add open Scenes”并添加HTFoundationTester场景：
- Unity导出Android apk：“Platform”选择“Android”，单击“Switch platform”。不勾选“Export Project”，单击“build”导出apk。
- Unity导出Android项目：“Platform”选择“Android”，单击“Switch platform”。勾选“Export Project”，单击“Export”导出项目。
- Unity导出iOS项目：“Platform”选择“iOS”，单击“Switch platform > Export”导出项目。