ijkplayer ios项目集成(图文详细版)

前言

因为项目的关系,在5个月前写了一篇关于ijkplayer集成的文,当时是以个人笔记的形式修改后发出来的,写的太糙,没有考虑到刚接触ijkplayer新人的感受,导致大部分人即使看完依然表示疑惑不解。
回头看看自己写的这篇文,确实需要好好检讨。于是我决定重新回炉,以一个新手的角度思考,写下这篇ijkplayer ios项目集成(图文详细版)一步步带着大家来。

1.必要的准备工作

首先是安装必要的工具
homebrew:MAC OSX上必备的软件包管理工具,有了它之后可以很方便的安装开发套件,首先我们打开命令终端输入以下命令安装homebrew:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

待安装完毕后使用以下命令分别安装git和yasm:

brew install git
brew install yasm

因为我之前都已经安装过了,所以在这里做一个版本检查:


必备的工具.jpg

2.下载ijkplayer

1.首先我们在当前用户的目录下创建一个文件夹用于后面存放ijkplayer项目,打开终端输入:

//创建showcase目录
mkdir ~/showcase
//进入该目录中
cd ~/showcase

2.接着我们需要将ijkplayer项目克隆到本地,在终端中输入:

//克隆项目
git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-ios
//进入ijkplayer-ios
cd ijkplayer-ios
//切换分支
git checkout -B latest k0.5.1
//查看
ls

3.真实效果如下:

下载ijkplayer项目.jpg

下载ffmpeg并编译

1.首先我们需要下载ffmpeg,接着上面的目录在终端中输入:

//下载ffmpeg和相关脚本
./init-ios.sh

因为ffmpeg比较大,再加上访问国外线路比较慢,遇到下载失败需要多试几次,如果有代理建议上代理,真实效果如下:

下载ffmpeg.jpg

太长了中间我就略过去了,需要留意中间有没有出错,否则影响后面流程。

2.编译ffmpeg

//进入ios目录
cd ios
//clean
./compile-ffmpeg.sh clean
//编译
./compile-ffmpeg.sh all

真实效果如下:


clean.jpg

编译环节比较久,估计15分钟,中间偶尔会报警告,只要不是错误,无视即可。


编译中出现warning.jpg

正确编译的效果:
2016-05-26_23-28-01.jpg

前面几步是新手最容易遇到错误的环节(其实大部分还是网络问题,你懂的),成功走到这步后就简单多了

热身运动,从Demo入手

1.ijkplayer给我们提供了一个学习用的demo,它就是IJKMediaDemo。
首先我们先找到IJKMediaDemo,并打开它:


demo.jpg

2.运行Demo
只要前面的流程没报错,这里编译运行都不会出现问题:
我们在Online Samples中选择一个m3u8测试ijkplayer是否运行正常。
不过有些公司会封锁在线播放视频行为,可能出现无法播放的情况,比如我司(- -||),我们可以使用本地视频来解决这个问题,后面讲解代码的时候会提到。

大家还记得官网上的这句话吗?

# import ios/IJKMediaPlayer for MediaPlayer.framework-like interface (recommended)

将IJKMediaPlayer集成进项目中当framework一样调暴露的接口用,看下面画红圈处:


2016-05-26_23-50-42.jpg

3.ijkplayer基本使用方式

IJKFFOptions *options = [IJKFFOptions optionsByDefault]; //使用默认配置
    
self.player = [[IJKFFMoviePlayerController alloc] initWithContentURL:self.url withOptions:options]; //初始化播放器,播放在线视频或直播(RTMP)
// NSString *filePath = [[NSBundle mainBundle] pathForResource:@"init"ofType:@"mp4"];
// self.player = [[IJKFFMoviePlayerController alloc]initWithContentURLString:filePath withOptions:options]; //初始化播放器,播放本地视频
self.player.view.autoresizingMask = UIViewAutoresizingFlexibleWidth|UIViewAutoresizingFlexibleHeight;
self.player.view.frame = self.view.bounds;
self.player.scalingMode = IJKMPMovieScalingModeAspectFit; //缩放模式
self.player.shouldAutoplay = YES; //开启自动播放

self.view.autoresizesSubviews = YES;
[self.view addSubview:self.player.view];
-------------常用操作-------------------
//准备
[self.player prepareToPlay];
//播放
[self.player play];
//暂停
[self.player pause];
//销毁
[self.player shutdown];

我将ijkplayer最基本的代码都用红圈圈出来了

最简单的使用方式.jpg

将ijkplayer集成进自己的项目中

1.直接拖拽(暂不可用)

首先我们需要新建一个iOS项目,我取名为ijkplayer-showcase,然后将IJKMediaPlayer.xcodeproj拖拽进自己的项目中来,如下图所示

