本文是本人自己辛苦翻译的,请转载的朋友注明,翻译于Z.MJun的简书 ,感谢!<翻译不容易啊>
翻译于2016年9月6日
控制assets的播放,可以使用AVPlayer
对象。在播放中,你可以使用AVPlayerItem实例来管理整个过程的asset的演示状态。和AVPlayerItemTrack对象管理轨道的演示状态。显示视频,你可以使用AVPlayerLayer对象。
播放Assets
播放器是一个控制器对象来管理Assets播放,如开始和停止播放,和播放一个指定的时间。你可以使用AVPlayer来播放单个Assets。你可以使用 AVQueuePlayer对象来按顺序播放列表(AVQueuePlayer
父类是AVPlayer
)。在OS X上你可以使用AVKit framework’s AVPlayerView
类,把内容播放到一个界面内。
播放器为你提供了关于播放的信息。如果你需要,你可以根据播放状态同步你的用户界面。你通常会直接播放器到一个专门的核心动画层。(AVPlayerLayer或者AVSynchronizedLayer)。如果想学习更多的关于layers,请看Core Animation Programming Guide
多播放器层:你可以使用AVPlayerLayer对象创建单个AVPlayer ,
但是只有最近创建的才能显示视频内容。
虽然最终你想播放一个asset,你不直接提供assets到AVPlayer对象上。换而言之,你提供AVPlayerItem实例。一个播放器管理一个asset相关的延时状态。一个播放器包含播放器轨道--AVPlayerItemTrack实例--在asset对应的轨迹。图2中这些类的关系(图2)。
这个抽象类代表你可以根据给定的asset同时播放到不同的播放器中,但是以不同的方式呈现到每一个播放器中。图2-2显示一种可能性,两个不同的播放器播放同样的asset,和不同的设置。使用这个轨道,你可以,例如,播放中禁止一个特定的轨道。(例如,你可能不想播放声音成分)
你可以使用一个同样的asset初始化一个播放器,或者你可以通过URL直接初始化一个播放器,以至于你可以在一个特定的位置播放资源。 (AVPlayerItem
将会创建和为资源配置asset)。和AVAsset,虽然,简单的初始化一个播放器不代表马上就能播放。你可以观察(使用KVO)这个item的状态属性来决定准备播放。
处理不同类型的Asset
为播放配置一个asset取决于你想播放的那种asset。一般的说,主要有两个方式:基于文件的assets,可以随时存取(如本地文件,摄像头,或者媒体库。)和基于流的assets(Http 直播流格式)
加载和播放一个基于文件asset。以下步骤播放:
- 使用AVURLAsset创建asset
- 使用asset创建
AVPlayerItem
- 联合
AVPlayer
播放这个item - 等待,直到item的状态可以准备播放(通常当状态变化后使用KVO来接受通知)
这个方法的例子Putting It All Together: Playing a Video File Using AVPlayerLayer
创建和准备播放HTTP直播流。使用URL初始化AVPlayerItem
(不能直接创建AVAsset
,来表示HTTP直播流媒体)
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];
当播放器联合播放item,开始变成准备播放。当准备播放,播放item创建AVAsset
和AVAssetTrack
实例,你可以检查直播流内容。
获取流tiem的播放时间,你可以在播放器item上观察duration
属性。当item准备播放的时候,这个属性会因为流而更新当前值。
Note使用duration
属性,需要在ios4.3及以上。
一个方法来兼容IOS所有版本设计观察播放器item状态属性。当这个状态变成AVPlayerItemStatusReadyToPlay,duration用下面的代码行:
[[[[[playerItem tracks] objectAtIndex:0] assetTrack] asset] duration];
如果你是想简单的播放直播流,你可以使用一个快捷方式和创建一个播放器直接使用URL,更具以下代码
self.player = [AVPlayer playerWithURL:<#Live stream URL#>];
[player addObserver:self forKeyPath:@"status" options:0 context:&PlayerStatusContext];
使用assets和item,初始化播放时不代表准备播放。你应该观察播放器的状态属性,当状态属性变成 AVPlayerStatusReadyToPlay才可以准备播放。你也可以观察当前的对象属性可以访问播放器item创建流。
如果你不懂有哪些URL,根据这个步骤
1.尝试使用URL创建AVURLAsset
,加载轨道
key,如果轨道加载成功,就可以通过asset创建播放器item。
2.如果1.失败了,直接使用URL创建AVPlayerItem
,并观察播放器的状态属性来决定是否可以播放。
如果无论哪个轨道成功了,你结束了一个播放器item联合播放器。
播放item
开始播放,你发送一个播放信息到播放器
- (IBAction)play:sender {
[player play];
}
另外简单的播放,你可以管理各种的播放,如播放速率,和移动播放头位置。你也可以检测播放器播放状态。如果你需要这是很有帮忙,例如,检测asset演示状态同步更新用户界面--Monitoring Playback。
修改播放速率
你可以通过设置播放器的速率属性修改播放速率
aPlayer.rate = 0.5;
aPlayer.rate = 2.0;
1.0的值意味着“当前的item使用着正常的速率播放”。设置速率为0.0等于停止播放--你也可以使用pause
。
item也支持逆向播放,可以使用播放速率属性和设置负数来设置速率。你决定这个类型逆向播放可以使用播放器item属性canPlayReverse(支持-1.0速率),canPlaySlowReverse(支持播放0.0~1.0之间的速率)和canPlayFastReverse(支持播放速率低于-1.0)
移动播放头
移动播放头播放指定时间,你可以查看seekToTime:,如
CMTime fiveSecondsIn = CMTimeMake(5, 1);
[player seekToTime:fiveSecondsIn];
seekToTime
方法,但是,调整性能多于精确,如果你需要移动更精确的播放头,你可以使用seekToTime:toleranceBefore:toleranceAfter:
做代替。如:
CMTime fiveSecondsIn = CMTimeMake(5, 1);
[player seekToTime:fiveSecondsIn toleranceBefore:kCMTimeZero toleranceAfter:kCMTimeZero];
使用0公差可能需要框架来解码大量的数据。如果只是你,你应该使用0。如,编写一个复杂的媒体编辑应用程序,需要有精确地控制。
在播放之后,这个播放头会设到最后,和进一步相应play
会没有反应。设置播放头回到开始部分,你可以重新注册接收AVPlayerItemDidPlayToEndTimeNotification 通知。在这个通知回调方法中,你借助seekToTime :
设置参数为kCMTimeZero
。
// 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];
}
播放多个项目
你可以使用AVQueuePlayer对象来播放媒体列表,这个AVQueuePlayer
类的父类是AVPlayer
。初始化一个队列播放器,和使用一个组的媒体内容。
NSArray *items = <#An array of player items#>;
AVQueuePlayer *queuePlayer = [[AVQueuePlayer alloc] initWithItems:items];
你可以使用play
开播放队列,正如你使用AVPlayer
对象。队列播放器依次播放每个内容。如果你想调到下一个内容,你可以想队列发送advanceToNextItem信息。
使用insertItem:afterItem:removeItem:,removeAllItems
来修改队列。当增加一个新的内容,你应该通常测试是否可以加入到队列里。使用canInsertItem:afterItem:
你可以在第二个参数位置传nil
来测试新的内容是否被计入队列里。
AVPlayerItem *anItem = <#Get a player item#>;
if ([queuePlayer canInsertItem:anItem afterItem:nil]) {
[queuePlayer insertItem:anItem afterItem:nil];
}
检测播放
你可以检测多个方面内容,播放器的演示状态和正在播放的内容。尤其是状态的变化,不在你的控制之下。如:
- 如果用户使用多任务来转换不同的应用,播放器的速率属性将会调到0.0。
- 如果你播放远程媒体,播放器item的loadedTimeRanges和seekableTimeRanges属性,将会改变大量的数值以至于可用。
这些属性告诉你,播放器的时间轴哪部分可用。 - 播放器的当前内容属性,改变一个播放内容将会由HTTP直播流创建。
- 播放器的内容轨道属性,在播放HTTP直播流期间,可能改变。
这可能发生在,流内容提供不同的编码;如果播放器改变不通的编码,轨道改变。 - 如果播放失败,播放器或者播放器内容的状态属性可能改变
你可以使用KVO来检测这些属性值的改变情况。
Important:你应该在主线程上,注册或者注销KVO变化通知。这个避免在其他现线程上接收到通知。AV Foundation在主线程上调用observeValueForKeyPath:ofObject:change:context: ,尽管有些操作变化在其他线程上。
响应一个状态变化
当播放器或者播放对象变化,它会发出一个KVO变化通知。如果一个对象因为某些原因不能播放(例如,如果媒体服务被重置),这个状态就会适当的变成AVPlayerStatusFailed
或者AVPlayerItemStatusFailed
。在这种情况下,这个对象的错误属性就会变成一个错误对象来描述将会不能播放。
AV Foundation并没有指定哪个线程发出通知。如果你想更新用户的界面,你必须确定相关的代码是在主线程上工作。例如使用dispatch_async
在主线程上执行代码。
- (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;
}
视觉显示跟踪准备
你可以观察AVPlayerLayer
对象的readyForDisplay属性来通知,当这个层有用显示内容。特别的,仅当有些内容用户看和执行一个过渡,你可以插入播放器层到这个层的结构树中。
跟踪时间
你可以使用addPeriodicTimeObserverForInterval:queue:usingBlock:
或者addBoundaryTimeObserverForTimes:queue:usingBlock:.
来跟踪AVPlayer
对象的播放头位置。你可以这么做,例如,根据播放完毕或者剩余时间或者执行一些同步其他用界面,来更新你的用户界面。
- addPeriodicTimeObserverForInterval:queue:usingBlock:,block为你提供了调用指定间隔。如果时间跳转,和当播放开始或者结束。
-
addBoundaryTimeObserverForTimes:queue:usingBlock:,你可以使用一组
CMTime
数据结构包含NSValue
对象。这个block你给予调用每当这些时间被遍历。
这两个方法返回不透明的观察者对象,你必须位返回的对象保持强引用,直到你想这个时间观察block被播放器调用。你必须平衡每个调用的方法,一个相关的调用removeTimeObserver:。
根据这些方法,AV Foundation不能保证你调用的block在每一个时间间隔或者边界执行。如果你之前调用的block没有执行完毕,AV Foundation是不会调用block。你必须确定,在这个期间,这个工作你执行的block不会太消耗系统。
// 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);
}];