AVPro Video
for Android, iOS, tvOS, macOS, WebGL
Windows Desktop, Windows Phone and UWP
Unity plugin for fast and flexible video playback
Version 1.7.3
Released 9 December 2017
Contents
1. Introduction
1. Features
2. Trial Version
3. Media Credits
2. System Requirements
1. Platforms not supported
3. Installation
1. Trial Version & Watermark Notes
2. Installing Multiple Platform Packages
4. Usage Notes
1. Platform Notes
2. Video File Locations
3. Streaming Notes
4. Audio Notes
5. Augmented / Virtual Reality Notes
6. Hap Codec Notes
7. Transparency Notes
8. Hardware Decoding
9. Multi-GPU SLI / CrossFire Notes
10. Subtitle Notes
11. DRM Notes
12. Video Capture Notes
5. Quick Start Examples
1. Quick Start Fastest Start for Unity Experts
2. Quick Start Fullscreen Video Player using Prefabs
3. Quick Start 3D Mesh Video Player Example using Components
6. Usage
1. Getting Started
2. Unsupported Platform Fallback
3. Components
4. Scripting
5. Platform Specific Scripting
6. Third-party Integration
7. Asset Files
1. Demos
2. Prefabs
3. Scripts
8. Scripting Reference
9. Supported Media Formats
10. Support
11. About RenderHeads Ltd
Appendix A - FAQ
Appendix B - Version History
Appendix C - Roadmap
2 / 90
AVPro Video © 2016-2017 RenderHeads Ltd
1. Introduction
AVPro Video is the newest video playback plugin from RenderHeads. We previously
developed the AVPro QuickTime and AVPro Windows Media plugins for Unity. In this next
generation of plugins we aim to create an easy to use, cross-platform video playback system
that uses the native features of each platform.
1.1 Features
● Versions for iOS, tvOS, OS X, Android, WebGL, Windows, Windows Phone and
UWP
● One API for video playback on all supported platforms
● *NEW* Facebook Audio 360 and Android ExoPlayer support
● 8K video support (on supported hardware)
● VR support (mono, stereo, equirectangular and cubemap)
● Transparency support (native and packed)
● Unity Pro 4.6.x and above supported
● Unity Personal 5.x - 2017.x and above supported
● Free watermarked trial version available ( download here )
● Fast native Direct3D, OpenGL and Metal texture updates
● Linear and Gamma colour spaces supported
● Graceful fallback in editor
● Components for IMGUI, uGUI and NGUI
● Extensive PlayMaker support
● Easy to use, drag and drop components
● Desktop support for Hap, Hap Alpha, Hap Q and Hap Q Alpha
● Streaming and adaptive video from URL
1.2 Trial Version
We offer an unlimited trial version of AVPro Video for download from our website at
http://renderheads.com/product/avpro-video/ . The trial version has no missing features or
time restrictions but it does apply a watermark to the rendered output. The watermarking
does have a small performance impact which is only really noticeable on very high resolution
videos.
1.3 Media Credits
BigBuckBunny_360p30.mp4 - (c) copyright 2008, Blender Foundation /
www.bigbuckbunny.org
BigBuckBunny_720p30.mp4 - (c) copyright 2008, Blender Foundation /
www.bigbuckbunny.org
SampleSphere.mp4 - (c) copyright Daniel Arnett, https://vimeo.com/97887646
3 / 90
AVPro Video © 2016-2017 RenderHeads Ltd
2. System Requirements
● Unity 5.x Personal Edition, or Unity Pro 4.6 and above
● iOS 8.1 and above
● tvOS 9.0 (Apple TV 4th Gen) and above
● OS X 10.7 and above, 64-bit only
● Android 4.0.4 (Ice Cream Sandwich, API level 15) and above (ARM7, ARM8 and
x86)
● Windows XP (SP 3) and above (32-bit and 64-bit)
● Windows 8.0 and above (32-bit and 64-bit)
● Windows Phone UWP 8.1 (32-bit and ARM)
● Windows Desktop UWP 8.1 (32-bit, 64-bit and ARM)
● Universal Windows Platform 10 (32-bit, 64-bit and ARM)
● WebGL compatible browser
2.1 VR Headsets Supported
● Microsoft Hololens
● HTC Vive
● Oculus Gear VR
● Oculus Rift
● Google Cardboard
● Google Daydream
2.2 Platforms not Supported
● WebPlayer
● Linux desktop
● Tizen
● Samsung TV
● Game Consoles (XBox*, PS4 etc)
* XBox One may be supported using UWP build option. We have not tested this though.
4 / 90
AVPro Video © 2016-2017 RenderHeads Ltd
3. Installation
1. Open up a fresh Unity session (to clear any locked plugin files)
2. Import the unitypackage file into your Unity project. If prompted to upgrade some
scripts click Yes.
3.1 Trial Version & Watermark Notes
3.1.1 Watermark
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 move around the screen. In Windows if the GPU
decoding path is used when the watermark isn’t displayed - instead every few seconds the
video size will scale down.
The full version of AVPro Video has no watermarks for any platforms. If you use one of the
platform specific packages (eg AVPro Video for iOS, or AVPro Video for Windows) 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 for iOS then you will still
see the watermark in the Unity editor as this is running on Windows/OS X, but the videos
played back when you deploy to your iOS device will be watermark-free.
3.1.2 Updating from Trial Version
If you are upgrading from the trial version, make sure you delete the old /Assets/Plugins
folder as this contains the trial plugin and could conflict. You may need to close Unity first,
delete the files manually and then restart Unity and re-import the package (because Unity
locks native plugin files once they are loaded).
You can check which version you have installed by adding an MediaPlayer component to
your scene and clicking on the ‘about’ button in the Inspector for that component. The
version number is displayed in this box.
3.2 Installing Multiple Platform Packages
If you are not using the full all-in-one AVPro Video package and instead have opted to
purchase multiple individual platform packages then the installation must be done carefully,
especially when upgrading to a new version.
If you have installed the iOS 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
5 / 90
AVPro Video © 2016-2017 RenderHeads Ltd