高级播放器接口说明 - 视频点播

AliyunVodPlayer

类名：AliyunVodPlayer
功能：高级播放器类，用于创建播放器实例。
成员：

成员	功能
AliyunVodPlayer	创建播放器
setOnPreparedListener	设置视频准备结束的监听事件
setOnFirstFrameStartListener	设置首帧开始播放的监听事件
setOnSeekCompleteListener	设置拖动结束监听事件
setOnCompletionListener	设置视频播放结束的监听事件
setOnStoppedListener	设置视频播放停止的监听事件
setOnPcmDataListener	设置视频的音频回调监听事件
setOnLoadingListener	设置视频缓冲状态的监听事件
setOnErrorListener	设置视频出错的监听事件
setOnInfoListener	设置视频信息的监听事件
setOnVideoSizeChangedListener	设置视频大小改变监听事件
setOnChangeQualityListener	设置视频切换清晰度的监听事件
setOnReplayListener	设置视频重播的监听事件
setOnAutoPlayListener	设置视频自动播放的监听事件
setOnCircleStartListener	设置视频循环播放开始事件
setDisplay	设置surfaceHolder
setSurface	设置surface
surfaceChanged	画面改变时调用
prepareAsync	准备视频(异步)
start	开始播放
pause	暂停播放
resume	恢复播放
seekTo	拖动到的时间点
stop	停止播放
reset	重置播放器
release	释放播放器资源
setVolume	设置音量
getVolume	获取当前音量
getVideoWidth	获取视频宽度
getVideoHeight	获取视频高度
getDuration	获取当前视频总时长
getCurrentPosition	获取当前播放位置
isPlaying	判断是否在播放状态
getPlayerState	获取播放器状态
getMediaInfo	获取媒体信息
getCurrentQuality	获取当前视频清晰度
changeQuality	切换播放的清晰度
enableNativeLog	开启native底层日志
disableNativeLog	关闭native底层日志
setThreadExecutorService	设置线程池
setPlayingCache	边下边缓存配置
setPlaySpeed	设置倍速播放速度
setVideoScalingMode	设置视频缩放模式
setAutoPlay	设置自动播放
replay	重播
setNetworkTimeout	设置网络超时时间
setMuteMode	设置静音
getAllDebugInfo	获取调试信息
setScreenBrightness	设置屏幕亮度
getScreenBrightness	获取屏幕亮度
getBufferingPosition	获取缓冲进度
setMaxBufferDuration	设置最大缓冲值
getSDKVersion	获取SDK版本号
snapShot	截图
setCirclePlay	设置循环播放
setRenderMirrorMode	设置镜像模式
setRenderRotate	设置画面旋转
getCurrentLiveTime	获取当前直播时间
getCurrentTime	获取当前播放时间
seekToLiveTime	跳转到某个直播点
setOnTimeShiftUpdaterListener	直播时移时间段更新监听
setOnSeekLiveCompletionListener	直播时移seek结束监听
setOnTimeExpiredErrorListener	请求源过期回调监听
setOnUrlTimeExpiredListener	播放地址即将过期的回调监听
setReferer	设置播放鉴权（黑白名单）

下面详细介绍一下各成员函数的具体使用：

AliyunVodPlayer

public AliyunVodPlayer(Context context)

功能：创建播放器

参数：context 上下文

setOnPreparedListener

public void setOnPreparedListener(OnPreparedListener l)

功能：设置视频准备结束的监听事件

参数：视频准备结束的监听事件，见OnPreparedListener接口

setOnFirstFrameStartListener

public void setOnFirstFrameStartListener(OnFirstFrameStartListener l)

功能：设置首帧开始播放的监听事件

参数：首帧开始播放的监听事件，见OnFirstFrameStartListener接口

setOnSeekCompleteListener

public void setOnSeekCompleteListener(OnSeekCompleteListener l)

功能：设置拖动结束监听事件

参数：拖动结束监听事件，见OnSeekCompleteListener接口

setOnCompletionListener

public void setOnCompletionListener(OnCompletionListener l)

功能：设置视频播放结束的监听事件

参数：视频播放结束监听事件，见OnCompletionListener接口

