Troubleshooting Genvid in Unity¶
Here are a few hints at how to work around some potential issues when using the Genvid Plugin.
In This Section
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.
- Select the
GenvidSessionManager
object. - Click the
Activate SDK
checkbox to disable it. - 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
.