入门

在本节中，您将了解如何使用 YVR 插件设置第一个 VR 项目。

前提

硬件：YVR2，PFDM MR

软件：DreamOS 3.0.0

UE版本：4.27, 5.3, 5.4

创建项目

Epic中确保此引擎版本->选项->目标平台->Android为勾选状态
启动虚幻引擎
- 选择游戏（Games）
- 选择空白（Blank）项目
- c++
- 可扩展3D或2D
- 禁用光线追踪
- 手机/平板电脑
- 无初学者内容包
- 文件夹位置
- 项目名称
创建项目
- 4.27
- 5.3/5.4

Android Studio

下载
- 官网链接
安装
- 取消勾选Android Virtual Device
- 选择自定义安装路径（建议使用默认安装位置）
- Finish
初始设置
- 选择custom以便自定义SDK位置（建议使用默认安装位置）

引擎版本	SDK	ADB	NDK	JDK	gradle
4.27	29	30.0.3	21.4.7075529	1.8.0_271	6.1.1
5.3/5.4	32	33.0.3	25.1.8937393	18.0.2.1	7.5

注：其他版本需自行查阅

设置(需要根据引擎版本确定安装的版本)
- 点击 More Actions -> SDK Manager，进入 Settings 界面
- 安装SDK
  - SDK Platforms -> Android API Level
- 安装Build-Tools（adb），勾选Show Package Details
  - SDK Tools -> Android SDK Build-Tools
- 安装NDK，勾选Show Package Details
  - SDK Tools -> NDK

jdk

下载
- 官网链接
- 在java archive找历史版本
- .zip: 下载后，需要解压
- .exe:下载后，双击就可以进行安装了（常用下载方式）
- .msi:适合企业环境，适合批量安装
安装
- 选择安装路径
path配置
- 设置 -> 系统 -> 关于 -> 高级系统设置 -> 环境变量
- 系统变量：
  - JAVA_HOME
  - jdk安装路径
- path变量：添加jdk安装路径的bin路径
检验：java -version

配置项目

配置插件
- 将之前下载好的YVR Unreal SDK中的 Plugins 文件夹拷贝到项目根目录下
- 右键.uproject -> switch Unreal Engine version < version > -> Generate Visual Studio project files
- 通过.sln重新编译运行
- 检查 编辑（Edit） > 插件（Plugins） > 已安装（Installed） > Virtual Reality 中，是否显示YVR 插件
设置项目
- 关卡
  - 创建关卡
  - 在 编辑（Edit） > 项目设置（Project Settings中，将启动地图（Editor Startup Map）和游戏默认地图（Game Default Map都设置到您想要运行的关卡
- 输入
  - 选择引擎（Engine） > 输入（Input）。对于 Default Touch Interface，选择 Clear，将此值设置为 None
- 平台
  - 在平台（Platforms）部分, 选择 Android 并点击 Configure Now。然后，进行以下设置：
    - Minimum SDK Version: 25
    - Target SDK Version: 28
    - 勾选 Enable FullScreen Immersive on KitKat and above devices
- 渲染
  - 在引擎（Engine）部分，选择渲染（Rendering）。在 VR 部分，确保 Mobile HDR 已关闭
- 描述
  - 勾选project -> description -> Start in VR
- 打包
  - 勾选Platforms -> Android -> package game data inside .apk
链接目录
- 4.27
- 5.3/5.4
- Platforms -> Android SDK
- SDK路径：Android Studio 的安装位置
- NDK路径：Android Studio 的安装位置下的ndk路径
- JDK路径：jdk安装位置
- SDK级别：specific version特定版本 / latest最新版本 / matchndk匹配版本
- NDK级别：specific version特定版本 / latest最新版本 / matchndk匹配版本
- 注：以上均支持安装多个不同版本，根据引擎版本选择合适的特定版本