setOnStoppedListener

public void setOnStoppedListener(OnStoppedListener l)

功能：设置视频播放停止的监听事件

参数：视频播放停止监听事件，见OnStoppedListener接口

setOnPcmDataListener

public void setOnPcmDataListener(OnPcmDataListener l)

功能：设置视频的音频回调监听事件

参数：视频的音频回调监听事件，见OnPcmDataListener接口

setOnLoadingListener

public void setOnLoadingListener(OnLoadingListener l)

功能：设置视频缓冲状态的监听事件

参数：视频缓冲状态的监听事件，见OnLoadingListener接口

setOnErrorListener

public void setOnErrorListener(OnErrorListener l)

功能：设置视频出错的监听事件

参数：视频出错监听事件，见OnErrorListener接口

setOnInfoListener

public void setOnInfoListener(OnInfoListener l)

功能：设置视频信息的监听事件

参数：视频信息监听事件，见OnInfoListener接口

setOnVideoSizeChangedListener

public void setOnVideoSizeChangedListener(OnVideoSizeChangedListener l)

功能：设置视频大小改变监听事件

参数：视频大小改变事件，见OnVideoSizeChangedListener接口

setOnChangeQualityListener

public void setOnChangeQualityListener(OnChangeQualityListener l)

功能：设置视频切换清晰度的监听事件

参数：视频切换清晰度监听事件，见OnChangeQualityListener接口

setOnRePlayListener

public void setOnRePlayListener(OnRePlayListener l)

功能：设置视频重播的监听事件

参数：视频重播监听事件，见OnRePlayListener接口

setOnCircleStartListener

public void setOnCircleStartListener(OnCircleStartListener l)

功能：设置视频循环播放开始的监听事件

参数：视频循环播放开始的监听事件，见OnCircleStartListener接口

setOnAutoPlayListener

public void setOnAutoPlayListener(OnAutoPlayListener l)

功能：设置视频自动播放的监听事件

参数：视频自动播放监听事件，见OnAutoPlayListener接口

setDisplay

public void setDisplay(SurfaceHolder surfaceHolder)

功能：设置surfaceHolder

参数：播放画面的surfaceHolder

setSurface

public void setSurface(Surface surface)

功能：设置surface

参数：播放画面的surface

prepareAsync

public void prepareAsync(AliyunPlayAuth aliyunPlayAuth)

功能：通过AliyunPlayAuth准备视频(异步)

参数：视频的AliyunPlayAuth

prepareAsync

public void prepareAsync(AliyunLocalSource aliyunLocalSource)

功能：通过AliyunLocalSource准备视频(异步)

参数：视频的AliyunLocalSource

prepareAsync

public void prepareAsync(AliyunVidSource aliyunVidSource)

功能：通过AliyunVidSource准备视频(异步)，用于转码服务视频文件播放。

参数：视频的AliyunVidSource

prepareAsync

public void prepareAsync(AliyunVidSts aliyunVidSts)

功能：通过AliyunVidSts准备视频(异步)，用于转码服务视频文件播放。

参数：视频的AliyunVidSts

start

public void start()

功能：开始播放

pause

public void pause()

功能：暂停播放

seekTo

public void seekTo(int ms)

功能：拖动到指定时间点

参数：拖动到的时间点，单位毫秒

resume

public void resume()

功能：恢复播放

stop

public void stop()

功能：停止播放

reset

public void reset()

功能：重置播放器

release

public void release()

功能：释放播放器资源

setVolume

