Bilibili/ijkplayer

Name: ijkplayer

Owner: bilibili

Description: Android/iOS video player based on FFmpeg n3.3, with MediaCodec, VideoToolbox support.

Created: 2013-06-03 04:12:04.0

Updated: 2018-01-19 01:20:50.0

Pushed: 2017-12-15 02:56:48.0

Homepage:

Size: 7947

Language: C

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

ijkplayer

Platform | Build Status ——– | ———— Android | iOS |

Video player based on ffplay

Download

• Android:
• Gradle

  quired
  rojects {
  sitories {
  jcenter()
  
  
  

dependencies {

# required, enough for most devices.
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'

}

S
n coming...

My Build Environment
mmon
ac OS X 10.11.5
droid
NDK r10e](http://developer.android.com/tools/sdk/ndk/index.html)
ndroid Studio 2.1.3
radle 2.14.1
S
code 7.3 (7D175)
omeBrew](http://brew.sh)
uby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
rew install git

Latest Changes
EWS.md](NEWS.md)

Features
mmon
emove rarely used ffmpeg components to reduce binary size [config/module-lite.sh](config/module-lite.sh)
orkaround for some buggy online video.
droid
latform: API 9~23
pu: ARMv7a, ARM64v8a, x86 (ARMv5 is not tested on real devices)
pi: [MediaPlayer-like](android/ijkplayer/ijkplayer-java/src/main/java/tv/danmaku/ijk/media/player/IMediaPlayer.java)
ideo-output: NativeWindow, OpenGL ES 2.0
udio-output: AudioTrack, OpenSL ES
w-decoder: MediaCodec (API 16+, Android 4.1+)
lternative-backend: android.media.MediaPlayer, ExoPlayer
S
latform: iOS 7.0~10.2.x
pu: armv7, arm64, i386, x86_64, (armv7s is obselete)
pi: [MediaPlayer.framework-like](ios/IJKMediaPlayer/IJKMediaPlayer/IJKMediaPlayback.h)
ideo-output: OpenGL ES 2.0
udio-output: AudioQueue, AudioUnit
w-decoder: VideoToolbox (iOS 8+)
lternative-backend: AVFoundation.Framework.AVPlayer, MediaPlayer.Framework.MPMoviePlayerControlelr (obselete since iOS 8)

NOT-ON-PLAN
solete platforms (Android: API-8 and below; iOS: pre-6.0)
solete cpu: ARMv5, ARMv6, MIPS (I don't even have these types of devices?)
tive subtitle render
filter 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 (unmaintained)

install git, make, yasm

 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.sh clean

 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

cd ios

sh compile-ffmpeg.sh clean

 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.sh clean

r Ubuntu/Debian users.

choose [No] to use bash

sudo dpkg-reconfigure dash

 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.8.8

./init-android.sh

cd android/contrib ./compile-ffmpeg.sh clean ./compile-ffmpeg.sh all

cd .. ./compile-ijk.sh all

Android Studio:

Open an existing Android Studio project

Select android/ijkplayer/ and import

define ext block in your root build.gradle

ext {

compileSdkVersion = 23 // depending on your sdk version

buildToolsVersion = “23.0.0” // depending on your build tools version

targetSdkVersion = 23 // depending on your sdk version

}

If you want to enable debugging ijkplayer(native modules) on Android Studio 2.2+: (experimental)

sh android/patch-debugging-with-lldb.sh armv7a

Install Android Studio 2.2(+)

Preference -> Android SDK -> SDK Tools

Select (LLDB, NDK, Android SDK Build-tools,Cmake) and install

Open an existing Android Studio project

Select android/ijkplayer

Sync Project with Gradle Files

Run -> Edit Configurations -> Debugger -> Symbol Directories

Add “ijkplayer-armv7a/.externalNativeBuild/ndkBuild/release/obj/local/armeabi-v7a” to Symbol Directories

Run -> Debug 'ijkplayer-example'

if you want to reverse patches:

sh patch-debugging-with-lldb.sh reverse armv7a

Eclipse: (obselete)

File -> New -> Project -> Android Project from Existing Code

Select android/ and import all project

Import appcompat-v7

Import preference-v7

Gradle

cd ijkplayer

gradle

Build iOS

git 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

Demo

open ios/IJKMediaDemo/IJKMediaDemo.xcodeproj with Xcode

Import into Your own Application

Select your project in Xcode.

File -> Add Files to … -> Select ios/IJKMediaPlayer/IJKMediaPlayer.xcodeproj

Select your Application's target.

Build Phases -> Target Dependencies -> Select IJKMediaFramework

Build Phases -> Link Binary with Libraries -> Add:

IJKMediaFramework.framework

AudioToolbox.framework

AVFoundation.framework

CoreGraphics.framework

CoreMedia.framework

CoreVideo.framework

libbz2.tbd

libz.tbd

MediaPlayer.framework

MobileCoreServices.framework

OpenGLES.framework

QuartzCore.framework

UIKit.framework

VideoToolbox.framework

… (Maybe something else, if you get any link error)

Support (??) ###
ease 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

layer required features are based on or derives from projects below:
PL
[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)
ib license
[SDL](http://www.libsdl.org)
D-style license
[libyuv](https://code.google.com/p/libyuv/)
C license
[libyuv/source/x86inc.asm](https://code.google.com/p/libyuv/source/browse/trunk/source/x86inc.asm)

oid/ijkplayer-exo is based on or derives from projects below:
ache License 2.0
[ExoPlayer](https://github.com/google/ExoPlayer)

oid/example is based on or derives from projects below:
L
[android-ndk-profiler](https://github.com/richq/android-ndk-profiler) (not included by default)

IJKMediaDemo is based on or derives from projects below:
known license
[iOS7-BarcodeScanner](https://github.com/jpwiddy/iOS7-BarcodeScanner)

layer's build scripts are based on or derives from projects below:
as-preprocessor](http://git.libav.org/?p=gas-preprocessor.git)
ideoLAN](http://git.videolan.org)
ixia/FFmpeg-Android](https://github.com/yixia/FFmpeg-Android)
ewlbear/FFmpeg-iOS-build-script](https://github.com/kewlbear/FFmpeg-iOS-build-script) 

Commercial Use
layer is licensed under LGPLv2.1 or later, so itself is free for commercial use under LGPLv2.1 or later

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.

AL](https://en.wikipedia.org/wiki/IANAL), you should always ask your lawyer for these stuffs before use it in your product.