# 快速入门
通过Unreal Engine开始使用空间现实显示屏(Spatial Reality Display)吧!
## 前提条件
:::caution
如果您的虚幻引擎版本是 **5.3**,您在打开示例项目时将会收到错误消息。
要解决这个问题,您需要将示例项目中的插件更新为 **5.3**。\
有关更新插件的说明,请参阅[更新虚幻引擎](/Products/Developer-Spatial-Reality-display/zh/develop/UnrealEngine/HowToUpdate/)页面上的**当Spatial Reality Display Plugin位于项目的插件搜索路径中**。
:::
- 已设置Spatial Reality Display,如果尚未设置,请参阅:[设置Spatial Reality Display](/Products/Developer-Spatial-Reality-display/zh/develop/Setup/SetupSRDisplay.html),[设置Spatial Reality Display Settings](/Products/Developer-Spatial-Reality-display/zh/develop/Setup/SetupSRRuntime.html)。
- Spatial Reality Display已连接至电脑
- 已配置Spatial Reality Display设置
- 已安装Spatial Reality Display Settings
- 已安装Epic Games Launcher和Unreal Engine,请参阅:[安装虚幻引擎](https://docs.unrealengine.com/4.27/en-US/Basics/InstallingUnrealEngine/index.html)。
- 目前支持**UE4.27,5.3和5.4**
:::note
每次仅可运行一个Spatial Reality Display应用。第二个应用将无法启动。
:::
## 安装Spatial Reality Display Plugin和Template
1. 从[下载页面](/Products/Developer-Spatial-Reality-display/zh/develop/Setup/DownloadInfo.html)下载最新的**Spatial Reality Display Plugin**和**Spatial Reality Display Templates**。
2. 安装Spatial Reality Display Plugin。
解压缩**srd-ue-plugin-4.XX-x.y.z.nnnnn.zip**,并将解压缩后的文件夹SRDisplayPlugin复制到项目或引擎的Plugin检索路径中。
请点击[此处](https://docs.unrealengine.com/en-US/Programming/Plugins/index.html)查看安装插件的说明。
为了简化说明,之后的说明将以您已将SRDisplayPlugin复制到**C:\Program Files\Epic Games\UE_4.27\Engine\Plugins\Developer\\** 为前提。
:::caution
对于UE5,如果在 \`Epic Games\UE_5.x\Engine\Plugins\Marketplace\` 中安装了空间现实显示屏插件,则在创建新项目时会加载插件,这样您就可以开发空间现实显示屏UE应用程序,而无需每次都在项目文件夹中安装插件。(如果没有Marketplace文件夹,请创建一个新文件夹。)
对于UE5,请在创建项目时选择C++。 仅Blueprint项目无法正常工作。 如果选择Blueprint,请添加一些C++代码。
:::
3. 安装Spatial Reality Display Templates。
解压缩**srdisplay-ue-templates-x.y.z.nnnnn.zip**,并将解压缩后的文件夹TP_SRDisplay和TP_SRDisplayBP复制到引擎的模板目录中。请点击[此处](https://docs.unrealengine.com/en-US/Engine/Basics/Projects/CreatingTemplates/index.html)查看安装模板的说明。
为了简化说明,之后的说明将以您已将TP_SRDisplay和TP_SRDisplayBP复制到**C:\Program Files\Epic Games\UE_4.27\Templates\\** 为前提。
## 构建并运行Spatial Reality Display应用
1. 您可以从[下载页面](/Products/Developer-Spatial-Reality-display/zh/develop/Setup/DownloadInfo.html#unreal-engine-samples)Spatial Reality Display的Unreal Engine示例项目。
2. 将**SRDisplaySamplesProject_x.y.z.nnnnn.zip**解压缩到任意文件夹中。
3. 使用UE Editor开启示例。
右键单击SRDisplaySamples.uproject,然后从内容菜单中选择“Switch Unreal Engine version…”。
请在弹出的“Select Unreal Engine Version”窗口中,选择已安装Spatial Reality Display Plugin的引擎。
![Select Unreal Engine Version 窗口](/Products/Developer-Spatial-Reality-display/img/develop/UnrealEngine/Quickstart/ue-quickstart-sampleproject-01.webp){.img50 .img-tab-80 .img-sp-100}
4. 开启SRDisplaySamples项目。
双击SRDisplaySamples.uproject并在UE Editor中开启。
会弹出“Missing SRDisplaySamples Modules”对话窗口。
点击“是”开始重新构建示例项目的c++源代码。
![Missing SRDisplaySamples Modules 对话窗口](/Products/Developer-Spatial-Reality-display/img/develop/UnrealEngine/Quickstart/ue-quickstart-sampleproject-02.webp){.img50 .img-tab-80 .img-sp-100}
5. 开启示例地图“MainMenu”。
构建源代码可能需要花费一些时间。完成构建后,Editor和示例地图“MainMenu”将自动开启。
![示例地图 MainMenu](/Products/Developer-Spatial-Reality-display/img/develop/UnrealEngine/Quickstart/ue-quickstart-sampleproject-03.webp){.img50 .img-tab-80 .img-sp-100}
6. 通过VR Preview mode运行“MainMenu”。
在Play按钮旁边的下拉菜单中选择VR Preview。
![MainMenu 下拉菜单](/Products/Developer-Spatial-Reality-display/img/develop/UnrealEngine/Quickstart/ue-quickstart-sampleproject-04.webp){.img50 .img-tab-80 .img-sp-100}