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);
}