# 快速开始
1. 创建Unity项目。
   
   新建一个Unity Project，"Template"选择"3D"。
   
   
2. 导入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",
      ```
      ![](https://support.huaweicloud.com/devg-koomap/public_sys-resources/note_3.0-zh-cn.png)
      您也可以在菜单栏"Windows"里找到"Package Manager"，单击"Package Manager"直接选择需要添加的插件。
      
   
   2. 插件包导入完成后配置平台支持ARCore XR Plugin和ARKit XR Plugin。 在菜单栏"Edit \> ProjectSettings \> XR Plug-in Management"路径下：
      - 选择![](https://support.huaweicloud.com/devg-koomap/zh-cn_image_0000001498884428.png)平台，勾选"ARCore"。
      
      - 选择iOS平台，勾选"ARKit"。
       
   
   
   
   
3. 导入HTFoundation示例。
   
   ![](https://support.huaweicloud.com/devg-koomap/public_sys-resources/note_3.0-zh-cn.png)
   请先在"File \> Build Settings \> Player Settings \> Player \> Other Settings"中找到"Allow 'unsafe' Code"，并将其勾选。
   1. 解压SDK压缩包Cyberverse-HTFoundation.zip。压缩包下载地址请参考[下载SDK](https://support.huaweicloud.com/devg-koomap/koomap_04_0027.html#koomap_04_0027__section7635821183915)。
   
   2. 将获取的Demo压缩包解压得到Assets文件夹。
   
   3. 在解压的"Cyberverse-HTFoundation \> CloudBuildOutput"下，找到HTFoundation文件夹，并将其合并到"Assets"下的HTFoundation文件夹。
   
   4. 将以上合并后的Assets文件夹合并到[1]新建的Unity工程的Assets目录。
   
   
   
   
4. 配置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"。
   
   
   
   
5. 配置项目选项。
   
   完成以上操作后，找到菜单栏的"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位处理器。
      
   
   
   
   
6. 配置域名及密钥。
   
   工程运行需要证书校验，请将申请到的AK/SK以及固定的BASE_URL填写在新建Unity工程的"Assets \> HTFoundation \> Scripts \> BaseUtils \> HTStringConfig.cs"中。
   ![](https://support.huaweicloud.com/devg-koomap/public_sys-resources/note_3.0-zh-cn.png)
   - 申请AK/SK详情请参考[获取AK/SK](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。
   
   - 固定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 = "";
   }
   ```
   
   
7. 验证结果。
   
   在菜单栏单击"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"导出项目。