奇遇 Unreal SDK

奇遇Unreal SDK支持开发者在Unreal Engine中开发奇遇VR内容。

v1.6.0 | 发布时间 2023-2-1

点击下载，即代表您已阅读并同意许可条款。

Unreal SDK v1.6.0

发布时间 2022-2-1

• 新增功能

1. 支持奇遇 MIX设备（暂未提供彩色透视接口，我们会尽快支持）

• 修复问题

1. 修复开启录屏后，应用低概率闪退的问题
2. 修复应用首次启动时，低概率loading卡死问题
3. 修复透明材质无法正常显示的问题

Unreal SDK v1.5.0

发布时间 2022-8-15

• 新增功能

1. 提供PC direct preview工具，支持在UE VR Preview，同时一体机中显示实时画面
2. 支持90Hz，并提供功能接口（仅在奇遇 Dream Pro设备上生效）
3. 支持可下载附加内容，应用可在奇遇商店中售卖DLC
4. 提供SetColorScaleandOffset接口
5. 支持的设备列表增加Dream Pro设备
6. 对于上线至奇遇商店的应用，必须集成奇遇平台插件，否则无法通过平台上传检测
7. 优化手柄自然交互体验，调整手柄旋转数据默认初始方向，以握持杆斜向上35°为初始方向
8. 优化SDK代码结构

• 修复问题

1. 修复3Dof模式下，转头角度较大时手柄位置误差较大的问题
2. 修复通过Play Haptic Effect控制手柄震动强度不稳定的问题，请升级到奇遇手柄软件最新版本（v19）即可修复
3. 修复UE4.25，32位版本，开启HDR，使用Underlay时，切换Eye Resolution Scale时，出现的概率黑黑屏问题
4. 修复Online Subsystem QIYU平台插件无法连接默认Dedicated Server的问题

• 已知问题

1. 由于UE 4.25的一些问题，暂不支持在UE4.25中使用Vulkan
2. Dream Pro设备上，90hz切换到72hz，低概率屏幕闪烁

Unreal SDK v1.4.1

发布时间 2022-7-8

• 修复问题

1. 修复shipping包在启动时低概率崩溃的问题。

Unreal SDK v1.4.0

发布时间 2022-4-24

• 新增功能

1. 优化奇遇SDK架构，解耦VR SDK和Online Subsystem SDK
2. 支持应用内支付 (In-App Purchase)
3. 支持VR Stereo Layers
4. 支持32位编译，提升开发阶段的编译效率（正式提交商店的版本必须为64位）
5. 支持3-Dof 模式
6. 优化手柄部分接口，归一化量程
7. 提供奇遇Dream手柄模型

• 修复问题

1. 修复 Unreal development statistics UI倒置的问题
2. 取消平台SDK-数据存档初始化接口

• 已知问题

1. 3-Dof模式下，转头角度较大时手柄位置误差较大（下版本修复）
2. 通过Play Haptic Effect控制手柄震动强度不稳定，请先通过QIYUController Start Vibration实现手柄震动，我们会尽快修复（升级手柄软件版本）
3. 在复杂场景中Vulkan帧率低于OpenGLES，我们会尽快修复
4. Vulkan暂不支持注视点渲染、HDR
5. 同时使用Vulkan和MultiView时，MSAA 不生效
6. 同时使用Vulkan和HDR时，动态调节Eyebuffer Scale出现灰屏

Unreal SDK v1.3.0

发布时间 2022-2-22

• 新增功能

1. 支持Vulkan
2. 支持Unreal 4.27
3. 提供获取设备名称接口
4. 提供奇遇Dream手柄模型
5. 优化平台初始化接口

• 修复问题

1. 优化平台初始化接口 (opens new window)，减少不必要的参数
2. 取消CPU level、GPU level选项，统一由系统管控

• 已知问题

1. 通过Play Haptic Effect控制手柄震动强度不稳定，请先通过QIYUController Start Vibration实现手柄震动，我们会尽快修复（升级手柄软件版本）
2. 在复杂场景中Vulkan帧率低于OpenGLES，我们会尽快修复
3. Vulkan暂不支持注视点渲染、HDR
4. 同时使用Vulkan和MultiView时，MSAA 不生效

