WoanPlayerInterface接口说明

该interface主要用于播放器的初始化、播放本地(网络)音视频文件和播放控制等工作。该interface目前只支持单实例,在多个实例的情况下会出现不可预知的错误。

截取当前播放的视频中的图片。

  • 原型 - (UIImage *)captureImage
  • 参数
    • 无
  • 返回
    • 从视频中截取的图片。

获取当前视频的播放位置,此方法需在prepareToPlay成功后才能取到值。

  • 原型 - (NSTimeInterval)getCurrentPlaybackTime
  • 参数
    • 无
  • 返回
    • 当前视频播放位置,单位为秒。

获取视频的时长,此方法需在prepareToPlay成功后才能取到值。

  • 原型 - (NSTimeInterval)getDuration
  • 参数
    • 无
  • 返回
    • 视频的时长,单位为秒。

获取播放视图。

  • 原型 - (UIView *)getPlayViewWithFrame:(CGRect)frame
  • 参数
    • frame 播放视图的窗口位置大小
  • 返回
    • 播放视图。

获取当前视频播放状态，参考VideoPlayState。

  • 原型 - (VideoPlayState)getVideoPlayState
  • 参数
    • 无
  • 返回
    • 当前视频播放状态。

获取当前播放器SDK版本号。

  • 原型 + (NSString *)getWoanPlayerLibVersion
  • 参数
    • 无
  • 返回
    • 当前播放器SDK版本号。

初始化播放器实例，在SDK版本为4.0 build 2增加parameters参数, 在4.0.8版本将parameters参数从NSMutableDictionary类型改为NSArray类型。

  • 原型 - (id)initWithContentString:(NSString *)contentString parameters:(NSArray *)paras

  • 参数

    • contentString 视频播放地址
    • paras 播放参数数组，一般情况下传nil即可

    现在支持的可选参数有

    • -probesize, 代表探测视频格式所需字节数(默认值为5000)，一般情况下无需设置此值，只有在播放网络直播流,并且视频画面较大（如720p）时出现不能正常播放，有声音无画面时，可以适当增加此值，例如设置probesize的值为20000则paras数组里面增加两个元素@"-probesize","20000"即可,注意顺序不能颠倒。
    • -realtime, 表示实时播放模式，与在contentString前面添加live_效果一样，
  • 返回
    • 播放器实例。

查询播放器是否为静音状态。

  • 原型 - (BOOL)isMute
  • 参数
    • 无
  • 返回
    • TRUE 为静音，FALSE反之。

暂停播放视频,播放直播视频时不能暂停播放。

  • 原型 - (void)pause
  • 参数
    • 无
  • 返回
    • 无。

开始播放视频。

  • 原型 - (void)play
  • 参数
    • 无
  • 返回
    • 无。

初始化播放器,成功初始化后,才可取到Duration等参数。

  • 原型 - (void)prepareToPlay
  • 参数
    • 无
  • 返回
    • 无。

改变当前视频的播放位置，播放直播视频或播放已结束时无法进行播放跳转操作。

  • 原型 - (void)seekTo:(NSTimeInterval)newPos
  • 参数
    • newPos 新的播放位置,单位为秒
  • 返回
    • 无。

设置初始化播放器成功后,是否自动播放视频。此方法要在prepareToPlay方法之前调用才生效。

  • 原型 - (void)setShouldAutoPlay:(BOOL)shouldAutoPlay
  • 参数
    • shouldAutoPlay YES为自动播放,设置成NO时需在调用prepareToPlay成功初始化播放器后手动调用play方法进行播放。默认为 YES
  • 返回
    • 无。

停止播放视频。

  • 原型 - (void)stop
  • 参数
    • 无
  • 返回
    • 无。

开关静音，通过isMute查询是否为静音状态。

  • 原型 - (void)toggleMute:(BOOL)muteOn
  • 参数
    • muteOn true为静音，false为非静音，默认为非静音
  • 返回
    • 无。