Android播放器SDK说明__SDK文档及下载_API及SDK_视频直播-阿里云

private class VideoPrepareListener implements AliVcMediaPlayer.MediaPlayerPreparedListener{   
    @Override
    public void onPrepared() {
       //更新视频总进度
    } }

四、错误事件通知中：

private class VideoErrorListener implements AliVcMediaPlayer.MediaPlayerErrorListener {
    public void onError(int what, int extra) {
        switch(what)
        {
        case MediaPlayer.ALIVC_ERR_ILLEGALSTATUS:
            // 非法状态！
            break;
        case MediaPlayer.ALIVC_ERR_NO_NETWORK:
            //report_error("视频资源或网络不可用！", true);
            break;
        case MediaPlayer.ALIVC_ERR_INVALID_INPUTFILE:
            //视频资源或网络不可用！
            break;
        case MediaPlayer.ALIVC_ERR_NO_SUPPORT_CODEC:
            //无支持的解码器!
            break;
       case MediaPlayer.ALIVC_ERR_FUNCTION_DENY:
            //无此操作权限!
            break;
       case MediaPlayer.ALIVC_ERR_UNKNOWN:
            //未知错误!
            break;
       case MediaPlayer.ALIVC_ERR_NOTAUTH:
            //未鉴权!
            break;
       case MediaPlayer.ALIVC_ERR_READD:
            //资源访问失败!
            break;
        default:
            //播放器错误!
            break;
        }
    }
}

五、播放信息事件通知中：

private class VideoInfolistener implements AliVcMediaPlayer.MediaPlayerInfoListener {
    public int onInfo(int what, int extra){
        switch (what)
        {
        case MediaPlayer.MEDIA_INFO_UNKNOW:
             // 未知
             break;
        case MediaPlayer.MEDIA_INFO_BUFFERING_START: 
            // 开始缓冲
            break;
        case MediaPlayer.MEDIA_INFO_BUFFERING_END: 
             // 结束缓冲
            break;
        case MediaPlayer.MEDIA_INFO_VIDEO_RENDERING_START:
            // 首帧显示时间
            break;
        }
        return 0;
    }
}

播放器可配置参数与可选功能

seek功能

除了上述可配置的功能和参数，AlivcMediaPlayer还定义了播放器的事件状态通知和错误代码，以方便开发者掌握播放器的运行状态。

若需要了解上述功能和接口的详细用法，请参照下节的接口说明。

接口说明

SDK中提供了两个类AliVcMediaPlayer和AliVcMediaPlayerFactory，其中AliVcMediaPlayer是播放器SDK使用类，AliVcMediaPlayerFactory用来创建播放器AliVcMediaPlayer。同时我们还提供了多个事件通知接口，用来监听播放器的各种状态。

AliVcMediaPlayerFactory

类名：AliVcMediaPlayerFactory

功能：创建媒体播放器接口类 MediaPlayer

成员：

详细说明：

MediaPlayer createPlayer(Context context,int decoder_type, String path)

createPlayer用来创建播放器，返回MediaPlayer类。

参数:

• path：播放器文件路径，本地或者网络地址。

返回值：返回空为错误，正确则为有效的MediaPlayer值。

MediaPlayer

类名：MediaPlayer

功能：媒体播放器接口类，提供播放控制

成员：

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

init

 public static void init(Context context, String
businessId, AccessKeyCallback callback);

功能：初始化播放器

参数：

context: Android 上下文；

callback：AccessKey 的回调函数；

businesssId：业务ID，用户自行设置，用于标识使用播放器sdk的APP。如“淘宝直播”就设置“TaobaoLive”。

prepareToPlay

public void prepareToPlay(String url);

功能：根据视频文件内容初始化播放器实例，包括读取视频头，解析视频和音频信息，并根据视频和音频信息初始化解码器，创建下载（或读取本地文件）、解码、渲染线程等。

参数：

url：当前播放视频的文件名或网络地址。

play

public void play();

功能：播放当前视频。

pause

public void pause();

功能：暂停视频播放。

stop

public void stop();

功能：停止视频播放。

destroy

