No software is immune to bugs - not even Hololight Stream, admittedly. We have compiled below a collection of possible solutions stemming from real use cases that will may help you to solve problems independently (without frustration). If your issue is not included or if you have found a (different) solution to a problem yourself, please feel free to contact us at support@holo-light.com. Our Support team will be happy to assist you in solving the issue and is appreciative of any information.

Please note that the (Android) client is still a BETA version.

Troubleshooting for Hololight Stream SDK and Client Applications in General

Unity Development Environment is crashing when running the Project with integrated Hololight Stream, SDK

• If Unity crashes after the Hololight Stream packages have been imported and "Play" has been pressed, you should check whether option "Hololight Stream XR" is enabled in Edit -> Project Settings -> XR Plug-in Management within "Plug-in Provider".
  
• If you are using the Trial version of Hololight Stream, please check if the code version you downloaded has expired and re-download from GitHub if necessary.
  
• The expiry date of the current Hololight Stream SDK Trial version can be found in the manual on GitHub.

Failing to establish a Connection between Server and Client

• Check if you entered the correct IP address of your server device (e.g. 192.168.0.122 – without the Port Number) in the Hololight Stream client application.
  
• Check if a Firewall is blocking the connection.
  
  • In case of security concerns you can deactivate it for a short period of time during testing.
    
• Check if all ports specified in the Hololight Stream SDK are open.
  
• Check if server device and client device are on the same network.
  
• Check if the version of the Hololight Stream SDK and the version of the Hololight Stream client application are compatible.
  

Objects are not displayed correctly in the client application

1. If objects are not displayed correctly (e.g wrong colors or visible distortions) in the client application or the environment within the client looks "strange", you should check whether the configuration file has the correct parameters for your selected client application
   
1. In particular, the client application for Oculus is affected, as rainbow-colored stripes appear models in the case of incorrect configurations.
2. How the configuration file can be accessed and which parameters have to be set for the various client application is shown on this guide.
   

Miscellaneous

1. If the "Main Camera" is not moving and you are in an HDRP project, remove the "SimpleCameraController" script attached to the "Main Camera"
   
2. When using the Universal Render Pipeline (URP) please check that "Post Processing" is disabled in Main Camera -> Rendering -> Post Processing
   
3. When opening the "HelloIsar" demo project for the first time, you might get a missing reference to "com.hololight.isar"
   
1. Press "Continue" and wait until the project finishes loading
   
2. Once the project has loaded, open the "Package Manager" via Window -> Package Manager
   
3. Click on the "+" icon and "Add a package from disk"
   
4. Select the "package.json" file inside the "com.hololight.isar" directory
   
4. If Audio is not working, ensure that "Default Communication Audio Device" is the same as the "Default Audio Device" in the "Windows Sound Control Panel".