Unreal 快速入门

设置开发环境

  • 请按照以下步骤在源代码中使用 GoogleARCore 插件构建 Unreal Engine 4.20:

    • 加入 Epic Games 组织,获取对 Epic' 的 GitHub 代码库的访问权限。

    • 使用以下命令克隆 google-ar-unreal 代码库:

      git clone -b 4.21-arcore \
      https://github.com/google-ar-unreal/UnrealEngine.git

      或者,如果开发者已有 Unreal Engine 4.20 代码库,可以使用以下命令将 4.21-arcore 分支合并到自己的分支中:

      # Checkout your target branch, which must be based on Unreal 4.20
      git checkout <target-branch>
      
      # Add google-ar-unreal as a remote
      git remote add google-ar-unreal https://github.com/google-ar-unreal/UnrealEngine.git
      
      # Fetch and merge the arcore branch
      git fetch google-ar-unreal 4.21-arcore
      git merge google-ar-unreal/4.21-arcore
    • 从源代码构建 Unreal Engine

      • 请确保在第一步中选择操作系统。
      • 防止设置使用 Epic 提供的旧文件覆盖所包含的 Google ARCore 二进制文件。当您看到 Would you like to overwrite your changes (y/n)? 时,选择 n
  • 按照 Android 快速入门设置用于 Android 开发的 Unreal 编辑器。确保安装 Android SDK Platform 7.0(API 级别 24)或更高版本。

  • 您需要获取 Unreal HelloAR 示例项目。您可以执行以下任一项操作:

    • 下载示例项目代码库并将其解压缩。

      -或-

    • 使用以下命令克隆代码库:

      git clone https://github.com/google-ar/arcore-unreal-sdk.git

  • 您需要使用受支持的 Android 设备

准备设备

如需准备受支持的设备,请启用开发者选项和 USB 调试

打开示例项目

在 Unreal 编辑器中,打开 HelloAR 示例项目。

设定 Android 开发设置

  1. 在菜单栏中,点击 Edit > Project Settings

  2. 在“Project Settings”的 Android SDK 平台下,确保所有路径都正确设置为 Android SDK 和 Android NDK 安装路径。将 SDK API 级别设为 'matchndk'。然后将 NDK API 级别设置为 android-24 或更高版本。

构建和运行示例应用

  1. 打包 HelloAR 项目。在菜单栏中,选择 File > Package Project > Android > Android (ASTC)

    系统会显示一个对话框。在该方框中,创建一个名为 Builds 的新文件夹,并点击选择

  2. Unreal 开始打包项目,并在状态窗口(右下角)中显示进度。如需详细了解打包过程,请参阅输出日志窗口。

  3. 项目打包完成后,请确保您的设备已连接到计算机。打开“Builds”文件夹并双击文件 Install_HelloARUnreal_Development-armv7-es2.bat(如果您使用的是 Windows)或 Install_HelloARUnreal_Development-armv7-es2.command(如果您使用的是 Mac)文件,以在 Android 智能手机上安装项目。

  4. 安装完成后,在设备上查找名为 HelloAR UE4 的应用并启动该应用。

当您移动设备时,该应用会自动检测平面并绘制钻石网格。点按网格可在表面放置 Android 机器人。

后续步骤