二、快速入门

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

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

步骤1：

打开Unity Editor，新建工程

步骤2：

修改Platform为Android平台

步骤3：

• 导入QIYU XR Plugin

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

• 导入QIYU Platform SDK

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

步骤4：

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

步骤5：

导入以后会看到QIYU XR Plugin；点击Import into Project导入Sample工程，参考SDK提供的各种功能用法。

（导入Sample后，如Unity Editor无报错，请忽略此段说明）如工程中使用XR Interaction Toolkit v2.0及以上版本，导入QIYU XR Samples后，Unity Editor会提示BoundaryTest.cs脚本中，“trackingOriginMode未定义”的错误，这是由于XRRig属性trackingOriginMode已更名为currentTrackingOriginMode，请手动修改代码，如下图所示。

步骤6：

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

注：

• 新建的XRRig会覆盖场景默认的MainCamera。

• 奇遇SDK默认匹配XR Interaction Toolkit (opens new window) v1.0，如工程中使用v2.0及以上版本，XRRig更名为XROrigin。

步骤7：

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

步骤8：

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

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

（可选）步骤9：

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

步骤10：

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