public void destroy();

功能：回收播放器。

备注：当整个播放器退出时调用，回收播放器。

reset

public void reset();

功能：重置播放器。当播放的过程中调用该函数，会先停止当前的播放行为，销毁当前的播放器，然后创建一个新的播放器。

seekTo

public void seekTo(int msc);

功能：跳转到指定位置前的第一个关键帧的位置。

参数：msc：跳转的位置，单位为毫秒。

备注：该函数仅允许在点播或播放本地视频过程中调用（直播禁用）。调用后视频会跳转到指定位置前最近的一个关键帧。参数的范围为[0,duration]（duration为视频的时长）。如果传入的参数小于0，则播放器会自动将该参数修正到0；如果传入参数大于duration，则修正到duration。

isPlaying

public boolean isPlaying();

功能：视频是否在播放。

返回值：true 代表正在播放，否则没有在播放。

setVolume

public void setVolume(int vol);

功能：设置播放器音量

参数：

vol： 音量大小，范围为 0-100，100 为最大，0 为最小。

getVideoWidth

public int getVideoWidth();

功能：获取视频宽度

返回值：返回视频宽度。返回值为0表示获取视频宽度失败。

getVideoHeight

public int getVideoHeight();

功能：获取视频高度。

返回值：返回视频高度。返回值为0表示获取视频高度失败。

getDuration

public int getDuration();

功能：获取视频时长。

返回值：返回视频时长，单位为毫秒。

getCurrentPosition

public int getCurrentPosition();

功能：获取视频的当前播放位置。

返回值：视频的当前播放位置，单位为毫秒。

getErrorCode

public int getErrorCode();

功能：当播放器出错时，调用该函数获取播放器错误码。

返回值：播放器的错误码。

setSurfaceChanged

public void setSurfaceChanged();

功能：通知 surface 改变

备注：在播放暂停或卡顿时，这个时候旋转手机屏幕，会发生渲染错位。为了解决这一问题，请在surfaceChanged发生时，调用此方法。如果播放界面关闭了自动旋转功能，无须调用此方法。

enableNativeLog

public void enableNativeLog();

功能：打开底层日志。备注：仅在开发阶段调用此方法。打开底层日志，意味着底层的日志首先会通过adb logcat的形式输出，另外在应用层，还可以通过getCurrNatvieLog方法获取底层日志。

disableNativeLog

public void disableNativeLog();

功能：关闭底层日志。

getCurrNatvieLog

public List<VideoNativeLog> getCurrNatvieLog();

功能：获取 Native 日志。

备注：仅仅在 enableNativeLog 有效。此方法返回底层日志列表，每条日志(VideoNativeLog) 包含如下几个字段：

Tag：日志的 tag，不唯一。

Content：日志的内容。

Time：日志的时间。

Level：日志的级别（0 表示 ANDROID_ LOG_ UNKNOWN ； 1 表示 ANDROID_ LOG_ DEFAULT ； 2 表示 ANDROID_ LOG_ VERBOSE ；3 表示 ANDROID_ LOG_ DEBUG；4 表示 ANDROID_ LOG_ INFO；5 表示ANDROID_ LOG_ WARN ； 6 表 示 ANDROID_ LOG_ ERROR ； 7 表 示 ANDROID_ LOG_ FATAL ； 8 表 示ANDROID_ LOG_ SILENT）。

setVideoSurface

public void setVideoSurface(Surface surface);

功能：设置视频播放 Surface

参数：

surface: 视频播放 View 的 surface。

备注：使用场景是之前的 surface 已经销毁，但是还要继续播放；或者想在一个新的 surface 上显示视频 。特别注意，在初始化播放器的时候，已经传入了 surface，所以在释放以前的 surface 之前，是不允许再次设置新的 surface 的。也就是说请先 releaseVideoSurface 再 setVideoSurface。

releaseVideoSurface

public void releaseVideoSurface();

功能：释放视频 Surface。

备注：使用场景是当前的 surface 被销毁；或者想在一个新 surface 上显示视频，需要提前释放当前的 surface。如果使用播放器构造函数或者setVideoSurface 设置了 surface，那么就可以通过releaseVideoSurface 释放当前的 surface，但是一旦释放之后，就不能再次调用，否则就会出现黑屏。

