虚幻引擎5文档已被迁移至 Epic开发者社区

本指南介绍如何在虚幻引擎中创建新的空白项目，并添加必要的蓝图和配置，将其转变成AR体验。

设置空白项目

按照以下步骤创建新的虚幻引擎项目和关卡，并启用最少的渲染功能。空白项目将会打开，其中带有默认关卡，包含天空球体和大气雾对象。这些对象将持久地覆盖AR中的所有内容，因此在创建AR体验时启动空白关卡将很有用，可以控制将显示哪些内容。

1. 从 Epic Games启动程序 启动 虚幻引擎（Unreal Engine） 。

2. 在 虚幻项目浏览器（Unreal Project Browser） 窗口中，选择 游戏（Games） ，然后点击 下一步（Next） 。

3. 选择 空白（Blank） 模板，然后点击 下一步（Next） 。

4. 对于项目设置，进行如下选择：

   • 蓝图

   • 可扩展3D或2D

   • 禁用光线追踪

   • 手机/平板电脑

   • 无初学者内容包

5. 在编辑器中选择 文件（File） > 新关卡…（New Level…） ，然后选择 空白关卡（Empty Level） 。命名关卡之后保存。在此示例中，将关卡命名为 Main 。

6. 在主导航中，选择 编辑（Edit）> 项目设置（Project Settings） 。

7. 在项目设置（Project Settings）窗口中，在 项目（Project） 部分下选择 地图和模式（Maps & Modes） 。将 编辑器启动地图（Editor Startup Map） 和 游戏默认地图（Game Default Map） 设置为新关卡 Main 。

添加Pawn和游戏模式

在虚幻引擎中， pawn 是用户的物理呈现，将定义用户如何与世界交互。 游戏模式 对象定义体验规则，例如要使用哪个Pawn对象。为了构建新的AR项目，你需要设置Pawn以便在运行应用时与环境进行交互。

按照下面的步骤进行操作，为你的AR项目创建Pawn和游戏模式。

1. 在 内容浏览器（Content Browser） 中单击右键，从列表中选择蓝图类（Blueprint Class）。在 选择父类（Pick Parent Class） 窗口中，选择 Pawn 。将资产命名为 ARPawn 。

2. 在 内容浏览器（Content Browser） 中，双击 ARPawn 对象，在 蓝图编辑器（Blueprint Editor） 中打开。在蓝图编辑器中，选择 添加组件（Add Component） 并搜索 摄像机（Camera） 。

3. 摄像机（Camera） 组件的父项必须是 DefaultSceneRoot 。

4. 在 内容浏览器（Content Browser） 中单击右键，从列表中选择 蓝图类（Blueprint Class） 。在 选择父类（Pick Parent Class） 窗口中，选择 游戏模式基础（Game Mode Base） 。将资产命名为 ARGameMode 。

5. 双击 ARGameMode 以编辑设置。将 默认Pawn类（Default Pawn Class） 设置为 ARPawn 。

6. 在主导航中，选择 编辑（Edit） > 项目设置（Project Settings） 以打开 项目设置（Project Settings） 窗口。

7. 在左侧 项目（Project） 部分下的 项目设置（Project Settings） 窗口中，选择 地图和模式（Maps & Modes） 。

   1. 将 默认游戏模式（Default GameMode） 设置为 ARGameMode 。

   2. 将 默认Pawn类（Default Pawn Class） 设置为 ARPawn 。

创建AR会话

函数 **Start AR Session**需要ARSessionConfig对象，该对象定义项目的所有AR特定功能。如需详细了解每个设置分别是什么，请参见 UARSessionConfig 。

按照下面的步骤将AR会话逻辑添加到你的项目。

1. 在 内容浏览器（Content Browser） 中右键单击。选择 杂项（Miscellaneous） > 数据资产（Data Asset） ，打开 选择数据资产类（Pick Data Asset Class） 窗口。

2. 在 选择数据资产类（Pick Data Asset Class） 窗口中，选择 ARSessionConfig 。将数据资产命名为 ARSessionConfig 。打开资产，选择 保存（Save） 以确认默认AR选项。

3. 双击 ARPawn 资产，在**蓝图编辑器中（Blueprint Editor） 打开。添加函数 Set Tracking Origin 。将 原点数值（Origin value） 设置为 底层关卡（Floor Level）**。

4. 添加函数 Start AR Session 。将 会话配置（Session Config） 资产设置为 ARSessionConfig 。

5. 添加函数 Stop AR Session 。

在你的设备上启动项目时，现在可以在你的AR环境中导航。请参见你的AR平台文档，了解在你的设备上启动虚幻项目的详细步骤。

第4步 - 自行尝试

在本指南中，你学习了如何创建新的AR项目，以及如何添加必要的蓝图以开始构建AR应用。