Troubleshooting – ISAR SDK and Client Applications

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
    • 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

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 ...