| Platform | Build Guide |
|---|---|
| Android | 编译指南 |
| iOS | 编译指南 |
Video player based on ffplay
# required
allprojects {
repositories {
maven {url 'https://jitpack.io'}
}
}dependencies {
compile 'com.gitee.mahongyin:ijkplayer-java:0.1.0'
compile 'com.gitee.mahongyin:ijkplayer-armv7a:0.1.0'
# Other ABIs: optional
compile 'com.gitee.mahongyin:ijkplayer-arm64:0.1.0'
compile 'com.gitee.mahongyin:ijkplayer-x86:0.1.0'
compile 'com.gitee.mahongyin:ijkplayer-x86_64:0.1.0'
# ExoPlayer as IMediaPlayer: optional, experimental
compile 'com.gitee.mahongyin:ijkplayer-exo:0.1.0'
compile 'com.gitee.mahongyin:ijkplayer-exo2:0.1.0'}
- iOS
- in coming...
### My Build Environment
- Common
- Mac OS X 10.11.5
- Android
- [NDK r10e](http://developer.android.com/tools/sdk/ndk/index.html)
- Android Studio 2.1.3
- Gradle 2.14.1
- iOS
- Xcode 7.3 (7D175)
- [HomeBrew](http://brew.sh)
- ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- brew install git
### Latest Changes
- [NEWS.md](NEWS.md)
### Features
- Common公共
- remove rarely used ffmpeg components to reduce binary size [config/module-lite.sh](config/module-lite.sh)
- 删除很少使用的 ffmpeg 组件以减少二进制大小 [configmodule-lite.sh](configmodule-lite.sh)
- workaround for some buggy online video.
- 一些有问题的在线视频的解决方法。
- Android
- platform: API 16~34
- 平台：API 16~34
- cpu: ARMv7a, ARM64v8a, x86 x86_64
- api: [MediaPlayer-like](android/ijkplayer/ijkplayer-java/src/main/java/tv/danmaku/ijk/media/player/IMediaPlayer.java)
- video-output: NativeWindow, OpenGL ES 2.0
- 视频输出：NativeWindow、OpenGL ES 2.0
- audio-output: AudioTrack, OpenSL ES
- 音频输出：AudioTrack、OpenSL ES
- hw-decoder: MediaCodec (API 16+, Android 4.1+)
- 硬件解码器：MediaCodec（API 16+、Android 4.1+）
- alternative-backend: android.media.MediaPlayer, ExoPlayer
- 替代后端：android.media.MediaPlayer、ExoPlayer
- iOS
- platform: iOS 7.0~17.x
- iOS - 平台：iOS 7.0~17.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)
- cpu ：armv7、arm64、i386、x86_64、（armv7s 已过时） - api：[MediaPlayer.framework-like](iosIJKMediaPlayerIJKMediaPlayerIJKMediaPlayback.h) - 视频输出：OpenGL ES 2.0 - 音频输出：AudioQueue、AudioUnit - 硬件解码器： VideoToolbox (iOS 8+) - 替代后端：AVFoundation.Framework.AVPlayer、MediaPlayer.Framework.MPMoviePlayerControlelr（自 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 Buildruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" brew install git brew install yasm
- If you prefer more codec/formatcd 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 Androidgit clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android cd ijkplayer-android git checkout -B latest k0.8.8
./init-android.sh
cd android/contrib ./compile-ffmpeg.sh clean ./compile-ffmpeg.sh all
cd .. ./compile-ijk.sh all
#
#
#
#
#
### Build iOSgit clone https://github.com/Bilibili/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
#
#
### Support (支持) ###
- Please do not send e-mail to me. Public technical discussion on github is preferred.
- 请尽量在 github 上公开讨论[技术问题](https://github.com/bilibili/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.