The VP9 extension provides LibvpxVideoRenderer
, which uses libvpx (the VPx decoding library) to decode VP9 video.
Please note that whilst the code in this repository is licensed under Apache 2.0, using this extension also requires building and including one or more external libraries as described below. These are licensed separately.
To use this extension you need to clone the ExoPlayer repository and depend on its modules locally. Instructions for doing this can be found in ExoPlayer's top level README.
In addition, it‘s necessary to build the extension’s native components as follows:
cd "<path to exoplayer checkout>" EXOPLAYER_ROOT="$(pwd)" VP9_EXT_PATH="${EXOPLAYER_ROOT}/extensions/vp9/src/main"
NDK_PATH="<path to Android NDK>"
cd "${VP9_EXT_PATH}/jni" && \ git clone https://chromium.googlesource.com/webm/libvpx libvpx
cd "${VP9_EXT_PATH}/jni/libvpx" && \ git checkout tags/v1.8.0 -b v1.8.0
cd ${VP9_EXT_PATH}/jni && \ ./generate_libvpx_android_configs.sh
cd "${VP9_EXT_PATH}"/jni && \ ${NDK_PATH}/ndk-build APP_ABI=all -j4
We do not provide support for building this extension on Windows, however it should be possible to follow the Linux instructions in Windows PowerShell.
generate_libvpx_android_configs.sh
${VP9_EXT_PATH}/jni/libvpx
. Please note that generate_libvpx_android_configs.sh
and the makefiles may need to be modified to work with arbitrary versions of libvpx.Once you‘ve followed the instructions above to check out, build and depend on the extension, the next step is to tell ExoPlayer to use LibvpxVideoRenderer
. How you do this depends on which player API you’re using:
DefaultRenderersFactory
to SimpleExoPlayer.Builder
, you can enable using the extension by setting the extensionRendererMode
parameter of the DefaultRenderersFactory
constructor to EXTENSION_RENDERER_MODE_ON
. This will use LibvpxVideoRenderer
for playback if MediaCodecVideoRenderer
doesn’t support decoding the input VP9 stream. Pass EXTENSION_RENDERER_MODE_PREFER
to give LibvpxVideoRenderer
priority over MediaCodecVideoRenderer
.DefaultRenderersFactory
, add a LibvpxVideoRenderer
to the output list in buildVideoRenderers
. ExoPlayer will use the first Renderer
in the list that supports the input media format.RenderersFactory
, return a LibvpxVideoRenderer
instance from createRenderers
. ExoPlayer will use the first Renderer
in the returned array that supports the input media format.ExoPlayer.Builder
, pass a LibvpxVideoRenderer
in the array of Renderer
s. ExoPlayer will use the first Renderer
in the list that supports the input media format.Note: These instructions assume you're using DefaultTrackSelector
. If you have a custom track selector the choice of Renderer
is up to your implementation, so you need to make sure you are passing an LibvpxVideoRenderer
to the player, then implement your own logic to use the renderer for a given track.
To try out playback using the extension in the demo application, see enabling extension decoders.
There are two possibilities for rendering the output LibvpxVideoRenderer
gets from the libvpx decoder:
GL rendering using GL shader for color space conversion
SimpleExoPlayer
with PlayerView
, enable this option by setting surface_type
of PlayerView
to be video_decoder_gl_surface_view
.LibvpxVideoRenderer
a message of type C.MSG_SET_VIDEO_DECODER_OUTPUT_BUFFER_RENDERER
with an instance of VideoDecoderOutputBufferRenderer
as its object.Native rendering using ANativeWindow
SimpleExoPlayer
with PlayerView
, this option is enabled by default.LibvpxVideoRenderer
a message of type C.MSG_SET_SURFACE
with an instance of SurfaceView
as its object.Note: Although the default option uses ANativeWindow
, based on our testing the GL rendering mode has better performance, so should be preferred.
com.google.android.exoplayer2.ext.vp9.*
belong to this module.