更新时间:2024-03-05 GMT+08:00
分享

快速开始

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

分享:

    相关文档

    相关产品