快速开始

新建一个Unity Project，“Template”选择“3D”。

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”。

请先在“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目录。

在新建的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”导出项目。