码迷,mamicode.com
首页 > 其他好文 > 详细

MPMovieplayController

时间:2015-07-29 12:10:51      阅读:188      评论:0      收藏:0      [点我收藏+]

标签:

一、概述

  在iOS中播放视频可以使用MediaPlayer.framework中的MPMoviePlayerController类来完成,它支持本地视频和网络视频播放。这个类实现了MPMediaPlayback协议,因此具备一般的播放器控制功能,例如播放、暂停、停止等。但是MPMoviePlayerController自身并不是一个完整的视图控制器,如果要在UI中展示视频则需要将view属性添加到界面中

 

二、属性和方法

  1.属性

    a)@property (nonatomic, copy) NSURL *contentURL

    //  播放媒体URL,这个URL可以是本地路径,也可以是网络路径

    b)@property (nonatomic, readonly) UIView *view

    //  播放器视图,如果要显示视频必须将此视图添加视图控制器中

    c)@property (nonatomic, readonly) UIView *backgroundView

    //  播放器背景视图

    d)@property (nonatomic, readonly) MPMoviePlaybackState playbackState

    //  媒体播放状态,枚举类型:
        MPMoviePlaybackStateStopped:停止播放
        MPMoviePlaybackStatePlaying:正在播放
        MPMoviePlaybackStatePaused:暂停
        MPMoviePlaybackStateInterrupted:中断
        MPMoviePlaybackStateSeekingForward:向前定位
        MPMoviePlaybackStateSeekingBackward:向后定位

    e)@property (nonatomic, readonly) MPMovieLoadState loadState

    //  网络媒体加载状态,枚举类型:
        MPMovieLoadStateUnknown:位置类型
        MPMovieLoadStatePlayable:
        MPMovieLoadStatePlaythroughOK:这种状态如果shouldAutoPlay为YES将自动播放
        MPMovieLoadStateStalled:停滞状态

    f)@property (nonatomic) MPMovieControlStyle controlStyle

    //  控制面板风格,枚举类型:
        MPMovieControlStyleNone:无控制面板 
        MPMovieControlStyleEmbedded:嵌入视频风格 
        MPMovieControlStyleFullscreen:全屏 
        MPMovieControlStyleDefault:默认风格

    g)@property (nonatomic) MPMovieRepeatMode repeatMode

    //  重复播放模式,枚举类型:
        MPMovieRepeatModeNone:不重复,默认值
        MPMovieRepeatModeOne:重复播放

    h)@property (nonatomic) BOOL shouldAutoplay

    //  当网络媒体缓存到一定数据时是否自动播放,默认为YES

    i)@property (nonatomic, getter=isFullscreen) BOOL fullscreen

    //  是否全屏展示,默认为NO,注意如果要通过此属性设置全屏必须在视图显示完成后设置,否则无效

    j)@property (nonatomic) MPMovieScalingMode scalingMode

    //  视频缩放填充模式,枚举类型:
        MPMovieScalingModeNone:不进行任何缩放
        MPMovieScalingModeAspectFit:固定缩放比例并且尽量全部展示视频,不会裁切视频
        MPMovieScalingModeAspectFill:固定缩放比例并填充满整个视图展示,可能会裁切视频
        MPMovieScalingModeFill:不固定缩放比例压缩填充整个视图,视频不会被裁切但是比例失衡

    k)@property (nonatomic, readonly) BOOL readyForDisplay

    //  是否有相关媒体被播放

    l)@property (nonatomic, readonly) MPMovieMediaTypeMask movieMediaTypes

    //  媒体类别,枚举类型:
        MPMovieMediaTypeMaskNone:未知类型
        MPMovieMediaTypeMaskVideo:视频
        MPMovieMediaTypeMaskAudio:音频

    m)@property (nonatomic) MPMovieSourceType movieSourceType

    //  媒体源,枚举类型:
        MPMovieSourceTypeUnknown:未知来源
        MPMovieSourceTypeFile:本地文件
        MPMovieSourceTypeStreaming:流媒体(直播或点播)

    n)@property (nonatomic, readonly) NSTimeInterval duration

    //  媒体时长,如果未知则返回0

    o)@property (nonatomic, readonly) NSTimeInterval playableDuration

    //  媒体可播放时长,主要用于表示网络媒体已下载视频时长

    p)@property (nonatomic, readonly) CGSize naturalSize

    //  视频实际尺寸,如果未知则返回CGSizeZero

    q)@property (nonatomic) NSTimeInterval initialPlaybackTime

    //  起始播放时间

    r)@property (nonatomic) NSTimeInterval endPlaybackTime

    //  终止播放时间

    s)@property (nonatomic) BOOL allowsAirPlay

    //  是否允许无线播放,默认为YES

    t)@property (nonatomic, readonly, getter=isAirPlayVideoActive) BOOL airPlayVideoActive

    //  当前媒体是否正在通过AirPlay播放

    u)@property(nonatomic, readonly) BOOL isPreparedToPlay

    //  是否准备好播放

    v)@property(nonatomic) NSTimeInterval currentPlaybackTime

    //  当前播放时间,单位:秒

    w)@property(nonatomic) float currentPlaybackRate

    //  当前播放速度,如果暂停则为0,正常速度为1.0,非0数据表示倍率

    

  2.实例方法

    a)- (instancetype)initWithContentURL:(NSURL *)url

    //  使用指定的URL初始化媒体播放控制器对象

    b)- (void)setFullscreen:(BOOL)fullscreen animated:(BOOL)animated

    //  设置视频全屏,注意如果要通过此方法设置全屏则必须在其视图显示之后设置,否则无效

    c)- (void)requestThumbnailImagesAtTimes:(NSArray *)playbackTimes timeOption:(MPMovieTimeOption)option

    //  获取在指定播放时间的视频缩略图,第一个参数是获取缩略图的时间点数组;

      第二个参数代表时间点精度,枚举类型:
        MPMovieTimeOptionNearestKeyFrame:时间点附近
        MPMovieTimeOptionExact:准确时间

    d)- (void)cancelAllThumbnailImageRequests

    //  取消所有缩略图获取请求

    e)- (void)prepareToPlay

    //  准备播放,加载视频数据到缓存,当调用play方法时如果没有准备好会自动调用此方法

    f)- (void)play

    //  开始播放

    g)- (void)pause

    //  暂停播放

    h)- (void)stop  

    //  停止播放

    i)- (void)beginSeekingForward

    //  向前定位

    j)- (void)beginSeekingBackward

    //  向后定位

    k)- (void)endSeeking

    //  停止快进/快退

 

  3.通知

    a)MPMoviePlayerScalingModeDidChangeNotification

    //  视频缩放填充模式发生改变

    b)MPMoviePlayerPlaybackDidFinishNotification

    //  媒体播放完成或用户手动退出,具体完成原因可以通过通知userInfo中的key为MPMoviePlayerPlaybackDidFinishReasonUserInfoKey的对象获取

    c)MPMoviePlayerPlaybackStateDidChangeNotification

    //  播放状态改变,可配合playbakcState属性获取具体状态

    d)MPMoviePlayerLoadStateDidChangeNotification

    //  媒体网络加载状态改变

    e)MPMoviePlayerNowPlayingMovieDidChangeNotification

    //  当前播放的媒体内容发生改变

    f)MPMoviePlayerWillEnterFullscreenNotification

    //  将要进入全屏

    g)MPMoviePlayerDidEnterFullscreenNotification

    //  进入全屏后

    h)MPMoviePlayerWillExitFullscreenNotification    

    //  将要退出全屏

    i)MPMoviePlayerDidExitFullscreenNotification

    //  退出全屏后

    j)MPMoviePlayerIsAirPlayVideoActiveDidChangeNotification

    //  当媒体开始通过AirPlay播放或者结束AirPlay播放

    k)MPMoviePlayerReadyForDisplayDidChangeNotification

    //  视频显示状态改变

    l)MPMovieMediaTypesAvailableNotification

    //  确定了媒体可用类型后

    m)MPMovieSourceTypeAvailableNotification

    //  确定了媒体来源后

    n)MPMovieDurationAvailableNotification

    //  确定了媒体播放时长后

    o)MPMovieNaturalSizeAvailableNotification

    //  确定了媒体的实际尺寸后

    p)MPMoviePlayerThumbnailImageRequestDidFinishNotification

    //  缩略图请求完成之后

    q)MPMediaPlaybackIsPreparedToPlayDidChangeNotification

    //  做好播放准备后

 