public void setVolume(int volume）

功能：设置音量

参数：volume ，大于0小于100的音量值

getVolume

public int getVolume()

功能：获取当前音量

返回值：当前音量。范围0~100

getVideoWidth

public int getVideoWidth()

功能：获取视频宽度

返回值：当前视频的宽度

getVideoHeight

public int getVideoHeight()

功能：获取视频高度

返回值：当前视频的高度

getDuration

public long getDuration()

功能：获取当前视频总时长

返回值：当前视频总时长

getCurrentPosition

public long getCurrentPosition()

功能：获取当前播放位置

返回值：当前播放位置

isPlaying

public boolean isPlaying()

功能：判断是否在播放状态

返回值：播放器处于播放或暂停时返回true，否则为false

getPlayerState

public PlayerState getPlayerState()

功能：获取播放器状态

返回值：播放器状态。见PlayerState

getMediaInfo

public AliyunMediaInfo getMediaInfo()

功能：获取媒体信息

返回值：媒体信息。见AliyunMediaInfo

getCurrentQuality

public String getCurrentQuality()

功能：获取当前视频清晰度

返回值：当前视频清晰度。见QualityValue类

chageQuality

public void chageQuality(String quality)

功能：切换播放的清晰度

参数：清晰度值，见QualityValue类

chageQuality

public void changeQuality(String quality, AliyunPlayAuth playAuth)

功能：使用新的playAuth切换播放的清晰度

参数：

清晰度值，见QualityValue类
 playAuth : 播放的视频源信息

enableNativeLog

public void enableNativeLog()

功能：开启native底层日志

disableNativeLog

public void disableNativeLog()

功能：关闭native底层日志

setThreadExecutorService

public void setThreadExecutorService(ExecutorService executorService)

功能：设置线程运行的线程池

参数：线程池

setPlayingCache

public void setPlayingCache(boolean enable, String saveDir, int maxDuration, long maxSize)

功能：设置边播边缓存的配置

参数：

 enable：是否可以边播边存。如果为true，则根据后面的几个参数决定是否能够缓存。
 saveDir：缓存的目录（绝对路径）
 maxDuration：能缓存的单个视频最大长度（单位：秒）。如果单个视频超过这个值，就不缓存。
 maxSize：缓存目录的所有缓存文件的总的最大大小（单位：MB）。如果超过则删除最旧文件，如果还是不够，则不缓存。

setPlaySpeed

public void setPlaySpeed(float speed)

功能：设置倍速播放速度

参数：speed：倍速值。范围0.5~2。

setVideoScalingMode

public void setVideoScalingMode(VideoScalingMode scalingMode)

功能：设置视频缩放模式

参数：scalingMode：缩放模式。具体参考VideoScalingMode类。

setAutoPlay

public void setAutoPlay(boolean auto)

功能：设置是否自动播放

参数：

auto：true则自动播放。

replay

public void replay()

功能：重播

setNetworkTimeout

public void setNetworkTimeout(int mstimeout)

功能：设置网络超时时间

参数：

超时时间，单位：ms

setMuteMode

public void setMuteMode(boolean on)

功能：设置静音。

参数：

true为静音。

getAllDebugInfo

public Map<String, String> getAllDebugInfo()

功能：获取所有调试信息

返回值：所有调试信息

setScreenBrightness

public void setScreenBrightness(int brightness)

功能：设置屏幕亮度

参数：亮度值：0~255.

getScreenBrightness

public int getScreenBrightness()

功能：获取屏幕亮度

返回值：亮度值

getBufferingPosition

public int getBufferingPosition()

功能：获取缓冲进度

返回值：当前缓冲位置。

setMaxBufferDuration

public void setMaxBufferDuration(int duration)

功能：设置最大缓冲进度

参数：最大缓冲进度

getSDKVersion

public String getSDKVersion()

功能：获取SDK版本号

snapShot

public Bitmap snapShot()

功能：截取当前视频画面。

返回值：画面bitmap。

setCirclePlay

public void setCirclePlay(boolean isCirclePlay)

功能：设置是否循环播放。true：循环播放开启。播放结束后自动从头开始播放。

setRenderMirrorMode

public void setRenderMirrorMode(VideoMirrorMode mirrorMode)

功能：设置镜像模式。

参数：无：VIDEO_MIRROR_MODE_NONE ；水平翻转： VIDEO_MIRROR_MODE_HORIZONTAL；垂直翻转： VIDEO_MIRROR_MODE_VERTICAL

setRenderRotate

 public void setRenderRotate(VideoRotate rotate)

功能：设置画面旋转

参数： 0°：ROTATE_0；90°： ROTATE_90；180°：ROTATE_180；270°： ROTATE_270

getCurrentLiveTime

public long getCurrentLiveTime()

功能：获取当前直播时间

返回值：当前直播时间。单位毫秒