学习笔记- AVFoundation Programming Guide - Playback

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];
}
















评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值