No software is immune to bugs - not even ISAR, 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 ISAR SDK and Client Applications in General

Unity Development Environment is crashing when running the Project with integrated ISAR SDK

• If Unity crashes after the ISAR packages have been imported and "Play" has been pressed, you should check whether option "ISAR XR" is enabled in Edit -> Project Settings -> XR Plug-in Management within "Plug-in Provider"
  
• If you are using the Trial version of ISAR, please check if the code version you downloaded has expired and re-download from GitHub if necessary
  
• The expiry date of the current ISAR 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 ISAR 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 ISAR SDK requirements are open
  
• Check if server device and client device are on the same network
  
• Check if the version of the ISAR SDK and the version of the ISAR 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 in 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"
   

Troubleshooting for Implementing ISAR SDK for HoloLens 2

Troubleshooting for Implementing ISAR Client for Android