mirror of https://github.com/androidx/media.git synced 2025-04-30 06:46:50 +08:00

History

olly 3760f514a9 Flesh out ExoPlayer extensions.

1. AudioDecoderTrackRenderer now reports decoder initialization
   and AudioTrack underruns.
2. AudioDecoderTrackRenderer can now render more than one output
   buffer per call to doSomeWork, to be consistent with
   MediaCodecAudioTrackRenderer. This may also prevent audio
   underruns in the case that audio is fragmented into many small
   buffers.
3. AudioDecoderTrackRenderer now has an overridable method that
   receives the audio session id, to be consistent with
   MediaCodecAudioTrackRenderer.
4. Fix unsafe event notification in LibvpxVideoTrackRenderer.
5. Vpx and AudioDecoder extensions now increment the CodecCounter
   inputBufferCount field correctly.
6. Decoders now have names :).
-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=122250009

2016-06-15 19:41:31 +01:00

src

Flesh out ExoPlayer extensions.

2016-06-15 19:41:31 +01:00

build.gradle

Copy opus extension v1->v2

2016-06-15 19:39:07 +01:00

README.md

Fix documentation.

2016-06-15 19:41:30 +01:00

README.md

ExoPlayer Opus Extension

Description

The Opus Extension is a TrackRenderer 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.
If you want to use your own version of libopus, place it in ${OPUS_EXT_PATH}/jni/libopus.