首次接入指南

欢迎来到奇遇VR开发者平台，我们提供了功能丰富的VR应用软件开发工具包及解决方案，来保障奇遇开发者制作精彩的VR内容。如果您是新朋友，不妨花几分钟耐心看完以下内容。

1. 奇遇VR SDK

请根据您的开发引擎，选择对应的SDK，并推荐使用最新的SDK版本。

a. Unity

1. Unity XR SDK提供追踪、渲染、预测、交互等VR核心技术， 点击此处 (opens new window)下载最新版本。
2. Platform SDK 提供账户、社交、收入和所有奇遇平台相关功能，点击此处 (opens new window)下载最新版本。对于计划在奇遇应用商店上线的应用，为了保障应用版权的安全，必须接入Platform SDK。

b. Unreal

Unreal SDK面向通过Unreal Engine开发奇遇VR应用的开发者，点击此处 (opens new window)下载最新版本。对于计划在奇遇应用商店上线的应用，为了保障应用版权的安全，必须接入Online Subsystem QIYU模块。

c. Native

Native SDK提供C++原生接口，为开发者提供更加灵活的接入方式。点击此处 (opens new window)下载最新版本。

2. 奇遇性能工具说明

1. 功能：为奇遇VR应用提供实时的性能数据、曲线和报告，监控APP运行性能表现。

2. 下载地址

• 一体机版: 安装在奇遇VR一体机端，可以很方便、直观的看到应用当前的性能数据和曲线。点击此处 (opens new window)下载软件。

• PC版(推荐): 安装在Windows、Mac电脑端，通过USB线连接一体机，不影响应用运行效率，数据更加准确。点击此处 (opens new window)下载软件。

3. 奇遇各型号设备差异说明

奇遇3、Dream、Dream Pro设备都采用高通Snapdragon XR2芯片。主要区别于摄像头设计的布局和屏幕分辨率不同，奇遇3设备具备4K+的分辨率，对于清晰度要求较高的应用，可以在奇遇3上体验到更清晰的画面；Dream、Dream Pro设备的追踪摄像头布局可以更大范围的追踪和定位，对于运动类、手柄操作范围大的应用，优先使用Dream系列设备进行适配开发和优化。我们推荐最新型号的Dream Pro设备作为您的开发机。

4. APP上传工具

1. 在准备发布阶段，为了保证游戏安装包上传的速度和稳定性，请通过奇遇开发者平台工具上传您的文件（APK、OBB、DLC等），点击此处 (opens new window)下载工具。
2. 使用工具上传APK/OBB等文件后，需要继续在开发者平台网页，按顺序填写必要信息，再正式提交审核。
3. 如果是非首次上传APP，新包版本号必须高于前一个版本号。

5. 平台鉴权说明

为了保护内容版权，防止盗版，奇遇平台有鉴权机制。如果您的游戏已经上线到奇遇商店，那么您在本地安装游戏包时，对于release build，需要将version code设置的高于商店中已上线的版本号。比如：游戏A已经上线到奇遇商店，version code是1，那么您在本地安装A游戏的release包时，需将version code提高到2即可。具体参见SDK文档：Unity (opens new window)，Unreal (opens new window)。

6. 部分功能说明

1. 奇遇操作系统统一管控CPU和GPU级别，游戏无须手动调整；
2. Unity建议关闭多线程；
3. 用户数据存档（PlayerPrefs）：如果您的应用需要保存用户数据，请使用奇遇SDK提供数据存档接口实现应用数据持久化功能，防止用户在版本升级、卸载重装后丢失已有数据和档案。SDK提供的存档功能为本地化存档，非云存档。具体参见SDK文档：Unity (opens new window)，Unreal (opens new window)。

7. 开发者技术支持

奇遇开发者技术支持联系方式：vrsupport@qiyi.com，如有任何问题，请随时联系我们。