mirror of
https://github.com/androidx/media.git
synced 2025-05-09 08:30:43 +08:00

Notes: - The VP9 one is failing claiming that the util package doesn't exist and that LibraryLoader cannot be found. Unsure why, since it appears to be setup exactly like other extensions (e.g. Opus) that does work. - @link across modules will not work when generating Javadoc for a single module. This is WAI. I subsequent change will add an aggregated Javadoc generator that will generate Javadoc for all modules together and apply cross module @link correctly. Issue: #2139 ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=150864273
ExoPlayer Opus Extension
Description
The Opus Extension is a Renderer implementation that helps you bundle libopus (the Opus decoding library) into your app and use it along with ExoPlayer to play Opus audio on Android devices.
Build Instructions
- Checkout ExoPlayer along with Extensions:
git clone https://github.com/google/ExoPlayer.git
- Set the following environment variables:
cd "<path to exoplayer checkout>"
EXOPLAYER_ROOT="$(pwd)"
OPUS_EXT_PATH="${EXOPLAYER_ROOT}/extensions/opus/src/main"
- Download the Android NDK and set its location in an environment variable:
NDK_PATH="<path to Android NDK>"
- Fetch libopus:
cd "${OPUS_EXT_PATH}/jni" && \
git clone https://git.xiph.org/opus.git libopus
- Run the script to convert arm assembly to NDK compatible format:
cd ${OPUS_EXT_PATH}/jni && ./convert_android_asm.sh
- Build the JNI native libraries from the command line:
cd "${OPUS_EXT_PATH}"/jni && \
${NDK_PATH}/ndk-build APP_ABI=all -j4
- In your project, you can add a dependency to the Opus Extension by using a rule like this:
// in settings.gradle
include ':..:ExoPlayer:library'
include ':..:ExoPlayer:extension-opus'
// in build.gradle
dependencies {
compile project(':..:ExoPlayer:library')
compile project(':..:ExoPlayer:extension-opus')
}
- Now, when you build your app, the Opus extension will be built and the native libraries will be packaged along with the APK.
Notes
- Every time there is a change to the libopus checkout:
- Arm assembly should be converted by running
convert_android_asm.sh
- Clean and re-build the project.
- Arm assembly should be converted by running
- If you want to use your own version of libopus, place it in
${OPUS_EXT_PATH}/jni/libopus
.