# QIYU Unity XR SDK

QIYU Unity XR SDK provides support to develop QIYU VR apps in Unity.

v1.6.1 | Published 2023-05-09

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

# Unity XR SDK v1.6.1

Published 2023-05-09

  • New Features
  1. Support QIYU X device.
  2. Provide MR capabilities API.
  3. Optimized the issue of unstable passthrough image.
  • Solved Issues
  1. Fixed the issue that apps can't started in Vulkan.

# Unity XR SDK v1.6.0

Published 2023-02-21

  • New Features
  1. Provide Passthrough function and interface (Support QIYU MIX and QIYU Dream Pro devices).
  • Known Issues
  1. Passthrough does not support enabling HDR, Vulkan.
  2. For Dream Pro device, before developing MR applications, you need to manually install two services and reboot the device. Click the link to download the installation package (opens new window)
  3. Due to Passthrough adds rendering layer, the resource utilization rate will become higher, so please try to optimize the complexity of the scene model to ensure the runtime performance.
  4. Due to the particularity of the Passthrough rendering layer for Alpha channel processing, some semi-transparent materials in the scene are not displayed normally, refer to 3.8.3 (opens new window) for the solution.

# Unity XR SDK v1.5.0

Published 2022-12-29

  • New Features
  1. Support Qiyu MIX device .
  • Fixed Issues
  1. Fixed the low-probability issue that the platform SDK cannot initialize.
  2. Fixed the issue that the Underlay covers the Overlay. Composition Layers render according to the Layer ID, smaller values render first.
  • Known Issues
  1. In URP project, if enable the Vulkan and Multiview at the same time, the screen will be black after switching scenes many times.

# Unity XR SDK v1.4.1

Published 2022-09-02

  • New Features
  1. Provide device information APIs, which can get device manufacturer, name, serialNumber and other information.
  • Fixed Issues
  1. Fixed the issue that development build cannot be started.
  2. Fixed the low-probability issue that application cannot be started when enabled the recording function.
  • Known Issues
  1. In URP project, set eyeTextureResolutionScale to1.0 may not work.
  2. In URP project, please disable the HDR (default enable) when using underlay.
  3. In URP project, FFR modification would not work on Unity 2020 or 2021.
  4. PC Direct Preview has obvious latency when used on some computers with low configuration.
  5. During PC direct preview, the screen will be stuck when turn to ActionBasedController scene on Unity2019 or 2020.
  6. Low-probability screen flickers on Dream Pro device when switching display frame from 90Hz to 72Hz.

# Unity XR SDK v1.4.0

Published 2022-07-25

  • New Features
  1. Provide PC direct preview to PLAY in Unity Editor, and display the scene instantly in the VR device.
  2. Support 90Hz display frame on QIYU Dream Pro device and provide APIs.
  3. Optimized interactive experience of QIYU controllers and adjust rotation data so that the default initial direction is 35° upward.
  4. Add Dream Pro device into the supported device list.
  • Fixed Issues
  1. Fixed the black screen issue with frequent startup and exit applications during recording.
  2. Fixed the overlay rendering issue in URP project.
  • Known Issues
  1. In URP project, set eyeTextureResolutionScale to1.0 may not work.
  2. In URP project, please disable the HDR (default enable) when using underlay.
  3. In URP project, FFR modification would not work on Unity 2020 or 2021.
  4. PC Direct Preview has obvious latency when used on some computers with low configuration.
  5. During PC direct preview, the screen will be stuck when turn to ActionBasedController scene on Unity2019 or 2020.
  6. Low-probability screen flickers on Dream Pro device when switching display frame from 90Hz to 72Hz.

# Unity XR SDK v1.3.2

Published 2022-04-28

  • Fixed Issue
  1. Fixed the compatibility issue in multiple devices, when using the Action-Based Input.

# Unity XR SDK v1.3.1

Published 2022-04-12

  • Fixed Issue
  1. Fixed the frame rate dropping issue.

# Unity XR SDK v1.3.0

Published 2022-04-01

  • Key Feature
  1. Optimize QIYU SDK architecture, decoupling XR SDK (opens new window) and Platform SDK (opens new window), please refer to the 5.1 Old Version Porting (opens new window) in Platform FAQs.

  2. Provide VR compositor 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.

  3. Provide scene quick preview function to increase the efficiency of debugging.

  4. Provide 3Dof mode APIs.

  5. Support 32 bits compiling to increase the efficiency of debugging (The 64 bits must be used in released version).

  6. Provide dynamic loading demos for different types of controller models.

  • Fixed Issues
  1. Fixed a "texture compressed" issue with Linear Color Space rendering.

  2. Optimized QIYU boundary APIs.

  • Known Issues
  1. Vulkan does NOT support Foveation Rendering or External Surface in Compositor Layers.
  2. When enable HDR rendering in Graphics Settings, the Foveation Rendering or Underlay in Compositor Layers cannot take effect.

# Unity XR SDK v1.2.1

Published 2022-02-16

  • Fixed Issues
  1. Fixed the issue that Anti Aliasing level does not work.

# Unity XR SDK v1.2.0