集成类库.jpg

不知道为什么这次创建出的工程会报头文件找不到,我怀疑是不是头文件搜索出了问题,暂时还没找到具体原因,如下所示:


找不到头文件.jpg

2.制作framework

相比拖拽引入的方式,制作出来的framework体积来的更小,默认情况下大约100MB,容易放到版本管理中。而且可以事先针对开发和生产做不同的配置来精简framework,等到生产时再替换生产的framework就好,节约时间。
当然缺点也是必须iOS8以上才支持framework,这个还得看项目。.a包我目前还没做过不太清楚。
制作framework其实挺方便,因为作者基本上已经帮我们设置好了。我们只需要对细节进行一些微调就完成了。

2.1.首先我们打开IJKMediaPlayer.xcodeproj,如下图所示:


2016-05-27_02-34-31.jpg

2.2.接着点击IJKMediaFramework出现选择框,选择edit scheme,如下图所示:


2016-05-27_02-37-52.jpg

2.3.将build configuration改为Release后点Close,如下图所示:
2016-05-27_02-38-12.jpg

2.4.分别在模拟器和真机(Generic iOS Device也可以)上编译



2.5.打开framework所在的目录,如下图所示:


2016-05-27_02-54-30.jpg

2.6.接下来我们要将两个framework合并在一起,这样就可以在真机和模拟器上开发调试了

finder中显示有两个文件夹,看名字就能猜到iphoneos是真机,iphonesimulator是模拟器的版本,如下图所示:


2016-05-27_03-00-21.jpg

接下来我们要通过lipo的命令将两者合并输出,在Products目录下输入:
//合并
lipo -create Release-iphoneos/IJKMediaFramework.framework/IJKMediaFramework Release-iphonesimulator/IJKMediaFramework.framework/IJKMediaFramework -output IJKMediaFramework
//将合并后的framework拷贝到iphoneos/IJKMediaFramework.framework中
cp IJKMediaFramework Release-iphoneos/IJKMediaFramework.framework/

如下图所示:


2016-05-27_03-11-37.jpg

可以使用lipo -info IJKMediaFramework查看framework的支持

2016-05-27_03-51-08.jpg

2.7.将制作好的iphoneos/IJKMediaFramework.framework复制到要集成的项目中,如下图所示:


2016-05-27_03-20-25.jpg

2.8.Add Files...


2016-05-27_03-20-46.jpg

2.9.添加动态库


2016-05-27_03-24-37.jpg

2.10.测试集成
将本段代码复制到ViewController.m中,可直接使用:
#import "ViewController.h"
#import <IJKMediaFramework/IJKFFMoviePlayerController.h>
@interface ViewController ()
@property(nonatomic,strong)IJKFFMoviePlayerController * player;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    IJKFFOptions *options = [IJKFFOptions optionsByDefault]; //使用默认配置
    NSURL * url = [NSURL URLWithString:@"rtmp://live.hkstv.hk.lxdns.com/live/hks"]; 
    self.player = [[IJKFFMoviePlayerController alloc] initWithContentURL:url withOptions:options]; //初始化播放器,播放在线视频或直播(RTMP)
    self.player.view.autoresizingMask = UIViewAutoresizingFlexibleWidth|UIViewAutoresizingFlexibleHeight;
    self.player.view.frame = self.view.bounds;
    self.player.scalingMode = IJKMPMovieScalingModeAspectFit; //缩放模式
    self.player.shouldAutoplay = YES; //开启自动播放
    
    self.view.autoresizesSubviews = YES;
    [self.view addSubview:self.player.view];
}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    [self.player prepareToPlay];
}

-(void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    [self.player shutdown];
}
- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

@end

在模拟器上声音和画面不同步或者比较卡顿的现象在真机没事的,不用太担心。

2016-05-27_03-35-15.jpg

3.通过第三方的cocoapods集成方式(非官方)

为苦于各种奇怪原因而无法玩耍的小伙伴们提供了包装了ijkplayer的pod,仅供测试体验。
1.基于ijkplayer 5737ccc提交制作成的framework,需要注意的是需要iOS8+
2.如果使用ijkplayer过程中遇到BUG什么的,可以移步去ijkplayer作者的GitHub上提issue或者PR。
地址在这里https://coding.net/u/shirokuma/p/IJKMediaLibrary/git,因framework超过100MB无法传到GitHub上,就放到Coding上了。祝各位玩的愉快!

技巧

1.如何强制打开硬解

//需要注意的是强制打开硬解,以前发现过播放视频白屏等问题,现在的版本不清楚,谨慎开启
[options setPlayerOptionIntValue:1 forKey:@"videotoolbox"];

2.如何进一步精简framework大小
待续...

推荐阅读更多精彩内容