iOS MPMoviePlayerController 简介

MPMoviePlayerController 简介

在iOS中播放视频可以使用MediaPlayer.framework种的MPMoviePlayerController类来完成，它支持本地视频和网络视频播放。这个类实现了MPMediaPlayback协议，因此具备一般的播放器控制功能，例如播放、暂停、停止等。下面列出了MPMoviePlayerController的常用属性和方法：

属性	说明
@property (nonatomic, copy) NSURL *contentURL	播放媒体URL，这个URL可以是本地路径，也可以是网络路径
@property (nonatomic, readonly) UIView *view	播放器视图，如果要显示视频必须将此视图添加到控制器视图中
@property (nonatomic, readonly) UIView *backgroundView	播放器背景视图
@property (nonatomic, readonly) MPMoviePlaybackState playbackState	媒体播放状态，枚举类型： MPMoviePlaybackStateStopped：停止播放 MPMoviePlaybackStatePlaying：正在播放 MPMoviePlaybackStatePaused：暂停 MPMoviePlaybackStateInterrupted：中断 MPMoviePlaybackStateSeekingForward：向前定位 MPMoviePlaybackStateSeekingBackward：向后定位
@property (nonatomic, readonly) MPMovieLoadState loadState	网络媒体加载状态，枚举类型： MPMovieLoadStateUnknown：位置类型 MPMovieLoadStatePlayable： MPMovieLoadStatePlaythroughOK：这种状态如果shouldAutoPlay为YES将自动播放 MPMovieLoadStateStalled：停滞状态
@property (nonatomic) MPMovieControlStyle controlStyle	控制面板风格，枚举类型： MPMovieControlStyleNone：无控制面板  MPMovieControlStyleEmbedded：嵌入视频风格  MPMovieControlStyleFullscreen：全屏  MPMovieControlStyleDefault：默认风格
@property (nonatomic) MPMovieRepeatMode repeatMode;	重复播放模式，枚举类型: MPMovieRepeatModeNone:不重复，默认值 MPMovieRepeatModeOne:重复播放
@property (nonatomic) BOOL shouldAutoplay	当网络媒体缓存到一定数据时是否自动播放，默认为YES
@property (nonatomic, getter=isFullscreen) BOOL fullscreen	是否全屏展示，默认为NO，注意如果要通过此属性设置全屏必须在视图显示完成后设置，否则无效
@property (nonatomic) MPMovieScalingMode scalingMode	视频缩放填充模式，枚举类型： MPMovieScalingModeNone：不进行任何缩放 MPMovieScalingModeAspectFit：固定缩放比例并且尽量全部展示视频，不会裁切视频 MPMovieScalingModeAspectFill：固定缩放比例并填充满整个视图展示，可能会裁切视频 MPMovieScalingModeFill：不固定缩放比例压缩填充整个视图，视频不会被裁切但是比例失衡
@property (nonatomic, readonly) BOOL readyForDisplay	是否有相关媒体被播放
@property (nonatomic, readonly) MPMovieMediaTypeMask movieMediaTypes	媒体类别，枚举类型： MPMovieMediaTypeMaskNone：未知类型 MPMovieMediaTypeMaskVideo：视频 MPMovieMediaTypeMaskAudio：音频
@property (nonatomic) MPMovieSourceType movieSourceType	媒体源，枚举类型： MPMovieSourceTypeUnknown：未知来源 MPMovieSourceTypeFile：本地文件 MPMovieSourceTypeStreaming：流媒体（直播或点播）
@property (nonatomic, readonly) NSTimeInterval duration	媒体时长，如果未知则返回0
@property (nonatomic, readonly) NSTimeInterval playableDuration	媒体可播放时长，主要用于表示网络媒体已下载视频时长
@property (nonatomic, readonly) CGSize naturalSize	视频实际尺寸，如果未知则返回CGSizeZero
@property (nonatomic) NSTimeInterval initialPlaybackTime	起始播放时间
@property (nonatomic) NSTimeInterval endPlaybackTime	终止播放时间
@property (nonatomic) BOOL allowsAirPlay	是否允许无线播放，默认为YES
@property (nonatomic, readonly, getter=isAirPlayVideoActive) BOOL airPlayVideoActive	当前媒体是否正在通过AirPlay播放
@property(nonatomic, readonly) BOOL isPreparedToPlay	是否准备好播放
@property(nonatomic) NSTimeInterval currentPlaybackTime	当前播放时间，单位：秒
@property(nonatomic) float currentPlaybackRate	当前播放速度，如果暂停则为0，正常速度为1.0，非0数据表示倍率
对象方法	说明
- (instancetype)initWithContentURL:(NSURL *)url	使用指定的URL初始化媒体播放控制器对象
- (void)setFullscreen:(BOOL)fullscreen animated:(BOOL)animated	设置视频全屏，注意如果要通过此方法设置全屏则必须在其视图显示之后设置，否则无效
- (void)requestThumbnailImagesAtTimes:(NSArray *)playbackTimes timeOption:(MPMovieTimeOption)option	获取在指定播放时间的视频缩略图，第一个参数是获取缩略图的时间点数组；第二个参数代表时间点精度，枚举类型： MPMovieTimeOptionNearestKeyFrame：时间点附近 MPMovieTimeOptionExact：准确时间
- (void)cancelAllThumbnailImageRequests	取消所有缩略图获取请求
- (void)prepareToPlay	准备播放，加载视频数据到缓存，当调用play方法时如果没有准备好会自动调用此方法
- (void)play	开始播放
- (void)pause	暂停播放
- (void)stop	停止播放
- (void)beginSeekingForward	向前定位
- (void)beginSeekingBackward	向后定位
- (void)endSeeking	停止快进/快退
通知	说明
MPMoviePlayerScalingModeDidChangeNotification	视频缩放填充模式发生改变
MPMoviePlayerPlaybackDidFinishNotification	媒体播放完成或用户手动退出，具体完成原因可以通过通知userInfo中的key为MPMoviePlayerPlaybackDidFinishReasonUserInfoKey的对象获取
MPMoviePlayerPlaybackStateDidChangeNotification	播放状态改变，可配合playbakcState属性获取具体状态
MPMoviePlayerLoadStateDidChangeNotification	媒体网络加载状态改变
MPMoviePlayerNowPlayingMovieDidChangeNotification	当前播放的媒体内容发生改变
MPMoviePlayerWillEnterFullscreenNotification	将要进入全屏
MPMoviePlayerDidEnterFullscreenNotification	进入全屏后
MPMoviePlayerWillExitFullscreenNotification	将要退出全屏
MPMoviePlayerDidExitFullscreenNotification	退出全屏后
MPMoviePlayerIsAirPlayVideoActiveDidChangeNotification	当媒体开始通过AirPlay播放或者结束AirPlay播放
MPMoviePlayerReadyForDisplayDidChangeNotification	视频显示状态改变
MPMovieMediaTypesAvailableNotification	确定了媒体可用类型后
MPMovieSourceTypeAvailableNotification	确定了媒体来源后
MPMovieDurationAvailableNotification	确定了媒体播放时长后
MPMovieNaturalSizeAvailableNotification	确定了媒体的实际尺寸后
MPMoviePlayerThumbnailImageRequestDidFinishNotification	缩略图请求完成之后
MPMediaPlaybackIsPreparedToPlayDidChangeNotification	做好播放准备后