Published 2022-01-27

  • Key Features
  1. Support In-APP Purchase and provide IAP APIs.
  2. Provide XR.InputDevice.name API.
  3. Provide controller model of QIYU Dream.
  4. Multi View is available in Vulkan.
  • Fixed Issues
  1. Optimized the API of InitQiyuSDK (for Platform Initialization), and deprecated unnecessary parameters.
  2. Fixed the orientation issue of velocity and acceleration after pressing Home button on Controller.
  3. Deprecated CPU level and GPU level, which is managed by QIYU OS.
  4. Deprecated the requirement which the scenes must add “QiyuManager” . If updated SDK causes multiple UI overlay, please refer 7.7 solution.
  • Known Issues
  1. If enable the Vulkan and Multiview at the same time, please using the Unity 2020.3.14 or above, otherwise, the rendering will be abnormal.
  2. If enable the HDR, Vulkan and Multiview at the same time, please using the Unity2021.2.8f1or above, otherwise, the rendering will be abnormal.
  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 API does NOT support Foveation Rendering right now.
  5. When Graphics enable the HDR, the FFR does not work.

# Unity XR SDK v1.1.2

Published 2021-11-15

  • Key Features
  1. Compatible with the related functions of QIYU SDK, the QiyuManager will be added automatically when creating a XRRig.
  • Solved Issues
  1. Fixed the abnormal data issue from QIYU Performance Tool.
  • Known Issues
  1. Vulkan is currently an experimental function, it might causes performance degradation in some scenes.
  2. Vulkan does not support Multi View and Foveation Rendering.
  3. When enable HDR rendering in Graphics Settings, the Foveation Rendering cannot take effect.

# Unity XR SDK v1.1.1

Published 2021-9-15

  • Solved Issues
  1. Fixed the VR keyboard inputs issue by using two controllers at same time.

  2. Fixed the Null Reference Exception of calling Recenter while starting the application.

  3. Fixed the issue that Recenter does not work when Time.Scale = 0.

  4. Fixed the OpenGL Native Plug-in Error in log when setting the Blit Type to 'never'.

  5. Provide a demo script that controllers model is hided when disconnected.

  6. Correct the API name SetFoveationParamets to SetFoveationParameters.

  • Known Issues
  1. Application exited abnormally when pause-resume in many times.
  2. The Vulkan API is currently an experimental feature that may cause performance decline in some cases.
  3. The Vulkan API does NOT support MultiView and Foveation Rendering right now.
  4. FR is invalid when Graphics HDR enabled.

# Unity XR SDK v1.1.0

Published 2021-8-11

  • Key Features
  1. Provide Qiyu PlayerPrefs APIs to save user data after upgrade, uninstall and re-install the application.
  • Solved Issues
  1. Fix the issue that the screen recording function is not smooth occasionally.
  • Known Issues
  1. The Vulkan API is currently an experimental feature that may cause performance decline in some cases.
  2. The Vulkan API does NOT support MultiView and Foveation Rendering right now.
  3. FFR is invalid when Graphics HDR enabled.
  4. During screen recording, a permission popup window is displayed when the application is started for the first time, causing a gray screen.

# Unity XR SDK v1.0.2

Published 2021-7-20

  • Key Features
  1. Provide a Screen Fade function script to optimize the flash white of screen when switch scenes.
  2. Provide UnityXR API XRDevice. RefreshRate to get refresh rate of the display.
  3. The default recommended value of "Eye Resolution Scale Factor"is set to 0.7 to increase FPS.
  • Solved Issues
  1. Fixed "Eye Resolution Scale Factor" void issue when App resume.
  2. Fixed a"texture compressed" issue with Linear Color Space rendering.
  3. Fixed the conflict with Unity2021 NewtonSoft JSON library.
  4. Fixed an occasional "gray" rendering issue when screen off and on.
  5. Added the exception protection for platform solution.
  6. Fixed an occasional failure issue of recording screen.
  • Known Issues
  1. The Vulkan API is currently an experimental feature that may cause performance decline in some cases.
  2. The Vulkan API does NOT support MultiView and Foveation Rendering right now.
  3. FR is invalid when Graphics HDR enabled.

# Unity XR SDK v1.0.0

Published 2021-6-3

  • Key Features
  1. Support Qiyu 3 device
  2. Support Unity XR plug-in framework
  3. Provide Qiyu 3 device boundary APIs
  4. Foveation rendering
  5. Single Pass
  6. Vulkan graphics APIs
  7. Provide VR input keyboard, including Chinese and English
  8. Support floor level tracking origin mode
  9. Platform solution (DLC, Deep linking, Account link)
  10. Support 3-DOF mode
  • Known Issues
  1. The Vulkan API is currently an experimental feature that may cause performance decline in some cases.
  2. The Vulkan API does NOT support MutilView and Foveation Rendering right now.

# Alpha-v0.4

Published 2021-5-17

  • Key Features
  1. Added ray for each controller
  2. Added automatic generation of AndroidManifast.xml and apk automatic addition of version number and launcher attributes
  3. Optimize the replacement logic of the controller model
  4. Fixed a bug that the controller and ray materials are abnormal after the URP rendering pipeline project is imported into SDK
  5. Fixed a bug that clicking on the screenshot after the Home button returns will cause a gray screen
  6. Fixed a bug of location confusion caused by scene switching
  7. Fixed a bug that may print error log in the initialization sequence at runtime in the Unity editor.