ijkplayer
Video player based on ffplay
My Build Enviroment
Common
Mac OS X 10.10.4
Android
Android Studio 1.2.2
iOS
Xcode 6.4 (6E35b)
brew install git
Latest Changes
Features
Common
remove rarely used ffmpeg components to reduce binary size config/module-lite.sh
workaround for some buggy online video.
Android
platform: API 9~22
cpu: ARMv7a, x86, ARMv5 (ARMv5 is not tested on real devices)
video-output: NativeWindow
audio-output: OpenSL ES, AudioTrack
hw-decoder: MediaCodec (API 16+, Android 4.1+)
iOS
platform: iOS 6.0~8.4.x
cpu: armv7, arm64, i386, x86_64, (armv7s is obselete)
video-output: OpenGL ES 2.0 (I420/YV12/NV12 shaders)
audio-output: AudioQueue, AudioUnit
hw-decoder: VideoToolbox (iOS 8+)
TODO
iOS
api: AVPlayer-like
NOT-ON-PLAN
obsolete platforms (Android: API-8 and below; iOS: below 5.1.1)
obsolete cpu: ARMv5, ARMv6, MIPS (I don't even have these types of devices…)
native subtitle render
avfilter support
Before Build
# install homebrew, git, yasm
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git
brew install yasm
# add these lines to your ~/.bash_profile or ~/.profile
# export ANDROID_SDK=
# export ANDROID_NDK=
# on Cygwin
# install git, make, yasm
If you prefer more codec/format
cd config
rm module.sh
ln -s module-default.sh module.sh
cd android/contrib
# cd ios
sh compile-ffmpeg 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
# cd ios
sh compile-ffmpeg clean
For Ubuntu/Debian users.
# choose [No] to use bash
sudo dpkg-reconfigure dash
If you'd like to share your config, pull request is welcome.
Build Android
git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android
cd ijkplayer-android
git checkout -B latest k0.3.1
./init-android.sh
cd android/contrib
./compile-ffmpeg.sh clean
./compile-ffmpeg.sh all
cd ..
./compile-ijk.sh all
# Eclipse:
# File -> New -> Project -> Android Project from Existing Code
# Select android/ and import all project
#
# Android Studio:
# Open an existing Android Studio project
# Select android/ijkplayer/ and import
#
# define ext block in your root build.gradle
# ext {
# compileSdkVersion = 22 // depending on your sdk version
# buildToolsVersion = "22.0.1" // depending on your build tools version
# }
#
# Gradle
# cd ijkplayer
# gradle
Build iOS
git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-ios
cd ijkplayer-ios
git checkout -B latest k0.3.1
./init-ios.sh
cd ios
./compile-ffmpeg.sh clean
./compile-ffmpeg.sh all
# import ios/IJKMediaPlayer for MediaPlayer.framework-like interface (recommended)
# open ios/IJKMediaDemo/IJKMediaDemo.xcodeproj with Xcode
Support (支持)
Although not all issues can be well resolved by me in time, but they are welcome, and could be resolved by other developers.
能力所限,我个人无法及时有效解决所有问题,不过仍然欢迎提交问题。考虑到某些问题有可能被老外大牛看到并解决,建议尽量用英文提问,以获得更多支持。
Please do not send e-mail to me. Public technical discussion on github is preferred.
请尽量在 github 上公开讨论技术问题,不要以邮件方式私下询问,恕不一一回复。
License
Copyright (C) 2013-2015 Zhang Rui
Licensed under LGPLv2.1 or later
ijkplayer is based on or derives from projects below:
zlib license
Apache License v2
BSD-style license
GPL
android-ndk-profiler (not included by default)
ijkplayer's build scripts are based on or derives from projects below:
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, you should always ask your lawyer for these stuffs before use it in your product.