Troubleshooting

The receiver shows outdated content

  • Verify that you exported the kzb files from all the sending and receiving Kanzi Studio projects. Close any streamers and receivers before the kzb export to avoid failures in the export. Restart the streamers and receivers after the kzb export.

The receiver does not display any content despite the streaming application is on

After making any of these changes, restart both the streaming and receiving application:

  • Verify that both the sending application and receiving application are on.

  • Verify that ports of the streaming application and receiving application match.

  • Verify that only one sender is configured to the same port on the same host.

  • If you are running the application on the same computer, verify that the host is configured as localhost.

  • If the stream comes from a device other than the localhost, verify that the host is configured correctly for the receiving end. Try using the IP address of the device instead of its hostname.

  • Verify that there are no extra sending applications, receiving applications, or Kanzi Studio Preview windows open. If there are, close them all and then start the correct ones.

  • Verify that there are no other applications listening to the same port as the sender:

    1. On Windows, open resmon.exe, go to the Network tab, and check the Ports column of the Listening Ports pane.

    2. Reconfigure the ports of the nodes and node components of Streaming Plugin or close or reconfigure the other application using the same port.

  • Pipe the output of the sending and receiving applications into log files and inspect them for more information.

The VR Viewer content is not visible through the VR headset

  • Verify that the headset is powered on and connected to the computer so that the computer recognizes it and is visible in the Device Manager.

  • Verify that you can see non-Kanzi content from your computer through the headset. For example, mirroring the desktop, playing VR video, or running a VR computer game.

  • Verify that the active OpenXR runtime is configured as expected. Using the Registry Editor (regedit.exe) check the value of ActiveRuntime under the key Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenXR\1.

  • If you are using an Oculus headset, verify that Oculus Windows Client > Settings > General > Unknown sources is enabled.

  • Pipe the output of the VR Viewer into a log file and inspect it for more information.

A Kanzi VR application fails to start (missing DLLs)

A Kanzi VR application needs to find DLL files of Kanzi and plugin DLL files of Kanzi VR to start successfully.

Errors related to not finding Kanzi refers to, for example, these files:

  • kzui_GL_vs2017_Release.dll

  • kzcoreui_GL_vs2017_Release.dll

  • VrPlugin.dll

  • KanziStreaming.dll

Solutions:

  • Create a startup script that adds the missing files to your PATH. Consider reusing and modifying examples\ExampleDashboard\bin\launch_in_vr_viewer.bat that adds the required files to PATH.

  • Copy the missing files as local files or make symbolic links to them.