Playback
控制assets的播放,你可以使用AVPlayer对象。在播放的过程中,你可以使用AVPlayerItem对象来管理asset的呈现,AVPlayerItemTrack来管理track的呈现状态。要显示视频,需要使用AVPlayerLayer对象。
1. Playing Assets
一个播放器就是控制asset播放的对象,比如开始和结束,seek到指定的时间。可以使用AVPlayer来播放单个asset,用AVQueuePlayer来播放多个连续的asset。
一个player向你提供播放的信息,如果需要,你通过player的状态同步显示到界面上。你也可以直接把player的输出显示笑傲指定的动画层(AVPlayerLayer或者AVSynchronizedLayer)
多个layer:可以创建多个AVPlayerLayer对象,但只有最近创建的layer才会显示视频画面。
虽然是播放asset,但是不能直接把asset传给AVPlayer对象,你应该提供AVPlayerItem对象给AVPlayer。一个player item管理着和它相关的asset。一个player item包括player item tracks-(AVPlayerItemTrack对象,表示asset中的tracks)。
你可以同时用不同的player播放同一个asset。
你可以用一个存在asset直接初始化player,或者直接用URL初始化。和AVAsset一样,简单的初始化一个player并不表示可以马上进行播放,你需要观察它的status(通过kvo)来决定是否可以播放。
2. Handling Different Types of Asset
配置asset的方式由需要播放的asset的类型决定的。概括的说,有两种方式:基于文件的asset,基于流式的(http live streaming format)
加载基于文件的asset,有如下几步:
· 使用AVURLAsset创建一个asset。
· 使用创建的asset来创建一个AVPlayerItem对象item
· item和AVPlayer关联
· 等待item的状态,知道可以播放。
创建基于HTTP live stream的播放器:
用url初始化一个AVPlayerItem对象。(http live stream的情况下不能直接创建AVAsset对象)
code:
NSURL *url = [NSURL URLWithString:@"<#Live stream URL#>];
// You may find a test stream at <http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8>.
self.playerItem = [AVPlayerItem playerItemWithURL:url];
[playerItem addObserver:self forKeyPath:@"status" options:0 context:&ItemStatusContext];
self.player = [AVPlayer playerWithPlayerItem:playerItem];
当你关联一个player item到player的时候,这个播放器开始准备播放。当它可以播放的时候,player item会创建AVAsset和AVAssetTrack对象,这些对象可以用来检查live stream的内容。
为了获取stream的时间,可以通过kvo的方式观察player item的duration的属性。当可以播放的时候,这个属性被设置为正确的值,这时就可以获取时间。
注意:只能在iOS4.3之后使用player item的duration属性。下面这种获取duration的方法适用于所有的iOS系统版本:当player item的状态变为AVPlayerItemStatusReadyToPlay时,duration可以通过下面代码获取
[[[[[playerItem tracks] objectAtIndex:0] assetTrack] asset] duration];
如果仅仅是想播放一个live stream,可以直接用下面的简短代码实现:
code:
self.player = [AVPlayer playerWithURL:<#Live stream URL#>];
[player addObserver:self forKeyPath:@"status" options:0 context:&PlayerStatusContext];
正如assets和items一样,初始化一个player之后并不表明可以马上播放,你需要观察player的status属性,当status变为AVPlayerStatusReadyToPlay时表示可以播放了,你也需要观察curretItem属性来访问player item。
如果你不能确定你用的url是什么类型,可以用下面的方法检测:
. 尝试用url初始化AVURLAsset,然后load它的tracks key,如果tracks load 成功,表明你可以用这个asset创建player item。
. 如果第一步失败,直接用url创建AVPlayerItem,观察status属性,看是否有可播放的状态。
3. Playing an Item
播放视频,code:
- (IBAction)play:sender {
[player play];
}
除了播放之外,还可以管理player的各种信息,比如rate和播放头,你也可以监控player的状态,这很有用,比如说你需要根据播放的状态来更新界面。
4. Changing the Playback Rate
可以改变播放的rate, code:
aPlayer.rate = 0.5;
aPlayer.rate = 2.0;
rate=1.0表示正常的播放。0.0表示暂停,和pause相同。
player item支持逆向播放,当rate设置为负数的时候就是逆向播放.playeritem的 canPlayReverse 表示rate为-1.0,canPlaySlowReverse表示rate的范围是-0.0到-1.0,canPlayFastReverse表示rate小于-1.0f。
5. Seeking - Repositioning the Playhead
可以使用seekToTime:重定位播放头到指定的时间,code:
CMTime fiveSecondsIn = CMTimeMake(5, 1);
[player seekToTime:fiveSecondsIn];
seekToTime:不能精确定位,如果需要精确定位,可以使用seekToTime:toleranceBefore:toleranceAfter:
code:
CMTime fiveSecondsIn = CMTimeMake(5, 1);
[player seekToTime:fiveSecondsIn toleranceBefore:kCMTimeZero toleranceAfter:kCMTimeZero];
当tolerance=0的时候,framework需要进行大量解码工作,比较耗性能,所以,只有当你必须使用的时候才用这个方法,比如开发一个复杂的多媒体编辑应用,这需要精确的控制。
当播放结束后,播放头移动到playerItem的末尾,如果此时调用play方法是没有效果的,应该先把播放头移到player item起始位置。如果需要实现循环播放的功能,可以监听通知AVPlayerItemDidPlayToEndTimeNotification,当收到这个通知的时候,调用seekToTime:把播放头移动到起始位置。
code:
// Register with the notification center after creating the player item.
[[NSNotificationCenter defaultCenter]
addObserver:self
selector:@selector(playerItemDidReachEnd:)
name:AVPlayerItemDidPlayToEndTimeNotification
object:<#The player item#>];
- (void)playerItemDidReachEnd:(NSNotification *)notification {
[player seekToTime:kCMTimeZero];
}
6. Playing Multiple Items
可以使用AVQueuePlayer播放多个items,AVQueuePlayer是AVPlayer的子类,可以用一个数组来初始化一个AVQueuePlayer对象。
code:
NSArray *items = <#An array of player items#>;
AVQueuePlayer *queuePlayer = [[AVQueuePlayer alloc] initWithItems:items];
和AVPlayer一样,调用play来播放,queue player顺序播放队列中的item,如果要跳过一个item播放下一个item,可以调用advanceToNextItem。
可以对队列进行插入和删除操作,调用方法insertItem:afterItem:, removeItem:, 和 removeAllItems。当插入一个item之前,应该用canInsertItem:afterItem:方法检查是否可以插入。当第二个参数传nil时,检测是否可以添加到队列中。
code:
AVPlayerItem *anItem = <#Get a player item#>;
if ([queuePlayer canInsertItem:anItem afterItem:nil]) {
[queuePlayer insertItem:anItem afterItem:nil];
}
7. Monitoring Playback
播放时,你可以监视player 和player item 的显示状态。state changes 非常有用,并不在你的直接控制下。
· 如果用户切换到其他应用程序,则需要把player的rate设为0.0
· 如果播放的是远程媒体,当收到更多的数据的时候,player的loadedTimeRange和seekableTimeRange属性将会不断改变。
· 当player播放的是http live stream的时候,player的currentItem会不断改变。
· 播放http live stream的时候,player item的tracks属性也不断改变。这会发生在player改变编码方式的时候。
· 当播放失败的时候,player或者player item的status属性也会改变。
可以使用kvo来监测这些属性值的变化。
1)Responding to a Change in Status
当player或者player item的状态status改变,系统会发送一个kvo的notification,如果一个对象由于一些原因不能播放,stauts会变成AVPlayerStatusFailed 或者 AVPlayerItemStatusFailed ,在这种情况下,这个对象的error属性会被附上一个error类型的对象,这个error对象描述了失败的原因。
AV Foundation不会指定这个notification是由哪个线程发出的,所以,如果你要更新UI,就必须确保更新的代码在主线程中调用。
code:
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object
change:(NSDictionary *)change context:(void *)context {
if (context == <#Player status context#>) {
AVPlayer *thePlayer = (AVPlayer *)object;
if ([thePlayer status] == AVPlayerStatusFailed) {
NSError *error = [<#The AVPlayer object#> error];
// Respond to error: for example, display an alert sheet.
return;
}
// Deal with other status change if appropriate.
}
// Deal with other change notifications if appropriate.
[super observeValueForKeyPath:keyPath ofObject:object
change:change context:context];
return;
}
2)Tracking Readiness for Visual Display
当 layer有开播放内容时,AVPlayerLayer对象的readyForDisplay属性会发送通知。
3)Tracking Time
可以使用addPeriodicTimeObserverForInterval:queue:usingBlock: 或者 addBoundaryTimeObserverForTimes:queue:usingBlock:来跟踪播放的进度,根据这个进度,你可以更新UI,比如播放了多少时间,还剩多少时间,或者其他的UI状态。
· addPeriodicTimeObserverForInterval:queue:usingBlock:,这个方法传入一个CMTime结构的时间区间,每隔这个时间段的时候,block会回调一次,开始和结束播放的时候block也会回调一次。
· addBoundaryTimeObserverForTimes:queue:usingBlock:,这个放传入一个CMTime结构的数组,当播放到数组里面的时间点的时候,block会回调。
这两个方法都返回一个id类型的对象,这个对象必须一直被持有。可以使用removeTimeObserver:取消这个观察者。
对于这两个方法,AVFoundation不会保证每次时间点到了的时候都会回调block,如果前面回调的block没有执行完的时候,下一次就不会回调。所以,必须保证在block里面的逻辑不能太耗时。
code:
// Assume a property: @property (strong) id playerObserver;
Float64 durationSeconds = CMTimeGetSeconds([<#An asset#> duration]);
CMTime firstThird = CMTimeMakeWithSeconds(durationSeconds/3.0, 1);
CMTime secondThird = CMTimeMakeWithSeconds(durationSeconds*2.0/3.0, 1);
NSArray *times = @[[NSValue valueWithCMTime:firstThird], [NSValue valueWithCMTime:secondThird]];
self.playerObserver = [<#A player#> addBoundaryTimeObserverForTimes:times queue:NULL usingBlock:^{
NSString *timeDescription = (NSString *)
CFBridgingRelease(CMTimeCopyDescription(NULL, [self.player currentTime]));
NSLog(@"Passed a boundary at %@", timeDescription);
}];
4)Reaching the End of an Item
可以向通知中心注册 AVPlayerItemDidPlayToEndTimeNotification 通知,当播放结束的时候可以收到通知。
code:
[[NSNotificationCenter defaultCenter] addObserver:<#The observer, typically self#>
selector:@selector(<#The selector name#>)
name:AVPlayerItemDidPlayToEndTimeNotification
object:<#A player item#>];
8. Putting it All Together : Playing a Video File Using AVPlayerLayer
下面的代码向你展示如何使用AVPlayer播放一个video文件,步骤如下:
. 用AVPlayerLayer配置一个view
. 创建一个AVPlayer
. 用video文件创建一个AVPlayerItem对象,并且用kvo观察他的status
. 当收到item的状态变成可播放的时候,播放按钮启用
. 播放,结束之后把播放头设置到起始位置
1) The Player View
为了播放一个视频,需要个view包含AVPlayerLayer layer,AVPlayer 对象能直接在layer上输出视频。可以创建一个子类实现这个需求。
code:
#import <UIKit/UIKit.h>
#import <AVFoundation/AVFoundation.h>
@interface PlayerView : UIView
@property (nonatomic) AVPlayer *player;
@end
@implementation PlayerView
+ (Class)layerClass {
return [AVPlayerLayer class];
}
- (AVPlayer*)player {
return [(AVPlayerLayer *)[self layer] player];
}
- (void)setPlayer:(AVPlayer *)player {
[(AVPlayerLayer *)[self layer] setPlayer:player];
}
@end
2)A Simple View Controller
code:
@class PlayerView;
@interface PlayerViewController : UIViewController
@property (nonatomic) AVPlayer *player;
@property (nonatomic) AVPlayerItem *playerItem;
@property (nonatomic, weak) IBOutlet PlayerView *playerView;
@property (nonatomic, weak) IBOutlet UIButton *playButton;
- (IBAction)loadAssetFromFile:sender;
- (IBAction)play:sender;
- (void)syncUI;
@end
syncUI根据player的status来更新播放按钮状态,
code:
- (void)syncUI {
if ((self.player.currentItem != nil) &&
([self.player.currentItem status] == AVPlayerItemStatusReadyToPlay)) {
self.playButton.enabled = YES;
}
else {
self.playButton.enabled = NO;
}
}
在viewDidLoad里面调用syncUI,确保第一次显示时UI正确。
code:
- (void)viewDidLoad {
[super viewDidLoad];
[self syncUI];
}
3)Creating the Asset
用AVURLAsset通过URL创建asset,code:
- (IBAction)loadAssetFromFile:sender {
NSURL *fileURL = [[NSBundle mainBundle] URLForResource:<#@"VideoFileName"#> withExtension:<#@"extension"#>];
AVURLAsset *asset = [AVURLAsset URLAssetWithURL:fileURL options:nil];
NSString *tracksKey = @"tracks";
[asset loadValuesAsynchronouslyForKeys:@[tracksKey] completionHandler:
^{
// The completion block goes here.
}];
}
在完成的block里面,用asset创建一个AVPlayerItem对象和一个AVPlayer对象,并且把player设为player view的属性。和创建一个asset一样,简单的创建一个player item并不意味着可以马上使用,可以用kvo观察player item 的status来判断是否可以开始播放,这个kvo的设置应该在player item和player关联之前设置。
当把player 和player item 关联起来,会触发player item的准备播放。
code:
// Define this constant for the key-value observation context.
static const NSString *ItemStatusContext;
// Completion handler block.
dispatch_async(dispatch_get_main_queue(),
^{
NSError *error;
AVKeyValueStatus status = [asset statusOfValueForKey:tracksKey error:&error];
if (status == AVKeyValueStatusLoaded) {
self.playerItem = [AVPlayerItem playerItemWithAsset:asset];
// ensure that this is done before the playerItem is associated with the player
[self.playerItem addObserver:self forKeyPath:@"status"
options:NSKeyValueObservingOptionInitial context:&ItemStatusContext];
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(playerItemDidReachEnd:)
name:AVPlayerItemDidPlayToEndTimeNotification
object:self.playerItem];
self.player = [AVPlayer playerWithPlayerItem:self.playerItem];
[self.playerView setPlayer:self.player];
}
else {
// You should deal with the error appropriately.
NSLog(@"The asset's tracks were not loaded:\n%@", [error localizedDescription]);
}
});
4) Responding to the Player Item's Status Change
当player item的status改变时,view controller会收到一个通知消息,AVFoundation并不指定这个消息是由哪个线程发出的。如果你要更新ui,必须确保更新ui的代码在主线程中。
code:
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object
change:(NSDictionary *)change context:(void *)context {
if (context == &ItemStatusContext) {
dispatch_async(dispatch_get_main_queue(),
^{
[self syncUI];
});
return;
}
[super observeValueForKeyPath:keyPath ofObject:object
change:change context:context];
return;
}
5)Playing the Item
- (IBAction)play:sender {
[player play];
}
这样的情况只能播放一次,当播放结束,再次调用play方法是没有效果的。
如果要重新播放,向通知中心注册AVPlayerItemDidPlayToEndTimeNotification消息,当收到播放结束的消息的时候,调用seekToTime:把播放头移动到起始位置,这样再调用play的时候就可以重新播放了。
code:
// Register with the notification center after creating the player item.
[[NSNotificationCenter defaultCenter]
addObserver:self
selector:@selector(playerItemDidReachEnd:)
name:AVPlayerItemDidPlayToEndTimeNotification
object:[self.player currentItem]];
- (void)playerItemDidReachEnd:(NSNotification *)notification {
[self.player seekToTime:kCMTimeZero];
}