Unreal 快速入门

设置您的开发环境

  • 按照下列步骤使用源代码构建带 GoogleARCore 插件的 Unreal Engine 4.20:

    • 访问 Epic 的 GitHub 代码库。

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

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

      或者,如果开发者已有 Unreal Engine 4.20 代码库,也可通过以下命令将 4.20-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.20-arcore
      git merge google-ar-unreal/4.20-arcore

      注意:Unreal Engine 4.20 包括 1.3 版的 ARCore 插件。 要使用 ARCore 1.4,您必须从 Google 的 Unreal Engine 分支获取最新的 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 Level 设置为“matchndk”。 然后将 NDK API Level 设置为 android-24 或更高。

构建并运行示例应用

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

    将出现一个对话框。 在该对话框中新建一个名为 Builds 的文件夹并点击 Select

  2. Unreal 开始打包项目并在状态窗口(右下角)中显示进度。 如需了解有关打包过程的详情,请查看 Output Log 窗口。

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

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

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

后续步骤

  • 了解如何在您的应用中启用 ARCore
  • 使用增强图像来构建能对用户环境中的海报或徽标等 2D 图像作出响应的应用。
  • 让您的应用以 iOS 或 Android 为目标平台,并利用云锚点来打造 Android 和 iOS 用户可共享的 AR 体验。 要开始使用云锚点,请参阅 Unreal 云锚点快速入门