README.md

ijkplayer

Platform	Build Status
Android
iOS

Video player based on ffplay

Download

• Android:
• Gradle

- in coming...

• 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
• ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
• brew install git

Latest Changes

• NEWS.md

Features

• Common
• Enable RTSP 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
• 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
• 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

# 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=<your sdk path>
# export ANDROID_NDK=<your ndk path>

# on Cygwin (unmaintained)
# 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.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
# cd ios
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
# cd ios
sh compile-ffmpeg.sh 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/baka3k/IjkPlayerRecorder.git
cd IjkPlayerRecorder
./init-android.sh

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

cd ..
./compile-ijk.sh all

After successed, you can find *so file from
- /IjkPlayerRecorder/android/ijkplayer/ijkplayer-armv7a/src/main/libs/armeabi-v7a
- /IjkPlayerRecorder/android/ijkplayer/ijkplayer-armv5/src/main/libs/armeabi
- /IjkPlayerRecorder/android/ijkplayer/ijkplayer-arm64/src/main/libs/arm64-v8a

Open sample project by Android Studio
- IjkPlayerRecorder/android/ijkplayer/ijkplayer-example
Then copy *so files(with folder armeabi-v7a,armeabi,arm64-v8a) to libs(or jniLibs - depend android studio version 
Sync gradle and build android project
Have fun :)

Build iOS

git clone https://github.com/baka3k/IjkPlayerRecorder.git
cd IjkPlayerRecorder

./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 (支持)

• Please do not send e-mail to me. Public technical discussion on github is preferred.
• 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
  • libVLC
  • kxmovie
  • soundtouch
• zlib license
  • SDL
• BSD-style license
  • libyuv
• ISC license
  • libyuv/source/x86inc.asm

android/ijkplayer-exo is based on or derives from projects below:

• Apache License 2.0
  • ExoPlayer

android/example is based on or derives from projects below:

• GPL
  • android-ndk-profiler (not included by default)

ios/IJKMediaDemo is based on or derives from projects below:

• Unknown license
  • iOS7-BarcodeScanner

ijkplayer's build scripts are based on or derives from projects below:

• gas-preprocessor
• VideoLAN
• yixia/FFmpeg-Android
• 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, you should always ask your lawyer for these stuffs before use it in your product.