Video player based on ffplay
# required
allprojects {
repositories {
jcenter()
}
}
dependencies {
compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.8'
compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.8'
# Other ABIs: optional
compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.8'
compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8'
compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8'
compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8'
# ExoPlayer as IMediaPlayer: optional, experimental
compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.8'
}
- iOS
- in coming...
### Latest Changes
- [CHANGELOG.md](CHANGELOG.md)
### Features
- Common
- remove rarely used ffmpeg components to reduce binary size [config/module-lite.sh](config/module-lite.sh)
- workaround for some buggy online video.
- Android
- platform: API 9~23
- cpu: ARMv7a, ARM64v8a, x86 (ARMv5 is not tested on real devices)
- api: [MediaPlayer-like](android/ijkplayer/ijkplayer-java/src/main/java/tv/danmaku/ijk/media/player/IMediaPlayer.java)
- video-output: NativeWindow, OpenGL ES 2.0
- audio-output: AudioTrack, OpenSL ES
- hw-decoder: MediaCodec (API 16+, Android 4.1+)
- alternative-backend: android.media.MediaPlayer, ExoPlayer
- iOS
- platform: iOS 7.0~10.2.x
- cpu: armv7, arm64, i386, x86_64, (armv7s is obselete)
- api: [MediaPlayer.framework-like](ios/IJKMediaPlayer/IJKMediaPlayer/IJKMediaPlayback.h)
- video-output: OpenGL ES 2.0
- audio-output: AudioQueue, AudioUnit
- hw-decoder: VideoToolbox (iOS 8+)
- alternative-backend: AVFoundation.Framework.AVPlayer, MediaPlayer.Framework.MPMoviePlayerControlelr (obselete since iOS 8)
### NOT-ON-PLAN
- obsolete platforms (Android: API-8 and below; iOS: pre-6.0)
- obsolete cpu: ARMv5, ARMv6, MIPS (I don't even have these types of devices…)
- native subtitle render
- avfilter support
### Before Build
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" brew install git brew install yasm
- If you prefer more codec/format
cd config rm module.sh ln -s module-default.sh module.sh cd android/contrib
sh compile-ffmpeg.sh clean
- If you prefer less codec/format for smaller binary size (include hevc function)
cd config rm module.sh ln -s module-lite-hevc.sh module.sh cd android/contrib
sh compile-ffmpeg.sh clean
- If you prefer less codec/format for smaller binary size (by default)
cd config rm module.sh ln -s module-lite.sh module.sh cd android/contrib
sh compile-ffmpeg.sh clean
- For Ubuntu/Debian users.
sudo dpkg-reconfigure dash
- If you'd like to share your config, pull request is welcome.
### Build Android
git clone https://github.com/befovy/ijkplayer.git ijkplayer-android cd ijkplayer-android
./init-android.sh
cd android/contrib ./compile-ffmpeg.sh clean ./compile-ffmpeg.sh all
Open Android peoject in android/ijkplayer using Android Studio run/debug ijkplayer-example in Android Studio
To get a released aar
run ./gradlew :fijkplayer-full:assembleRelease
### Build iOS
git clone https://github.com/befovy/ijkplayer.git ijkplayer-ios cd ijkplayer-ios git checkout -B latest k0.8.8
./init-ios.sh
cd ios ./compile-ffmpeg.sh clean ./compile-ffmpeg.sh all
#
#
### Build for Mac OS
Build ffmpeg for Max OS
./init-osx.sh cd osx && ./compile-ffmpeg.sh
Build ijkplayer for Max OS
cd desktop mkdir cmake-build-debug && cd cmake-build-debug cmake .. -DCMAKE_BUILD_TYPE="Debug" make IjkPlayer make tuidemo
**Or you can open ijkplayer as a CMakeLists.txt project using Clion.**
tuidemo is a terminal UI demo for ijkplayer in progress, it can't display video yet.
`libIjkPlayer.dylib` is the output dynamic library.
### Support (支持) ###
- Please do not send e-mail to me. Public technical discussion on github is preferred.
- 请尽量在 github 上公开讨论[技术问题](https://github.com/befovy/ijkplayer/issues),不要以邮件方式私下询问,恕不一一回复。
### License
Copyright (c) 2017 Bilibili Licensed under LGPLv2.1 or later
ijkplayer required features are based on or derives from projects below:
- LGPL
- [FFmpeg](http://git.videolan.org/?p=ffmpeg.git)
- [libVLC](http://git.videolan.org/?p=vlc.git)
- [kxmovie](https://github.com/kolyvan/kxmovie)
- [soundtouch](http://www.surina.net/soundtouch/sourcecode.html)
- zlib license
- [SDL](http://www.libsdl.org)
- BSD-style license
- [libyuv](https://code.google.com/p/libyuv/)
- ISC license
- [libyuv/source/x86inc.asm](https://code.google.com/p/libyuv/source/browse/trunk/source/x86inc.asm)
android/ijkplayer-exo is based on or derives from projects below:
- Apache License 2.0
- [ExoPlayer](https://github.com/google/ExoPlayer)
android/example is based on or derives from projects below:
- GPL
- [android-ndk-profiler](https://github.com/richq/android-ndk-profiler) (not included by default)
ios/IJKMediaDemo is based on or derives from projects below:
- Unknown license
- [iOS7-BarcodeScanner](https://github.com/jpwiddy/iOS7-BarcodeScanner)
ijkplayer's build scripts are based on or derives from projects below:
- [gas-preprocessor](http://git.libav.org/?p=gas-preprocessor.git)
- [VideoLAN](http://git.videolan.org)
- [yixia/FFmpeg-Android](https://github.com/yixia/FFmpeg-Android)
- [kewlbear/FFmpeg-iOS-build-script](https://github.com/kewlbear/FFmpeg-iOS-build-script)
### Commercial Use
ijkplayer is licensed under LGPLv2.1 or later, so itself is free for commercial use under LGPLv2.1 or later
But ijkplayer is also based on other different projects under various licenses, which I have no idea whether they are compatible to each other or to your product.
[IANAL](https://en.wikipedia.org/wiki/IANAL), you should always ask your lawyer for these stuffs before use it in your product.