迅速了解
Vitamio是干什么的?看官方怎么说:
“Vitamio SDK for iOS是Yixia Ltd官方推出的 iOS 平台上使用的软件开发工具包(SDK),为iOS开发者提供简单、快捷的接口,帮助开发者实现 iOS 平台上的媒体播放应用。”
说白了,就是可以帮助你便捷地开发自己的iOS播放器。
本文目标
从0开始建工程,使用VitamioSDK开发一个最简单的播放器:打开app之后,能看到一个播放按钮,点击按钮,就开始播放事先放在Documents目录下的视频文件,再按一下按钮可以暂停。
就这么简单。
准备工作
下载Vitamio SDK:
https://github.com/yixia/Vitamio-iOS
当前版本是4.2.0。上个版本是1.1.3,这跳跃也太大了吧?估计是为了和安卓的Vitamio SDK保持同步。
压缩包解压后内容如下:
Doc放文档,用浏览器打开Doc/html/index.html可查看Vitamio官方文档(还是苹果官方文档的风格哦)。各种接口什么的貌似齐全,但全英文看着有点眼花啊。
Demo放了一个直接编译就能运行的工程,可以播放多个在线视频。你要是乐意,完全可以照着这个demo改造成自己想要的app。
Vitamio放的就是我们将要用到的SDK。
具体步骤
本文用于调试的真机是ipod touch5,系统是iOS7.0.4。
新建工程
新建一个Single View工程
起个名字叫myPlayer
简单UI
在storyboard中拖放三个控件,分别是UILabel,用于展示视频名称;UIView用于承载播放画面,UIButton用于播放或暂停。
按钮的default状态显示“播放”,selected状态显示“暂停”:
建立控件与变量的连接:
UILabel是lblTitle
UIView是playerView
UIButton是btnPlayOrPause,点击事件是btnPlayOrPauseClick
再加一个NSString变量存视频地址
目前看起来这样:
[objc] view
plaincopy
- @interface iTechBlueViewController : UIViewController
- {
- NSString* videoPath;
- }
- @property (weak, nonatomic) IBOutlet UILabel *lblTitle;
- @property (weak, nonatomic) IBOutlet UIView *playerView;
- @property (weak, nonatomic) IBOutlet UIButton *btnPlayOrPause;
- - (IBAction)btnPlayOrPauseClick:(id)sender;
- @end
检测视频文件
我们要遍历Documents文件夹下的文件,将找到的第一个视频文件的地址记住,并将其名称显示在UILabel上。
[objc] view
plaincopy
- -(NSString*)findVideoInDocuments
- {
- NSString *documentsDirectory = [NSString stringWithFormat:@"%@/Documents", NSHomeDirectory()];
- NSFileManager *fileMg = [[NSFileManager alloc] init];
- //遍历Documents下的文件,找到视频文件就返回它的全路径
- NSArray *subPaths = [fileMg contentsOfDirectoryAtPath:documentsDirectory error:nil];
- if (subPaths) {
- for (NSString *subPath in subPaths) {
- if ( [self isMediaFile:[subPath pathExtension]]) {
- NSString *path = [documentsDirectory stringByAppendingPathComponent:subPath];
- return path;
- }
- }
- }
- return nil;
- }
[objc] view
plaincopy
- -(BOOL)isMediaFile:(NSString*)pathExtension
- {
- //可用格式
- /*
- ".M1V", ".MP2", ".MPE", ".MPG", ".WMAA",
- ".MPEG", ".MP4", ".M4V", ".3GP", ".3GPP", ".3G2", ".3GPP2", ".MKV",
- ".WEBM", ".MTS", ".TS", ".TP", ".WMV", ".ASF", ".ASX", ".FLV",
- ".MOV", ".QT", ".RM", ".RMVB", ".VOB", ".DAT", ".AVI", ".OGV",
- ".OGG", ".VIV", ".VIVO", ".WTV", ".AVS", ".SWF", ".YUV"
- */
- //简单粗暴地判断是否为视频格式,这里先试6个
- NSString*ext = [pathExtension uppercaseString];
- if([ext isEqualToString:@"MP4"])
- {
- return YES;
- }
- else if([ext isEqualToString:@"MOV"])
- {
- return YES;
- }
- else if([ext isEqualToString:@"RMVB"])
- {
- return YES;
- }
- else if([ext isEqualToString:@"MKV"])
- {
- return YES;
- }
- else if([ext isEqualToString:@"FLV"])
- {
- return YES;
- }
- else if([ext isEqualToString:@"TS"])
- {
- return YES;
- }
- return NO;
- }
[objc] view
plaincopy
- - (void)viewDidLoad
- {
- [super viewDidLoad];
- videoPath = [self findVideoInDocuments];
- if(videoPath)
- {
- _lblTitle.text = [videoPath lastPathComponent];
- }
- }
现在编译一下看看有没有问题吧!
好,虽然没问题,但也只是我们拖出来的那个界面而已。
咱们现在用iFunBox往Documents文件夹下放一个视频吧。
什么!?你还没用过iFunBox?赶紧去下载一个试试,确实能给开发带来便利哦。
我放了一个特小的文件0.ts进去。
再编译试试,这回题目就出来啦!
添加Vitamio并配置工程(or not?)
现在我们已经有了视频文件并且获得了它的具体路径,接着就是要播放它了。开始使用Vitamio!
将上文解压后获得的Vitamio文件夹添加至工程:
添加后如果你手痒编译,竟然发现是能编译成功的!
难道VitamioSDK这么强悍,不需要任何配置就能用了?且往下看。
写播放器代码
引入Vitamio头文件
[objc] view
plaincopy
- #import "Vitamio.h"
声明一个播放器变量
[objc] view
plaincopy
- VMediaPlayer *mMPayer;
声明使用播放器协议
[objc] view
plaincopy
- <VMediaPlayerDelegate>
以上三行代码写好,Vitamio SDK的各种接口就可以任你调遣了。这是最精简的配置。
VMediaPlayer和VMediaPlayerDelegate都藏了什么好东西?我们只能边学变探索。
现在咱们的头文件看起来是这样的:
[objc] view
plaincopy
- #import
- #import "Vitamio.h"
- @interface iTechBlueViewController : UIViewController
- {
- NSString* videoPath;
- VMediaPlayer *mMPayer;
- }
- @property (weak, nonatomic) IBOutlet UILabel *lblTitle;
- @property (weak, nonatomic) IBOutlet UIView *playerView;
- @property (weak, nonatomic) IBOutlet UIButton *btnPlayOrPause;
- - (IBAction)btnPlayOrPauseClick:(id)sender;
- @end
初始化播放器,以下代码是初始化播放器的最精简写法。
[objc] view
plaincopy
- -(void)initPlayer
- {
- if (!mMPayer) {
- mMPayer = [VMediaPlayer sharedInstance];
- [mMPayer setupPlayerWithCarrierView:self.playerView withDelegate:self];
- }
- }
可以看到,我们将自己拖到界面上的playerView传了过去,表示要用它来承载视频画面。
准备播放视频,同样,下面代码是准备播放视频最精简的写法:
[objc] view
plaincopy
- -(void)prepareVideo
- {
- if(videoPath)
- {
- //播放时不要锁屏
- [UIApplication sharedApplication].idleTimerDisabled = YES;
- NSURL* videoURL = [NSURL fileURLWithPath:videoPath];
- [mMPayer setDataSource:videoURL];
- [mMPayer prepareAsync];
- }
- }
我们的代码写到prepareAsync,就把工作丢给Vitamio了。它会在准备好后在协议方法中通知我们的。
如果这时候你是一副“啥意思”的表情,请看工程的这个地方:
它在警告你:有些method没有实现,那是因为我们引用了VMediaPlayerDelegate之后还没去实现它需要的几个方法:
@required表示,以上三个方法是必须的,我们一一实现之。
首先添加一个布尔变量BOOL didPrepared,它非常重要,是我们的代码首次介入播放器的逻辑。
didPrepared是在Vitamio准备好播放视频后被调用的,我们可以在这时候记录下布尔值——播放准备好了,同时让播放器开始播放:
[objc] view
plaincopy
- - (void)mediaPlayer:(VMediaPlayer *)player didPrepared:(id)arg
- {
- //显示“暂停”两字
- _btnPlayOrPause.selected = YES;
- didPrepared = YES;
- [player start];
- }
playbackComplete会在视频播放结束后被调用,这时可以记录播放历史、退出播放器什么的,但这里我们要的是最简,所以将播放器重置,从而要再播放的话,就得调用我们写的prepareVideo,这时didPrepared设为NO。
[objc] view
plaincopy
- - (void)mediaPlayer:(VMediaPlayer *)player playbackComplete:(id)arg
- {
- _btnPlayOrPause.selected = NO;
- [player reset];
- didPrepared = NO;
- }
error会在Vitamio处理视频出错时被调用,让你有机会提醒用户或做其他处理,这里我们只是默默得打一个log:
[objc] view
plaincopy
- - (void)mediaPlayer:(VMediaPlayer *)player error:(id)arg
- {
- NSLog(@"VMediaPlayer Error: %@", arg);
- }
记得在ViewDidLoad中调用initPlayer进行初始化,变这样:
[objc] view
plaincopy
- - (void)viewDidLoad
- {
- [super viewDidLoad];
- videoPath = [self findVideoInDocuments];
- if(videoPath)
- {
- _lblTitle.text = [videoPath lastPathComponent];
- [self initPlayer];
- }
- }
如果你想一打开app就播放视频,可以将第一次prepareVideo放在ViewDidAppear中。
在按钮点击中控制播放还是暂停:
[objc] view
plaincopy
- - (IBAction)btnPlayOrPauseClick:(id)sender {
- if(videoPath)
- {
- BOOL isPlaying = [mMPayer isPlaying];
- if (isPlaying) {
- [mMPayer pause];
- _btnPlayOrPause.selected = NO;
- } else {
- if(didPrepared)
- [mMPayer start];
- else
- [self prepareVideo];
- _btnPlayOrPause.selected = YES;
- }
- }
- }
这里用Vitamio接口isPlaying来判断是否正在播放是最准确的,比我们自己维护一个播放状态要好。
但视频是否准备好这个状态由我们记录(didPrepared)。
点击播放时比想象中复杂,是因为要判断视频是否已经准备好,如果是的话继续播放,如果没有的话得调用做准备的方法。
写到这,代码好像就完成啦!去编译吧!去启动你写的第一个播放器吧少年!
配置Vitamio
你当时就震惊了。代码写得好顺利,现在一编译,为什么直接就failed了呢?出来50个error!
不用着急这调试,你该记起在VitamioSDK 添加进来后还没有配置吧?
原来还是得配置的,刚才开心得太早。。。
首先需要去Build Phases添加些framework和dylib,如下所示:
文字版如下:
如果你有强迫症,倒序添加下面的库,得到的就是按首字母从小到大排列的顺序
[plain] view
plaincopy
- libbz2.dylib
- libiconv.dylib
- libstdc++.dylib
- libz.dylib
- AVFoundation.framework
- AudioToolbox.framework
- CoreMedia.framework
- CoreVideo.framework
- MediaPlayer.framework
- OpenGLES.framework
- QuartzCore.framework
添加后再编译。
欧耶,编译通过啦!
但是点击播放后会崩溃,有一条log是:
[plain] view
plaincopy
- [UIDevice platformString]: unrecognized selector sent to instance
还是不着急调试,去到Build Setting,找到Linking下的Other Linker Flags,添加“-ObjC”:
然后编译再试,oh my god!可以播放啦!
如果这时候你依然很冷静,在思考一个问题:为啥这么一设就好了呢?其实Vitamio sdk作者早已料到你有此一问,你可以在上文提到的Doc文件夹下找到一个FAQ.md文件,里面就专门对这个问题进行了解答。
另外,我不会告诉你,Doc下的 Vitamio_SDK_for_iOS_User_Manual_cn.md是一篇比本博文更简洁但信息足够齐全的中文教程。你值得一读。
多说两句
能够播放和暂停是一个好的开始,但你肯定觉得不够。停止呢?进度控制呢?时长呢?快放呢?后台播放呢?切换上一首下一首呢?截图呢?视频缩略图呢?播放在线视频呢?……
各种播放器该有的功能在以后的博客里都会讲到,敬请期待。
最后,记得设置你工程的version为1.0。
源码在这
来源:http://blog.csdn.net/itechblue/article/details/17932151