Installation

Installation Steps

If you are installing from scratch:

  1. Either download the latest trial version: https://github.com/RenderHeads/UnityPlugin-AVProVideo/releases
    or
    Purchase the latest version from the Unity Asset Store
  2. Open your project in Unity
  3. Import the unitypackage file into your Unity project by double-clicking the file
  4. If prompted to upgrade some scripts click Yes

Upgrade Steps

If you are upgrading to a new version:

  1. Close your Unity project
  2. Open your project again and proceed to the next step immediately without running the scene or clicking on any AVPro Video components, as this can cause the plugin files to become locked
  3. Import the unitypackage file into your Unity project by double-clicking the file
  4. If prompted to upgrade some scripts click Yes

Watermarked Trial Version

If you are using a trial version of the plugin then you will see a watermark displayed over the video. The watermark is in the form of a “RenderHeads” logo that animates around the screen, or a thick horizontal bar that moves around the screen.

Installation & Watermark Troubleshooting

It’s often a good idea to check that the correct version is reported after a plugin upgrade. You can check which version you have installed by adding an MediaPlayer component to your scene and clicking on the “About / Help” button in the Inspector for that component. The version number is displayed in this box.

The Core and Ultra editions of AVPro Video have no watermarks for any platforms. If you use one of the platform bundle Core editions (eg AVPro Video v3 - Core Desktop Edition) then you will not see the watermark on the platform you purchased for, but you will see the watermark on the other platforms. For example if you purchased AVPro Video v3 - Core Mobile Edition then you will still see the watermark in the Unity editor as this is running on Windows/macOS, but the videos played back when you deploy to your Android/iOS/tvOS device will be watermark-free.

Installing Multiple Platform Bundle Packages

If you are not using the AVPro Video Core or Ultra package and instead have opted to purchase multiple Core platform bundle packages then the installation must be done carefully, especially when upgrading to a new version.

If you have installed the Core Desktop edition package then it will also contain plugins for all of the other platforms but with the watermark enabled. This is also the case if you have installed the Core Mobile edition package. This means that if you then try to install another AVPro Video package it may not override the plugins correctly.

Here is how to resolve installing the Core Mobile edition on top of the Core Desktop edition:

  1. Open a fresh Unity instance (this is important as otherwise Unity may have locked the plugin files which prevents them from being upgraded)
  2. Import the Core Desktop edition package
  3. Import the Core Mobile package, but make sure that you have the Windows/macOS native plugin files unticked (so that it is not overwritten)

Here is how to resolve installing the Core Desktop edition on top of the Core Mobile edition:

  1. Open a fresh Unity instance (this is important as otherwise Unity may have locked the plugin files which prevents them from being upgraded)
  2. Import the Core Mobile edition package
  3. Import the Core Desktop package, but make sure that you have the Android/iOS/tvOS native plugin files unticked (so that it is not overwritten)

List of native plugin files that need to be selectively chosen when replacing specific platforms:

  • Android
    • Plugins/Android/AVProVideo.jar
  • macOS
    • Plugins/AVProVideo.bundle
  • iOS
    • Plugins/iOS/AVProVideo.xcframework
  • tvOS
    • Plugins/tvOS/AVProVideo.xcframework
  • visionOS
    • Plugins/tvOS/AVProVideo.xcframework
  • Windows
    • Plugins/WSA/UWP/ARM64/AVProVideo.dll
    • Plugins/WSA/UWP/ARM64/AVProVideoWinRT.dll
    • Plugins/WSA/UWP/ARM/AVProVideo.dll
    • Plugins/WSA/UWP/ARM/AVProVideoWinRT.dll
    • Plugins/WSA/UWP/x86/AVProVideo.dll
    • Plugins/WSA/UWP/x86/AVProVideoWinRT.dll
    • Plugins/WSA/UWP/x86_64/AVProVideo.dll
    • Plugins/WSA/UWP/x86_64/AVProVideoWinRT.dll
    • Plugins/x86/AVProVideo.dll
    • Plugins/x86/AVProVideoWinRT.dll
    • Plugins/x86_64/AVProVideo.dll
    • Plugins/x86_64/AVProVideoWinRT.dll