Troubleshooting the Genvid MILE SDK in Unity

Here are a few hints at how to work around some potential issues when using the Genvid Plugin.

Using the Genvid Plugin for Unity with Older Versions of the SDK

The Genvid Plugin for Unity isn’t guaranteed to work with SDK versions older than it. If you’re having any issues using the plugin, verify that you’re using it with a matching or more recent version of the SDK.

The Genvid DLLs are not detected properly by Unity

We are unaware of the cause of the issue yet, but it seems that sometimes the Genvid dlls are not detected when attempting to build the Unity sample. We suggest that you delete the Library folder of the sample project and attempt to build again.

The video stream is not captured properly on some machines

Genvid MILE SDK only works with a Windows D3D11 driver. If you try to set it otherwise, it will report an error. You can try to run the game with the option -force-d3d11.

The video displays upside down in the stream

Unity uses DirectX11 to render, but uses the OpenGL convention for the Texture coordinate.

OpenGL uses the convention:

[0, 0]

Bottom / Left

[1, 1]

Top / Right
DirectX uses the convention:

[0, 0]

Top / Left

[1, 1]

Bottom / Right

We corrected this issue in the Genvid prefab. However, if your stream video displays upside down, use the SetParameter(Object,String,Int32) Genvid MILE SDK function with the video.useopenglconvention parameter to flip it:

GenvidSDK.SetParameter(m_StreamName, "video.useopenglconvention", 1)

(The “1” toggles flipping the video.)

The Python scripts fail with a Unity License error

The command package.py package or package.py all and the command unity.py prepare can lead to errors when using Unity Pro. In some earlier versions of Unity, running batch mode would delete the Pro license. The same issue didn’t exist when using the Personal license.

As a workaround, re-enter your license number and run the command again. Note that the license will get deleted every time the batch mode is called (when using the Python script related to Unity).

To solve the issue, update to a newer version of Unity where this issue doesn’t occur.

Testing Without a Running Genvid Stack

Running your game without the Genvid stack active will cause errors. If you need to test in the editor without the stack running, you can disable the Genvid MILE SDK directly from the editor.

  1. Select the GenvidSessionManager object.

  2. Click the Activate SDK checkbox to disable it.

  3. Proceed to the second scene to deactivate the GenvidSessionManager object, if needed.

The Python scripts fail to find the Unity Editor.

To run correctly, the .\engine-integration\unity\package.py and .\samples\cube\unity\unity.py scripts need to be able to find the Unity Editor executable.

You can assign the path to Unity Editor executable directory using the environment variable UNITY_EXE_DIR.