The FFmpeg extension provides FfmpegAudioRenderer
, which uses FFmpeg for decoding and can render audio encoded in a variety of formats.
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. The extension is not provided via JCenter (see #2781 for more information).
In addition, it‘s necessary to build the extension’s native components as follows:
cd "<path to exoplayer checkout>" FFMPEG_EXT_PATH="$(pwd)/extensions/ffmpeg/src/main/jni"
NDK_PATH="<path to Android NDK>"
HOST_PLATFORM="linux-x86_64"
ENABLED_DECODERS=(vorbis opus flac)
build_ffmpeg.sh
will fetch and build FFmpeg 4.2 for armeabi-v7a
, arm64-v8a
, x86
and x86_64
. The script can be edited if you need to build for different architectures.cd "${FFMPEG_EXT_PATH}" && \ ./build_ffmpeg.sh \ "${FFMPEG_EXT_PATH}" "${NDK_PATH}" "${HOST_PLATFORM}" "${ENABLED_DECODERS[@]}"
APP_ABI
to include the architectures built in the previous step. For example:cd "${FFMPEG_EXT_PATH}" && \ ${NDK_PATH}/ndk-build APP_ABI="armeabi-v7a arm64-v8a x86 x86_64" -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.
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 FfmpegAudioRenderer
. 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 FfmpegAudioRenderer
for playback if MediaCodecAudioRenderer
doesn’t support the input format. Pass EXTENSION_RENDERER_MODE_PREFER
to give FfmpegAudioRenderer
priority over MediaCodecAudioRenderer
.DefaultRenderersFactory
, add an FfmpegAudioRenderer
to the output list in buildAudioRenderers
. ExoPlayer will use the first Renderer
in the list that supports the input media format.RenderersFactory
, return an FfmpegAudioRenderer
instance from createRenderers
. ExoPlayer will use the first Renderer
in the returned array that supports the input media format.ExoPlayer.Builder
, pass an FfmpegAudioRenderer
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 FfmpegAudioRenderer
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.
com.google.android.exoplayer2.ext.ffmpeg.*
belong to this module.