bilibili/ijkplayer


Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support.

License: Other

Language: C

Keywords: android, ffmpeg, ijkplayer, ios, player, video


ijkplayer Build Status

Video player based on ffplay

Download

  • Android:
    • Gradle
# required
allprojects {
    repositories {
        jcenter()
    }
}

dependencies {
    # required, enough for most devices.
    compile 'tv.danmaku.ijk.media:ijkplayer-java:0.4.4.1'
    compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.4.4.1'

    # Other ABIs: optional
    compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.4.4.1'
    compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.4.4.1'
    compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.4.4.1'

    # ExoPlayer as IMediaPlayer: optional, experimental
    compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.4.4.1'
}
  • iOS
    • in coming...

My Build Environment

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~23
    • cpu: ARMv7a, ARM64v8a, x86 (ARMv5 is not tested on real devices)
    • api: MediaPlayer-like
    • video-output: NativeWindow
    • audio-output: OpenSL ES, AudioTrack
    • hw-decoder: MediaCodec (API 16+, Android 4.1+)
    • alternative-backend: android.media.MediaPlayer, ExoPlayer
  • iOS
    • platform: iOS 6.0~8.4.x
    • cpu: armv7, arm64, i386, x86_64, (armv7s is obselete)
    • api: MediaPlayer.framework-like
    • video-output: OpenGL ES 2.0 (I420/YV12/NV12 shaders)
    • audio-output: AudioQueue, AudioUnit
    • hw-decoder: VideoToolbox (iOS 8+)
    • alternative-backend: AVFoundation.Framework.AVPlayer, MediaPlayer.Framework.MPMoviePlayerControlelr (obselete since iOS 8)

TODO

  • iOS
    • api: AVPlayer-like

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

./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
#     }
#
# 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.4.4.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 <bbcallen@gmail.com> 
Licensed under LGPLv2.1 or later

ijkplayer required features are based on or derives from projects below:

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

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

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

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.

Project Statistics

Sourcerank 9
Repository Size 7.66 MB
Stars 25,100
Forks 6,572
Watchers 1,206
Open issues 2,368
Dependencies 0
Contributors 19
Tags 76
Created
Last updated
Last pushed

Top Contributors See all

bbcallen zccicy Yuvesy tewilove Yrom Wang Lionel Lee cwq Gdier xqq JavanEu Aven Wu Juan Pablo Lozano ctiao Drew 小米-胡纯冬 empty Jianfeng Zhang Snorlax Sebastian Roth

Recent Tags See all

k0.8.3 September 08, 2017
k0.8.2 August 03, 2017
k0.8.1 June 15, 2017
k0.8.0 May 19, 2017
k0.7.9 April 06, 2017
k0.7.8.1 March 14, 2017
k0.7.8 March 08, 2017
k0.7.7.1 February 08, 2017
k0.7.7 February 04, 2017
k0.7.6 January 05, 2017
k0.7.5 November 24, 2016
k0.7.4 November 09, 2016
k0.7.3 November 08, 2016
k0.7.2 November 04, 2016
k0.7.1 November 04, 2016

Interesting Forks See all

befovy/ijkplayer
Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support. Backend for...
C - Other - Last pushed - 26 stars - 5 forks
limbo0312/ijkplayer-liveYY
1、ijkplayer-liveYY 为移动直播特性分支 。2、优化思路围绕直播特性来实现。
This repository is no longer maintained - Last pushed
chenwdong/ijkplayer
Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support.
C - Other - Updated - 2 stars
poholo/ijkplayer
Android/iOS video player based on FFmpeg n3.1, with MediaCodec, VideoToolbox support.
C - Other - Last pushed - 1 stars
angleloverain/ijkplayer
Android/iOS video player based on FFmpeg n3.4, with MediaCodec, VideoToolbox support.
Other - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2017-11-24 18:52:29 UTC

Login to resync this repository