-->

快速了解BlooXR开发

配置Unity开发环境

开发工具

BLOO Alice一体机
PC: 推荐使用Windows10操作系统作为BLOO XR应用的开发环境

Unity编辑器

Unity编辑器（Unity Editor）须使用2020.3.16及以上版本

注意，下载编辑器版本时，在添加模块窗口处务必勾选Android Build Support 下的所有选项（包括Android SDK&NDK tools，OpenJDK），该操作将帮助你完成所Android 开发所需的环境配置。

BLOO XR SDK下载并导入

下载最新BLOOXR integration SDK

解压SDK压缩包，你将会得到一个包含package.json文件的文件目录；
创建指定编辑器版本的unity 3D模板项目；
在unity 编辑器的菜单栏处，选择Windows > Package Manager；
在 Package Manager 窗口中，点击 + > Add package from disk；

package导入时，若出现如下弹窗，点击“Yes”按钮即可；
选择SDK目录下的 package.json 文件并导入
导入完成后，你将看到BXR SDK Setting窗口，完成建议配置，勾选点击“Apply”。编辑器将会继续初始化SDK，初始化完毕后关闭相关窗口。

注意

导入完成后，请在项目的package manager中确认是否已经安装了OpenXR Plugin以及XR interaction Toolkit（OpenXR Plugin须1.3版本及以上，推荐使用最新版本；XR Interaction Toolkit 推荐使用最新版本2.1.1），通常情况下正确导入BXR SDK后以上两个Plugin应已经安装到推荐版本。

完成项目配置

BXR SDK 不支持开发PCVR项目，只支持Android VR一体机应用开发。

本文介绍使用 Bloo Unity Integration SDK 开发应用前的必要项目配置。按照配置顺序，分为以下部分：

启用 OpenXR 模块
选择目标平台
其他设置

启用OpenXR模块（Android）

按以下步骤启用 OpenXR 模块：

在 Unity 编辑器中打开项目。
从上方菜单栏处，选择 Edit > Project Settings。
在 Project Settings 窗口中，点击 XR Plug-in Management > 安卓机器人图标。
勾选OpenXR

如果勾选选项后出现红色感叹号图标，点击该图标后弹出下图提示页面，点击“Fix”或“Edit”选项修改即可
点击“XR Plug-in Management“选项下的“OpenXR”选项，切换Android平台，“OpenXR Feature Groups”栏勾选“BlooXR Support”选项。

> 如果勾选选项后出现红色感叹号图标，点击该图标后弹出下图提示页面，点击“Fix”或“Edit”选项修改即可
> ![image](https://user-images.githubusercontent.com/112045530/194694364-976ca186-2c72-4b96-9997-414153e4b838.png)

Interaction profiles： BlooXR support 当前仅支持BlooXR touch controller profile以及Oculus touch controller profile。

选择目标平台

BlooXR应用的目标编译平台是安卓平台。开发应用前，需要在项目设置中将平台切换至 Android。应用构建完毕后将自动生成相应的 APK 文件。

在 Unity 编辑器中打开项目。
从上方菜单栏处，选择 File > Build Settings。
在 Build Settings 窗口中，从 Platform 列表处选择 Android
点击Switch Platform。当按钮变为build时，则表明切换成功，即可关闭窗口

其他设置

手柄（controller）相关配置

project setting的XR plug-in management中的OpenXR设置中：BlooXR support 当前仅支持添加 Interaction profiles中的BlooXR touch controller profile以及Oculus touch controller profile
Controller开发需要使用Action-based模式，input action选用XR Controller节点，配置类似如下图：
项目开发时，Input System需要使用新版本，设置路径如下：
- project settings” ->“Player” -> “Active Input Handing”模式选择“Input System Package(New)

编译及系统依赖

在build工程时需要加入Kotlin依赖库，具体设置步骤如下：

“project settings” ->“Player” ->“Build”选项中勾选“Custom Main Gradle Template”选项

打开工程中“Assets\Plugin\Android”目录下的” mainTemplate.gradle”文件，并在”dependencies”中添加Kotlin依赖库

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.6.10'
**DEPS**}

设置项目最低支持Android API level

“project settings” ->“Player” ->“Minimum API Level”选项选中 “Android 8.0‘Oreo’（API level 26）”选项
将Target API Level 设置为 Automatic (highest installed)

注意

配置完成后，建议保存并重新启动工程后进行开发。

搭建基础XR场景

Sample（包含controller sample）

你可以在Unity的package manger中，下载OpenXR Plugin的Samples（如下图），并快速了解如何构建VR的基础场景。

Controller是一个涵盖头戴和手柄配置的场景。可以验证基础的6Dof以及手柄交互功能。