FFmpeg decoder module
The
FFmpeg module provides , which uses
FFmpeg for decoding and can render audio encoded in a variety of
formats.
FfmpegAudioRenderer
License
note
Please
note that whilst the code in this reposi
tory is licensed under Apache 2.0, using this module also requires
building and including one or more external libraries as described below. These are licensed separately.
Build instructions (Linux, macOS)
To use the module you need
to clone this GitHub project and depend on its modules locally. Instructions
for doing this can be
found in the
top level README. The module is
not provided via Google's Maven reposi
tory (see ExoPlayer issue 2781
for more in
formation).
In addition, it's necessary
to manually
build the
FFmpeg library, so that gradle can bundle the
FFmpeg binaries in the APK
:
Set the following shell variable
:
cd "<path
to project checkout>"
FFMPEG_MODULE_PATH="$(pwd)/libraries/decoder_
ffmpeg/src/main"
Download the Android NDK and set its location in a shell variable. This
build configuration has been tested on NDK r26b (r23c if ANDROID_ABI is less than 21).
NDK_PATH="<path
to Android NDK>"
Set the host plat
form (use "darwin
-x86_64"
for Mac OS X)
:
HOST_PLAT
FORM="linux
-x86_64"
Set the ABI version
for native code (typically it's equal
to minSdk and must
not exceed it)
:
ANDROID_ABI=21
Fetch
FFmpeg and checkout an appropriate branch. We can
not guarantee compatibility with all versions of
FFmpeg. We currently recommend version 6.0
:
cd "<preferred location
for ffmpeg>" && \
git clone git
://source.
ffmpeg.org/
ffmpeg && \
cd
ffmpeg && \
git checkout release/6.0 && \
FFMPEG_PATH="$(pwd)"
Configure the decoders
to include. See the
Supported
formats page
for details of the available decoders, and which
formats they
support.
ENABLED_DECODERS=(vorbis opus flac)
Add a link
to the
FFmpeg source code in the
FFmpeg module direc
tory.
jni
cd "${
FFMPEG_MODULE_PATH}/
jni" && \
ln
-s "$
FFMPEG_PATH"
ffmpeg
Execute
to build FFmpeg for , , and . The script can be edited if you need
to build for different architectures
:build_
ffmpeg.sharmeabi
-v7aarm64
-v8ax86x86_64
cd "${
FFMPEG_MODULE_PATH}/
jni" && \
./
build_
ffmpeg.sh \
"${
FFMPEG_MODULE_PATH}" "${NDK_PATH}" "${HOST_PLAT
FORM}" "${ANDROID_ABI}" "${
ENABLED_DECODERS[@]}"
Install CMake
Having followed these steps, gradle will
build the module au
tomatically when run on the command line or via Android Studio, using CMake and Ninja
to configure and
build the module's
JNI wrapper library.
Build instructions (Windows)
We do
not provide
support for building this module on Windows,
however it should be possible
to follow the Linux instructions in Windows PowerShell.
Using the module with ExoPlayer
Once you've followed the instructions above
to check out,
build and depend on the module, the next step is
to tell ExoPlayer
to use .
How you do this depends on which player API you're using
:FfmpegAudioRenderer
If you're passing a
to , you can
enable using the module by setting the parameter of the construc
tor
to . This will use
for playback if doesn't
support the input
format. Pass
to give priority over .DefaultRenderersFac
toryExoPlayer.
BuilderextensionRendererModeDefaultRenderersFac
toryEXTENSION_RENDERER_MODE_ON
FfmpegAudioRendererMediaCodecAudioRendererEXTENSION_RENDERER_MODE_PREFER
FfmpegAudioRendererMediaCodecAudioRenderer
If you've subclassed , add an
to the output list in . ExoPlayer will use the first in the list that
supports the input media
format.DefaultRenderersFac
tory
FfmpegAudioRenderer
buildAudioRenderersRenderer
If you've implemented your own , return an instance from . ExoPlayer will use the first in the returned array that
supports the input media
format.RenderersFac
tory
FfmpegAudioRenderercreateRenderersRenderer
If you're using , pass an in the array of s. ExoPlayer will use the first in the list that
supports the input media
format.ExoPlayer.
Builder
FfmpegAudioRendererRendererRenderer
Note
: These instructions assume you're using . If you have a cus
tom track selec
tor the choice of is up
to your implementation, so you need
to make sure you are passing an
to the player, then implement your own logic
to use the renderer
for a given track.DefaultTrackSelec
torRenderer
FfmpegAudioRenderer 根据以上内容帮我写一份github action工作流
本文详细介绍如何使用Android NDK静态编译FFmpeg，包括配置环境变量、选择目标平台、指定架构和交叉编译工具链，以及启用各种编解码器和硬件加速选项。
扫一扫
9498
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
