[AVFoundation Guide]Playback

本文是本人自己辛苦翻译的，请转载的朋友注明，翻译于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）。

图2-1 Playing an asset

这个抽象类代表你可以根据给定的asset同时播放到不同的播放器中，但是以不同的方式呈现到每一个播放器中。图2-2显示一种可能性，两个不同的播放器播放同样的asset，和不同的设置。使用这个轨道，你可以，例如，播放中禁止一个特定的轨道。（例如，你可能不想播放声音成分）

图2-2 Playing the same asset in different ways

你可以使用一个同样的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);
}];