Troubleshooting – ISAR SDK and Client Applications
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
Failing to establish a Connection between Server and Client
Objects are not displayed correctly in the client application
- 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
- In particular, the client application for Oculus is affected, as rainbow-colored stripes appear models in the case of incorrect configurations
- 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
- If the "Main Camera" is not moving and you are in an HDRP project, remove the "SimpleCameraController" script attached to the "Main Camera"
- When using the Universal Render Pipeline (URP) please check that "Post Processing" is disabled in Main Camera -> Rendering -> Post Processing
- When opening the "HelloIsar" demo project for the first time, you might get a missing reference to "com.hololight.isar"
- Press "Continue" and wait until the project finishes loading
- Once the project has loaded, open the "Package Manager" via Window -> Package Manager
- Click on the "+" icon and "Add a package from disk"
- Select the "package.json" file inside the "com.hololight.isar" directory
- 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
No specific issues and solutions known so far.
Troubleshooting for Implementing ISAR SDK for Oculus Quest 2
No specific issues and solutions known so far.
Troubleshooting for Implementing ISAR Client for Android
No specific issues and solutions known so far.
Related Articles
ISAR SDK – Quickstart Guide for HoloLens 2
Hey there! In this quick start guide for ISAR we will show you how to easily set up your first ISAR project in Unity. For this we will need Unity Hub 3.0.1, Unity 2020.3.30, MRTK 2.7.3 and of course ISAR 2.4.0.0. First, we check whether your system ...
ISAR SDK – Quickstart Guide for Android
Hey there! In this quick start guide for ISAR we will show you how to easily set up your first ISAR project in Unity. For this we will need Unity Hub 3.0.1, Unity 2020.3.30, MRTK 2.7.3 and of course ISAR 2.4.0.0. First, we check whether your system ...
Overview of ISAR Clients
ISAR SDK currently supports several client devices (Microsoft HoloLens 2, Oculus Quest 2, Android) that can connect to an ISAR server application with the respective ISAR client application. To establish a successful connection between ISAR server ...
ISAR SDK – Quickstart Guide for Oculus Quest 2
Hey there! In this quick start guide for ISAR we will show you how to easily set up your first ISAR project in Unity. For this we will need Unity Hub 3.0.1, Unity 2020.3.30, MRTK 2.7.3 and of course ISAR 2.4.0.0. First, we check whether your system ...
ISAR SDK 2.3.0.0 Release Notes
Below you will find all the latest changes being introduced with ISAR SDK 2.3.0.0 It was published in November 2021 and is available on Holo-Light's GitHub page. This release is focused on feedback we’ve received from users via ...