三、使用

 

  MPMediaPlayerController的状态等信息并不是通过代理来和外界交互的,而是通过通知中心,因此从上面的列表中可以看到常用的一些通知。由于MPMoviePlayerController本身对于媒体播放做了深度的封装,使用起来就相当简单:创建MPMoviePlayerController对象,设置frame属性,将MPMoviePlayerController的view添加到控制器视图中

    

//
//  ViewController.m
//  MPMoviePlayerController
//
//  Created by Kenshin Cui on 14/03/30.
//  Copyright (c) 2014年 cmjstudio. All rights reserved.
//

#import "ViewController.h"
#import <MediaPlayer/MediaPlayer.h>

@interface ViewController ()

@property (nonatomic,strong) MPMoviePlayerController *moviePlayer;//视频播放控制器

@end

@implementation ViewController

#pragma mark - 控制器视图方法
- (void)viewDidLoad {
    [super viewDidLoad];
    
    //播放
    [self.moviePlayer play];
    
    //添加通知
    [self addNotification];
    
}

-(void)dealloc{
    //移除所有通知监控
    [[NSNotificationCenter defaultCenter] removeObserver:self];
}


#pragma mark - 私有方法
/**
 *  取得本地文件路径
 *
 *  @return 文件路径
 */
-(NSURL *)getFileUrl{
    NSString *urlStr=[[NSBundle mainBundle] pathForResource:@"The New Look of OS X Yosemite.mp4" ofType:nil];
    NSURL *url=[NSURL fileURLWithPath:urlStr];
    return url;
}

