QIYU Unreal SDK

QIYU Unreal SDK provides support to develop QIYU VR applications in Unreal.

v1.6.0 | Published 2023-2-1

Click the download button to indicate that you have read and agree to the License.

Unreal SDK v1.6.0

Published 2023-2-1

• What's New

1. Support Qiyu MIX device (color passthrough is coming soon).

• What's Fixed

1. Fixed the low-probability issue that application could crash when enabled recording screen function.
2. Fixed the low-probability issue that application could be stuck at loading process.
3. Fixed the issue that transparent materials cannot be displayed normally.

Unreal SDK v1.5.0

Published 2022-8-15

• What's New

1. Provide PC direct preview to PLAY in UE VR Preview, and display the scene instantly in the VR device.
2. Support 90Hz display frame on QIYU Dream Pro device and provide APIs.
3. Support sales of downloadable content in QIYU store and provide DLC APIs.
4. Provide SetColorScaleandOffset API.
5. Add Dream Pro device into the supported device list.
6. Integration of QIYU platform SDK is required when submitting to QIYU store, otherwise the APP can not be approved by the platform review.
7. Optimized interactive experience of QIYU controllers and adjust rotation data so that the default initial direction is 35° upward.
8. Optimized the structure of SDK APIs.

• What's Fixed

1. Fixed the position error of the controller increases with the rotation angle of the HMD in 3Dof mode.
2. Fixed the controller vibration is unstable by using Play Haptic Effect, please upgrade version of controller to the latest one (v19).
3. Fixed the black screen issue during switching Eye Resolution Scale when using underlay and HDR in the 32-bit version of UE4.25.
4. Fixed Online Subsystem QIYU Platform plugins cannot connect the default Dedicated Server issue.

• Known Issues

1. UE 4.25 does not support Vulkan at the moment.
2. Low-probability screen flickers on Dream Pro device when switching display frame from 90Hz to 72Hz.

Unreal SDK v1.4.1

Published 2022-7-8

• What's Fixed

1. Fixed the low rate crash issue when starting the shipping builds.

Unreal SDK v1.4.0

Published 2022-4-24

• What's New

1. Optimized QIYU SDK architecture, decoupling VR SDK and Online Subsystem SDK.
2. Support In-APP Purchase and provide IAP APIs.
3. Provide VR Stereo Layers which let you render certain forms of content such as text, video, or textures with higher quality than traditional eye-buffer rendering can achieve.
4. Support 32 bits compiling to increase the efficiency of debugging (The 64 bits must be used in released version).
5. Provide 3Dof mode APIs.
6. Optimized the APIs and normalized the range of controller input.
7. Provide QIYU Dream controller models.

• What's Fixed

1. Fixed Unreal development statistics UI upside-down issue.
2. Deprecated the initialization API of PlayerPrefs in Platform SDK.

• Known Issues

1. In 3Dof mode, the position error of the controller increases with the rotation angle of the HMD. (Be fixed in the next version of SDK).
2. The controller vibration is unstable by using Play Haptic Effect, please use the QIYUController Start Vibration to achieve the vibration, we will fix this issue by releasing the controller version.
3. In the complex scene, the frame rate of Vulkan is lower than OpenGLES, we will fix this issue in the future version.
4. The Vulkan does NOT support Foveation Rendering or HDR right now.
5. MSAA does not work when using Vulkan and MultiView at the same time.
6. Dynamic adjust Eyebuffer Scale causes black screen when using Vulkan and HDR at same time.

Unreal SDK v1.3.0

Published 2022-2-22

• What's New

1. Support Vulkan.
2. Support Unreal 4.27.
3. Provide the get device Info API.
4. Provide controller model of QIYU Dream.

• What's Fixed

1. Optimized the platform initialization parameters (opens new window).
2. Deprecated CPU level and GPU level, which is managed by QIYU OS.

• Known issues

1. The controller vibration is unstable by using Play Haptic Effect, please use the QIYUController Start Vibration to achieve the vibration, we will fix this issue by releasing the controller version.
2. In the complex scene, the frame rate of Vulkan is lower than OpenGLES, we will fix this issue in the future version.
3. The Vulkan does NOT support Foveation Rendering or HDR right now.
4. MSAA does not work when using Vulkan and MultiView at the same time.