Unreal SDK v1.2.0

发布时间 2021-12-06

• 新增功能：

1. 支持奇遇性能分析工具 (opens new window)
2. 提供用户数据存档接口，支持应用升级、卸载重装后保留用户存档数据
3. 提供奇遇VR一体机设备安全围栏接口
4. 为自定义的VR Loading Screen提供开关
5. 提供平台功能的C++ 接口

• 修复问题：

1. 调整平台功能的初始化、获取账号信息接口的名称及调用形式
2. 调整Android Target SDK Version为29
3. 修复投屏黑屏的问题

• 弃用功能：

1. 取消平台功能的初始化接口Request_InitQiyuSDK()的名称及调用形式，采用新接口RequestSDKInit，请开发者在升级SDK版本后更正
2. 取消获取账号信息接口Request_AccountInfo()的名称及调用形式，采用新接口RequestAccountInfo，请开发者在升级SDK版本后更正

• 已知问题：

1. 反复多次pause-resume，可能会造成应用异常退出
2. 设备灭亮屏后，Recenter偶现失效

Unreal SDK v1.1.0

发布时间 2021-9-30

• 新增功能：

1. 支持Multi View

2. 支持VR Loading Screen

3. 优化注视点渲染效果并提供蓝图接口

4. 提供IHapticDevice，pixelDensity Unreal引擎标准接口功能

5. 提供奇遇3手柄模型

6. 提供Platform Solution 初始化返回码

• 修复问题：

1. 修复转头画面抖动的问题

2. 修复录屏时画面偶现异常的问题

3. 修复视野边缘画面拉伸的问题

4. 关闭不必要的log

• 弃用功能：

1. 取消"Plugins-Qiyu-Eye Resolution Scale"功能，采用Unreal引擎标准控制台命令 'vr.pixelDensity' 调节RenderTexure大小

Unreal SDK v1.0.1

发布时间 2021-9-9

• 新增功能：

1. 提供手柄摇杆、扳机键、侧握键的键程接口
2. 提供Eye Resolution Scale功能，支持修改Eyebuffer大小（默认推荐0.7），可有效提高帧率
3. 提供UE引擎标准蓝图接口Tracking Origin
4. 提供奇遇手柄震动蓝图接口

• 修复问题：

1. 优化画面渲染卡顿、抖动问题
2. 解决UE 4.26上Shipping打包渲染异常的问题
3. 解决UE 4.26上，关闭HDR，屏幕闪烁无法正常显示的问题
4. 解决UE 4.26上录屏功能异常的问题
5. 解决UE 4.25 Development版本，设备灭亮屏、应用pause导致手柄模型丢失的问题
6. 解决看向地面时，应用降帧的问题
7. 解决视野边缘色散问题
8. 解决频繁的设备亮灭屏概率性显示异常的问题
9. 解决账号接口-昵称字段显示乱码问题
10. 解决MSAA无效的问题（推荐不大于4x）

• 已知问题：

1. 通过vr.pixelDensity 修改Eyebuffer大小不生效，暂时需要通过“Eye Resolution Scale”调节
2. 反复多次pause-resume，可能会造成应用异常退出

Unreal SDK v1.0.0

发布时间 2021-7-30

• 新增功能：

1. 支持Unreal Engine 4.25.4，4.26.2
2. 支持真实身高追踪模式
3. 平台方案（DLC、Deep linking、Account link）
4. 注视点渲染（Foveation Rendering）
5. 提供手柄震动功能并提供接口

• 已知问题：

1. 在Unreal 4.26上，Shipping包渲染异常，我们会尽快修复
2. 开启安全围栏并看向地面时，可能会引起应用降帧
3. 频繁的设备亮灭屏可能会导致显示异常

Alpha-v0.1.0

发布时间 2021-6-2

• 新增功能

1. 支持奇遇3一体机设备
2. 支持Unreal Engine 4.25

• 已知问题

1. 开启安全围栏并看向地面时，可能会引起应用降帧
2. 频繁的设备亮灭屏可能会导致显示异常