setTimeout

public void setTimeout(int timeout);

功能：设置 IO 超时时间。

参数：

timeout：超时时长，单位毫秒。

备注：当播放器超过设定时间没有下载到任何数据，会发送。ALIVC ERR LOADING_ TIMEOUT 错误事件。系统默认 timeout 时间为 15000 毫秒。

setMaxBufferDuration

public void setMaxBufferDuration(int duration);

功能：设置直播最大缓冲时长。

参数：

duration: 缓冲时长，单位毫秒。

备注：该函数仅对直播场景有效，主要用于缩短主播与观众之间的时间延迟。当缓冲区中的视频时长超过设置的 duration 时，播放器会自动丢弃部分音视频数据，以减少延迟。系统默认 rtmp、http flv 直播时 duration为8秒，HLS直播时duration为40秒。建议rtmp、http flv直播时，duration 的值超过 GOP 时长（即两个关键帧之间的时间长度）的 2 倍；HLS 直播时，duration 的值超过 m3u8 文件中所有 ts 分片的总时长。这样可以避免出现经常性的视频丢帧。

setMediaType

public void setMediaType(MediaType type);

功能：设置播放类型。

参数：

type: 媒体类型。MediaType.Live 表示直播；MediaType.Vod 表示点播

备注：建议在可以清晰分辨视频类型的情况下尽量调用该函数。如果不调用，则播放器会自动根据视频的 duration 来判断媒体类型。Duration 为 0 且格式为 HLS、rtmp、http flv 的为直播类视频，其他为点播类视频。

setDefaultDecoder

public    void setDefaultDecoder(int    decoderType);`

功能：设置默认的解码器。

参数：

type: 解码器类型。0代表硬件解码器；1代表软件解码器。

备注：默认为软件解码。由于android手机硬件适配性的问题，很多android手机的硬件解码会有问题，所以，我们建议尽量使用软件解码。

setMuteMode

public void setMuteMode(boolean on);

功能：设置播放器是否静音。

备注：静音指播放器的静音，并不会影响系统音量。

setScalingMode

public void setVideoScalingMode(VideoScalingMode scalingMode);
enum VideoScalingMode 
{
    VIDEO_SCALING_MODE_SCALE_TO_FIT(0),
    VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING(1)
};

功能：设置播放器渲染时的缩放模式，目前有两种模式，VIDEO_ SCALING_ MODE_ SCALE_ TO_ FIT：等比例缩放显示，如果视频长宽比和屏幕长宽比不一致时，会存在黑边；VIDEO_ SCALING_ MODE_ SCALE_ TO_ FIT_ WITH_ CROPPING：带裁边的等比例缩放，如果视频长宽比和屏幕长宽比不一致时，会进行裁边处理以保持全屏显示。

"dec-fps"：视频解码 fps
"out-fps"：视频渲染 fps
"select-v"：视频流 index
"select_a"：音频流 index
"v-dec"：视频解码器名称
"a-dec"：音频解码器名称
"vcache-dur"：视频缓冲时长，单位秒
"acache-dur"：音频缓冲时长，单位秒
"vcache-bytes"：视频缓冲大小，单位 byte
"acache-bytes"：音频缓冲大小，单位 byte
"vcache-pkts"：视频缓冲帧数
"acache-pkts"：音频缓冲帧数

public interface MediaPlayerPrepareListener {
    void onPrepared();      
}

public interface MediaPlayerCompletedListener {
    void onCompleted();
}

public interface MediaPlayerInfoListener{
    void onInfo(int what, int extra);
}

public interface MediaPlayerErrorListener {
    void onError(int what, int extra);
}

public interface MediaPlayerSeekCompleteListener {
    void onSeekCompleted();
}

public interface MediaPlayerBufferingUpdateListener {
    void onBufferingUpdateListener(int percent);
}

public interface MediaPlayerVideoSizeChangeListener {
    void onVideoSizeChange(int width, int height);
}