前言
因为项目的关系,在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
因为我之前都已经安装过了,所以在这里做一个版本检查:
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.真实效果如下:
下载ffmpeg并编译
1.首先我们需要下载ffmpeg,接着上面的目录在终端中输入:
//下载ffmpeg和相关脚本
./init-ios.sh
因为ffmpeg比较大,再加上访问国外线路比较慢,遇到下载失败需要多试几次,如果有代理建议上代理,真实效果如下:
太长了中间我就略过去了,需要留意中间有没有出错,否则影响后面流程。
2.编译ffmpeg
//进入ios目录
cd ios
//clean
./compile-ffmpeg.sh clean
//编译
./compile-ffmpeg.sh all
真实效果如下:
编译环节比较久,估计15分钟,中间偶尔会报警告,只要不是错误,无视即可。
正确编译的效果:
前面几步是新手最容易遇到错误的环节(其实大部分还是网络问题,你懂的),成功走到这步后就简单多了
热身运动,从Demo入手
1.ijkplayer给我们提供了一个学习用的demo,它就是IJKMediaDemo。
首先我们先找到IJKMediaDemo,并打开它:
2.运行Demo
只要前面的流程没报错,这里编译运行都不会出现问题:
我们在Online Samples
中选择一个m3u8
测试ijkplayer是否运行正常。
不过有些公司会封锁在线播放视频行为,可能出现无法播放的情况,比如我司(- -||),我们可以使用本地视频来解决这个问题,后面讲解代码的时候会提到。
大家还记得官网上的这句话吗?
# import ios/IJKMediaPlayer for MediaPlayer.framework-like interface (recommended)
将IJKMediaPlayer集成进项目中当framework一样调暴露的接口用,看下面画红圈处:
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最基本的代码都用红圈圈出来了
将ijkplayer集成进自己的项目中
1.直接拖拽(暂不可用)
首先我们需要新建一个iOS项目,我取名为ijkplayer-showcase,然后将IJKMediaPlayer.xcodeproj拖拽进自己的项目中来,如下图所示:
不知道为什么这次创建出的工程会报头文件找不到,我怀疑是不是头文件搜索出了问题,暂时还没找到具体原因,如下所示:
2.制作framework
相比拖拽引入的方式,制作出来的framework体积来的更小,默认情况下大约100MB,容易放到版本管理中。而且可以事先针对开发和生产做不同的配置来精简framework,等到生产时再替换生产的framework就好,节约时间。
当然缺点也是必须iOS8以上才支持framework,这个还得看项目。.a包我目前还没做过不太清楚。
制作framework其实挺方便,因为作者基本上已经帮我们设置好了。我们只需要对细节进行一些微调就完成了。
2.1.首先我们打开IJKMediaPlayer.xcodeproj,如下图所示:
2.2.接着点击IJKMediaFramework出现选择框,选择edit scheme,如下图所示:
2.3.将build configuration改为Release后点Close,如下图所示:
2.4.分别在模拟器和真机(Generic iOS Device也可以)上编译
2.5.打开framework所在的目录,如下图所示:
2.6.接下来我们要将两个framework合并在一起,这样就可以在真机和模拟器上开发调试了
finder中显示有两个文件夹,看名字就能猜到iphoneos是真机,iphonesimulator是模拟器的版本,如下图所示:
接下来我们要通过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/
如下图所示:
可以使用lipo -info IJKMediaFramework
查看framework的支持
2.7.将制作好的iphoneos/IJKMediaFramework.framework复制到要集成的项目中,如下图所示:
2.8.Add Files...
2.9.添加动态库
2.10.测试集成
将本段代码复制到ViewController.m中,可直接使用:
#import "ViewController.h"
#import
@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
在模拟器上声音和画面不同步或者比较卡顿的现象在真机没事的,不用太担心。
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大小
待续...