/**
 *  取得网络文件路径
 *
 *  @return 文件路径
 */
-(NSURL *)getNetworkUrl{
    NSString *urlStr=@"http://192.168.1.161/The New Look of OS X Yosemite.mp4";
    urlStr=[urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    NSURL *url=[NSURL URLWithString:urlStr];
    return url;
}

/**
 *  创建媒体播放控制器
 *
 *  @return 媒体播放控制器
 */
-(MPMoviePlayerController *)moviePlayer{
    if (!_moviePlayer) {
        NSURL *url=[self getNetworkUrl];
        _moviePlayer=[[MPMoviePlayerController alloc]initWithContentURL:url];
        _moviePlayer.view.frame=self.view.bounds;
        _moviePlayer.view.autoresizingMask=UIViewAutoresizingFlexibleWidth|UIViewAutoresizingFlexibleHeight;
        [self.view addSubview:_moviePlayer.view];
    }
    return _moviePlayer;
}

/**
 *  添加通知监控媒体播放控制器状态
 */
-(void)addNotification{
    NSNotificationCenter *notificationCenter=[NSNotificationCenter defaultCenter];
    [notificationCenter addObserver:self selector:@selector(mediaPlayerPlaybackStateChange:) name:MPMoviePlayerPlaybackStateDidChangeNotification object:self.moviePlayer];
    [notificationCenter addObserver:self selector:@selector(mediaPlayerPlaybackFinished:) name:MPMoviePlayerPlaybackDidFinishNotification object:self.moviePlayer];
    
}

/**
 *  播放状态改变,注意播放完成时的状态是暂停
 *
 *  @param notification 通知对象
 */
-(void)mediaPlayerPlaybackStateChange:(NSNotification *)notification{
    switch (self.moviePlayer.playbackState) {
        case MPMoviePlaybackStatePlaying:
            NSLog(@"正在播放...");
            break;
        case MPMoviePlaybackStatePaused:
            NSLog(@"暂停播放.");
            break;
        case MPMoviePlaybackStateStopped:
            NSLog(@"停止播放.");
            break;
        default:
            NSLog(@"播放状态:%li",self.moviePlayer.playbackState);
            break;
    }
}

/**
 *  播放完成
 *
 *  @param notification 通知对象
 */
-(void)mediaPlayerPlaybackFinished:(NSNotification *)notification{
    NSLog(@"播放完成.%li",self.moviePlayer.playbackState);
}


@end

 

运行效果:

技术分享

 

 

  从上面的API大家也不难看出其实MPMoviePlayerController功能相当强大,日常开发中作为一般的媒体播放器也完全没有问题。MPMoviePlayerController除了一般的视频播放和控制外还有一些强大的功能,例如截取视频缩略图。请求视频缩略图时只要调用- (void)requestThumbnailImagesAtTimes:(NSArray *)playbackTimes timeOption:(MPMovieTimeOption)option方法指定获得缩略图的时间点,然后监控MPMoviePlayerThumbnailImageRequestDidFinishNotification通知,每个时间点的缩略图请求完成就会调用通知,在通知调用方法中可以通过MPMoviePlayerThumbnailImageKey获得UIImage对象处理即可。例如下面的程序演示了在程序启动后获得两个时间点的缩略图的过程,截图成功后保存到相册:

//
//  ViewController.m
//  MPMoviePlayerController
//
//  Created by Kenshin Cui on 14/03/30.
//  Copyright (c) 2014年 cmjstudio. All rights reserved.
//  视频截图

#import "ViewController.h"
#import <MediaPlayer/MediaPlayer.h>

@interface ViewController ()

@property (nonatomic,strong) MPMoviePlayerController *moviePlayer;//视频播放控制器

@end

@implementation ViewController

#pragma mark - 控制器视图方法
- (void)viewDidLoad {
    [super viewDidLoad];
    
    //播放
    [self.moviePlayer play];
    
    //添加通知
    [self addNotification];
    
    //获取缩略图
    [self thumbnailImageRequest];
}

-(void)dealloc{
    //移除所有通知监控
    [[NSNotificationCenter defaultCenter] removeObserver:self];
}


#pragma mark - 私有方法
/**
 *  取得本地文件路径
 *
 *  @return 文件路径
 */
-(NSURL *)getFileUrl{
    NSString *urlStr=[[NSBundle mainBundle] pathForResource:@"The New Look of OS X Yosemite.mp4" ofType:nil];
    NSURL *url=[NSURL fileURLWithPath:urlStr];
    return url;
}

/**
 *  取得网络文件路径
 *
 *  @return 文件路径
 */
-(NSURL *)getNetworkUrl{
    NSString *urlStr=@"http://192.168.1.161/The New Look of OS X Yosemite.mp4";
    urlStr=[urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    NSURL *url=[NSURL URLWithString:urlStr];
    return url;
}

/**
 *  创建媒体播放控制器
 *
 *  @return 媒体播放控制器
 */
-(MPMoviePlayerController *)moviePlayer{
    if (!_moviePlayer) {
        NSURL *url=[self getNetworkUrl];
        _moviePlayer=[[MPMoviePlayerController alloc]initWithContentURL:url];
        _moviePlayer.view.frame=self.view.bounds;
        _moviePlayer.view.autoresizingMask=UIViewAutoresizingFlexibleWidth|UIViewAutoresizingFlexibleHeight;
        [self.view addSubview:_moviePlayer.view];
    }
    return _moviePlayer;
}

/**
 *  获取视频缩略图
 */
-(void)thumbnailImageRequest{
    //获取13.0s、21.5s的缩略图
    [self.moviePlayer requestThumbnailImagesAtTimes:@[@13.0,@21.5] timeOption:MPMovieTimeOptionNearestKeyFrame];
}

#pragma mark - 控制器通知
/**
 *  添加通知监控媒体播放控制器状态
 */
-(void)addNotification{
    NSNotificationCenter *notificationCenter=[NSNotificationCenter defaultCenter];
    [notificationCenter addObserver:self selector:@selector(mediaPlayerPlaybackStateChange:) name:MPMoviePlayerPlaybackStateDidChangeNotification object:self.moviePlayer];
    [notificationCenter addObserver:self selector:@selector(mediaPlayerPlaybackFinished:) name:MPMoviePlayerPlaybackDidFinishNotification object:self.moviePlayer];
    [notificationCenter addObserver:self selector:@selector(mediaPlayerThumbnailRequestFinished:) name:MPMoviePlayerThumbnailImageRequestDidFinishNotification object:self.moviePlayer];
    
}

/**
 *  播放状态改变,注意播放完成时的状态是暂停
 *
 *  @param notification 通知对象
 */
-(void)mediaPlayerPlaybackStateChange:(NSNotification *)notification{
    switch (self.moviePlayer.playbackState) {
        case MPMoviePlaybackStatePlaying:
            NSLog(@"正在播放...");
            break;
        case MPMoviePlaybackStatePaused:
            NSLog(@"暂停播放.");
            break;
        case MPMoviePlaybackStateStopped:
            NSLog(@"停止播放.");
            break;
        default:
            NSLog(@"播放状态:%li",self.moviePlayer.playbackState);
            break;
    }
}

/**
 *  播放完成
 *
 *  @param notification 通知对象
 */
-(void)mediaPlayerPlaybackFinished:(NSNotification *)notification{
    NSLog(@"播放完成.%li",self.moviePlayer.playbackState);
}

/**
 *  缩略图请求完成,此方法每次截图成功都会调用一次
 *
 *  @param notification 通知对象
 */
-(void)mediaPlayerThumbnailRequestFinished:(NSNotification *)notification{
    NSLog(@"视频截图完成.");
    UIImage *image=notification.userInfo[MPMoviePlayerThumbnailImageKey];
    //保存图片到相册(首次调用会请求用户获得访问相册权限)
    UIImageWriteToSavedPhotosAlbum(image, nil, nil, nil);
}

@end

截图效果:

技术分享     技术分享

MPMovieplayController

标签:

原文地址:http://www.cnblogs.com/songshuhaoNB/p/4685351.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!