Unreal SDK v1.2.0

Published 2021-12-06

• What's New

1. Support QIYU Performance Tool (opens new window).
2. Provide QIYU PlayerPrefs APIs to save user data after upgrade, uninstall and re-install the application.
3. Provide guardian APIs for QIYU VR devices.
4. Provide a switch for custom VR Loading Screen.
5. Provide C++ APIs of platform solution.

• What's Fixed

1. Changed the platform solution initialization and account information APIs.
2. Changed Android Target SDK Version to 29.
3. Fixed black screen issue of casting.

• Deprecation

1. Request_InitQiyuSDK() is replaced by API RequestSDKInit(). Please change this part of code when you upgrade the SDK.
2. Request_AccountInfo() is replaced by RequestAccountInfo(). Please change this part of code when you upgrade the SDK.

• Known Issues

1. If pause-resume is repeated for several times, the application may exit abnormally.
2. The Recenter is disabled occasionally after awaking the QIYU device form sleep.

Unreal SDK v1.1.0

Published 2021-9-30

• What's New

1. Support Multi View.

2. Support VR Loading Screen.

3. Optimize Foveation Rendering and provide FFR Blueprint APIs.

4. Provide standard UE API ‘IHapticDevice’ and ‘pixelDensity’.

5. Provide QIYU controller model.

6. Provide return code for initialization of platform solution.

• What's Fixed

1. Fixed the jitter issue when turning head.

2. Fixed the issue that the screen is abnormal occasionally during screen recording.

3. Fixed the issue that the edge of view is stretched.

4. Closed some unnecessary logs.

• Deprecation

1. Deprecated the “Plugins-Qiyu-Eye Resolution Scale”, and using the UE standard console command vr.pixelDensity to modify the size of RenderTexture.

Unreal SDK v1.0.1

Published 2021-9-9

• What's New

1. Provide thumbstick 2DAxis，Trigger 1DAxis，Grip 1DAxis APIs.
2. Provide Eye Resolution Scale to modify Eyebuffer size. The default recommended value is set to 0.7 to increase FPS.
3. Provide UE standard Tracking Origin Blueprint.
4. Provide QIYU controller haptics Blueprint.

• What's Fixed

1. Optimized the rendering latency and joggle issue.
2. Fixed the rendering issue of Shipping build in UE 4.26.
3. Fixed the screen cannot be shown properly when turning off HDR In UE 4.26 version of QIYU SDK.
4. Fixed the screen recording black screen issue in UE 4.26.
5. Fixed the controllers lost issue when turning on/off the device or APP pause in UE 4.25.
6. Fixed the FPS reduction issue when looking at the ground.
7. Fixed the issue of chromatic aberration in the view edge.
8. Fixed the Abnormal display issue when turning on/off screen in many time.
9. Fixed the garbled display name issue of accountinfo API.
10. Fixed the issue that MSAA does not work.（less than 4x）

• Known Issues

1. Modifying the Eyebuffer size by using 'vr.pixelDensity' does not work now. "Eye Resolution Scale" is recommended at present.
2. If pause-resume is repeated for several times, the application may exit abnormally.

Unreal SDK v1.0.0

Published 2021-7-30

• Key Features:

1. Support Unreal Engine 4.25.4，4.26.2
2. Support floor level tracking origin mode
3. Platform solution (DLC, Deep linking, Account link）
4. Foveation rendering
5. Provide controller vibration APIs

• Known Issues:

1. The Shipping package renders incorrectly on Unreal 4.26, we will fix the issue as soon as possible.
2. Opening the boundary and looking at the ground may cause FPS reduction.
3. Multiple Screen on and off may cause abnormal display.

Alpha-v0.1.0

Published 2021-6-3

• Key Features:

1. Support QIYU Device.
2. Support Unreal Engine 4.25.

• Known Issues:

1. Opening the boundary and looking at the ground may cause FPS reduction.
2. Multiple Screen on and off may cause abnormal display.