二、快速入门

了解如何导入SDK软件包，以及如何针对您的开发环境进行基本测试。

• 我们假设您已经了解了什么是虚拟现实及其使用的术语。 如果不是，请检查Unity XR词汇表。
• 强烈建议您在使用SDK之前，先阅读Unity XR文档，然后正确安装Unity Editor和ADB调试工具。

步骤1：

打开Unity Editor，新建工程

图2.1 创建工程

步骤2：

修改Platform为Android平台

图2.2 修改Platform

步骤3：

• 导入QIYU XR Plugin

PackageManager选择加号->Add package from disk按钮加载上面解压目录的package.json文件，XR插件就会自动导入。

图2.3 导入SDK

• 导入QIYU Platform SDK

对于要在奇遇商店上线的应用，导入QIYU XR Plugin之后，必须再导入QIYU Platform SDK，否则在上传应用提交审核时，无法通过平台检测。详细参见QIYU Platform SDK 及开发文档 (opens new window)。

步骤4：

导入后，点击“Yes”，启用Unity new input System，Unity Editor会自动重启。

图2.4 启用Unity new input System

步骤5：

导入以后会看到QIYU XR Plugin和QIYU Platform SDK；如果有需要，点击Import into Project导入Sample工程。

图2.5 导入Samples

步骤6：

新建场景，创建XRRig，XRRig提供的功能参见3.1UnityXR介绍 (opens new window)。

图2.6 创建XR Rig

步骤7：

必须在ProjectSettings—>XRPlug-in Management里的勾选“QIYU”选项

图2.7 开启QIYU

步骤8：

设置推荐配置，可通过“Menu/QIYU/Modify Player Settings”一键自动设置为推荐配置。

图2.8 常用菜单功能

配置项	推荐值
GraphicsAPIs	OpenGLES3
ApiCompatibilityLevel	.NET 4.x
minSdkVersion	AndroidApiLevel26
Scripting Backend	IL2CPP
Target Architectures	ARM64 (提交商店正式版本要求)
Default Orientation	LandscapeLeft
vSyncCount	Every V Blank
Blit Type	Always

表2.8 工程推荐配置

步骤9：

如果需要使用自定义AndroidManifest.xml文件，可以点击QIYU->Tools->Create AndroidManifest按钮创建SDK需要的默认配置模板，在此基础上进行修改。不需要的时候可以点击Delete AndroidManifest按钮进行删除。

图2.9 创建AndroidManifest配置

步骤10：

打包，安装进一体机运行。对于已经上架到奇遇商店的游戏，打release包需要Bundle Version Code 设置高于商店中应用的版本，详见FAQ (opens new window)。