mirror of
https://github.com/androidx/media.git
synced 2025-05-18 04:59:54 +08:00
ccc5e472b0
Fixes github issue #2339 [https://github.com/google/ExoPlayer/issues/2339] Fixes github issue #2551 [https://github.com/google/ExoPlayer/issues/2551] * Update the instructions to check out specific versions of libvpx and libyuv that are known to work with our build scripts. * Forcing a particular version of libyuv because recent versions of libyuv are dependent on libjpeg (which isn't needed for the purpose of this extension). * Going forward, let's keep generate_libvpx_android_configs.sh in sync with whatever version is specifed in the instructions in README.md (as of now it is v1.6.1). ------------- Created by MOE: https://github.com/google/moe MOE_MIGRATED_REVID=150208517
98 lines
2.6 KiB
Markdown
98 lines
2.6 KiB
Markdown
# ExoPlayer VP9 Extension #
|
|
|
|
## Description ##
|
|
|
|
The VP9 Extension is a [Renderer][] implementation that helps you bundle libvpx
|
|
(the VP9 decoding library) into your app and use it along with ExoPlayer to play
|
|
VP9 video on Android devices.
|
|
|
|
[Renderer]: https://google.github.io/ExoPlayer/doc/reference/com/google/android/exoplayer2/Renderer.html
|
|
|
|
## 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)"
|
|
VP9_EXT_PATH="${EXOPLAYER_ROOT}/extensions/vp9/src/main"
|
|
```
|
|
|
|
* Download the [Android NDK][] and set its location in an environment variable:
|
|
|
|
[Android NDK]: https://developer.android.com/tools/sdk/ndk/index.html
|
|
|
|
```
|
|
NDK_PATH="<path to Android NDK>"
|
|
```
|
|
|
|
* Fetch libvpx and libyuv:
|
|
|
|
```
|
|
cd "${VP9_EXT_PATH}/jni" && \
|
|
git clone https://chromium.googlesource.com/webm/libvpx libvpx && \
|
|
git clone https://chromium.googlesource.com/libyuv/libyuv libyuv
|
|
```
|
|
|
|
* Checkout the appropriate branches of libvpx and libyuv (the scripts and
|
|
makefiles bundled in this repo are known to work only at these versions of the
|
|
libraries - we will update this periodically as newer versions of
|
|
libvpx/libyuv are released):
|
|
|
|
```
|
|
cd "${VP9_EXT_PATH}/jni/libvpx" && \
|
|
git checkout tags/v1.6.1 -b v1.6.1 && \
|
|
cd "${VP9_EXT_PATH}/jni/libyuv" && \
|
|
git checkout e2611a73
|
|
```
|
|
|
|
* Run a script that generates necessary configuration files for libvpx:
|
|
|
|
```
|
|
cd ${VP9_EXT_PATH}/jni && \
|
|
./generate_libvpx_android_configs.sh "${NDK_PATH}"
|
|
```
|
|
|
|
* Build the JNI native libraries from the command line:
|
|
|
|
```
|
|
cd "${VP9_EXT_PATH}"/jni && \
|
|
${NDK_PATH}/ndk-build APP_ABI=all -j4
|
|
```
|
|
|
|
* In your project, you can add a dependency to the VP9 Extension by using a the
|
|
following rule:
|
|
|
|
```
|
|
// in settings.gradle
|
|
include ':..:ExoPlayer:library'
|
|
include ':..:ExoPlayer:extension-vp9'
|
|
|
|
// in build.gradle
|
|
dependencies {
|
|
compile project(':..:ExoPlayer:library')
|
|
compile project(':..:ExoPlayer:extension-vp9')
|
|
}
|
|
```
|
|
|
|
* Now, when you build your app, the VP9 extension will be built and the native
|
|
libraries will be packaged along with the APK.
|
|
|
|
## Notes ##
|
|
|
|
* Every time there is a change to the libvpx checkout:
|
|
* Android config scripts should be re-generated by running
|
|
`generate_libvpx_android_configs.sh`
|
|
* Clean and re-build the project.
|
|
* If you want to use your own version of libvpx or libyuv, place it in
|
|
`${VP9_EXT_PATH}/jni/libvpx` or `${VP9_EXT_PATH}/jni/libyuv` respectively. But
|
|
please note that `generate_libvpx_android_configs.sh` and the makefiles need
|
|
to be modified to work with arbitrary versions of libvpx and libyuv.
|
|
|