文档首页/ 云地图服务 KooMap/ 开发指南/ HTSDK使用手册/ 快速开始
更新时间：2024-03-05 GMT+08:00
查看PDF
分享

快速开始

  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",

      您也可以在菜单栏“Windows”里找到“Package Manager”，单击“Package Manager”直接选择需要添加的插件。

    2. 插件包导入完成后配置平台支持ARCore XR Plugin和ARKit XR Plugin。

      在菜单栏“Edit > ProjectSettings > XR Plug-in Management”路径下：

      • 选择平台，勾选“ARCore”。
      • 选择iOS平台，勾选“ARKit”。

  3. 导入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目录。

  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”。
    • 选中文件名包含Android的dll，在Inspector窗口中，“Select platforms for plugin”勾选“Android”。
    • 选中文件名包含iOS的dll，在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 > 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 = "";
}

  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”导出项目。

父主题： HTSDK使用手册

相关文档