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 specific Core editions (eg AVPro Video - Core Windows 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 - Core Android 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 device will be watermark-free.

Installing Multiple Single-Platform Packages

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

If you have installed the Core macOS/iOS/tvOS edition package then it will also contain plugins for all of the other platforms but with the watermark enabled. 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 this using the macOS/iOS/tvOS and Android package as examples:

  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 macOS/iOS/tvOS package
  3. Import the Android package, but make sure that you have the macOS/iOS/tvOS native plugin files unticked (so that it is not overwritten) A similar process can be applied for other package combinations.

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.framework
  • tvOS
    • Plugins/tvOS/AVProVideo.framework
  • 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