在虚幻引擎中设置新的AR项目 | 虚幻引擎 5.0 文档

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

如果要使用已设置的AR项目进行启动，请参阅下面的AR模板：

设置空白项目

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

从Epic Games启动程序启动 虚幻引擎（Unreal Engine） 。
在 虚幻项目浏览器（Unreal Project Browser） 窗口中，选择 游戏（Games），然后点击 下一步（Next）。

点击查看大图。
选择 空白（Blank） 模板，然后点击 下一步（Next）。

点击查看大图。
对于 项目设置，进行如下选择：
- 蓝图
- 可扩展3D或2D
- 禁用光线追踪
- 手机/平板电脑
- 无初学者内容包
点击查看大图。
在编辑器中选择 文件（File） > 新关卡…（New Level…），然后选择 空白关卡（Empty Level）。命名关卡之后保存。在此示例中，将关卡命名为 Main。
在主导航中，选择 编辑（Edit）> 项目设置（Project Settings）。
在项目设置（Project Settings）窗口中，在 项目（Project） 部分下选择 地图和模式（Maps & Modes）。将 编辑器启动地图（Editor Startup Map） 和 游戏默认地图（Game Default Map） 设置为新关卡 Main。

点击查看大图。

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

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

在 内容浏览器（Content Browser） 中单击右键，从列表中选择蓝图类（Blueprint Class）。在 选择父类（Pick Parent Class） 窗口中，选择 Pawn。将资产命名为 ARPawn。
在 内容浏览器（Content Browser） 中，双击 ARPawn 对象，在 蓝图编辑器（Blueprint Editor） 中打开。在蓝图编辑器中，选择 添加组件（Add Component） 并搜索 摄像机（Camera）。
摄像机（Camera） 组件的父项必须是 DefaultSceneRoot。
在 内容浏览器（Content Browser） 中单击右键，从列表中选择 蓝图类（Blueprint Class）。在 选择父类（Pick Parent Class） 窗口中，选择 游戏模式基础（Game Mode Base）。将资产命名为 ARGameMode。
双击 ARGameMode 以编辑设置。将 默认Pawn类（Default Pawn Class） 设置为 ARPawn。

点击查看大图。
在主导航中，选择 编辑（Edit） > 项目设置（Project Settings） 以打开 项目设置（Project Settings） 窗口。
在左侧 项目（Project） 部分下的 项目设置（Project Settings） 窗口中，选择 地图和模式（Maps & Modes）。
1. 将 默认游戏模式（Default GameMode） 设置为 ARGameMode。
2. 将 默认Pawn类（Default Pawn Class） 设置为 ARPawn。
点击查看大图。

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

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

在 内容浏览器（Content Browser） 中右键单击。选择 杂项（Miscellaneous） > 数据资产（Data Asset），打开 选择数据资产类（Pick Data Asset Class） 窗口。
在 选择数据资产类（Pick Data Asset Class） 窗口中，选择 ARSessionConfig。将数据资产命名为 ARSessionConfig。打开资产，选择 保存（Save） 以确认默认AR选项。
双击 ARPawn 资产，在蓝图编辑器中（Blueprint Editor） 打开。添加函数 Set Tracking Origin。将 原点数值（Origin value） 设置为 底层关卡（Floor Level）。
添加函数 Start AR Session。将 会话配置（Session Config） 资产设置为 ARSessionConfig。
添加函数 Stop AR Session。

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

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