苏宁视频云-帮助与文档

帮助与文档点播播放SDK Android SDK

Android播放 SDK

苏宁视频云播放Android SDK是苏宁视频云推出的 Android 平台上使用的软件开发工具包(SDK), 负责点播/直播播放。

一、功能特点

[支持软解]

支持播放协议：RTMP，HLS, HTTP-FLV

svc.suning.com

二、运行环境

最低支持版本为Android 4.0 (API level 15)
支持的cpu架构：armv7, arm64, x86

三、快速集成

本章节提供一个快速集成苏宁视频云播放SDK基础功能的示例。具体可以参考testppysdk工程中的相应文件。

配置项目

引入目标库, 将推流SDK中libs目录下的库文件引入到目标工程中并添加依赖。

可参考下述配置方式（以Android Studio为例）：

将ppcloud-sdk.aar拷贝到app的libs目录下；
修改目标工程的build.gradle文件，配置repositories路径：

repositories {
    flatDir {
        dirs 'libs'
    }
}
dependencies {
    ...
    compile(name: 'ppcloud-sdk', ext: 'aar')
    ...
}

简单播放示例

初始化SDK

                                            
// 在app的application里调用初始化函数
PPYSdk.getInstance().init(this);
public class TestApplication extends Application {
    @Override
    public void onCreate(){
        super.onCreate();
        PPYSdk.getInstance().init(this);
    }
}

具体可参考testppysdk工程中的WatchStreamingActivity类

在布局文件中加入播放View

<com.pplive.ppysdk.PPYVideoView
        android:id="@+id/live_player_videoview"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_centerInParent="true" />

PPYVideoView


PPYVideoView mVideoView = (PPYVideoView)findViewById(R.id.live_player_videoview);

初始化PPYVideoView。


// 初始化
mVideoView.initialize();
// 设置状态监听器
mVideoView.setListener(new PPYVideoViewListener() {
    @Override
    public void onPrepared() {
        Log.d(ConstInfo.TAG, "play onPrepared");
    }

    @Override
    public void onError(int i, int i1) {
        if(i == PPYVideoView.ERROR_DEMUXER_READ_FAIL){
            Log.d(ConstInfo.TAG, "fail to read data from network");
        }else if(i == PPYVideoView.ERROR_DEMUXER_PREPARE_FAIL){
            Log.d(ConstInfo.TAG, "fail to connect to media server");
        }else{
            Log.d(ConstInfo.TAG, "onError : "+String.valueOf(i));
        }
    }

    @Override
    public void onInfo(int what, int extra) {
        if(what == PPYVideoView.INFO_BUFFERING_START){
            Log.d(ConstInfo.TAG, "onInfo buffering start");
        }
        if(what == PPYVideoView.INFO_BUFFERING_END){
            Log.d(ConstInfo.TAG, "onInfo buffering end");
        }
        if(what == PPYVideoView.INFO_VIDEO_RENDERING_START){
            Log.d(ConstInfo.TAG, "onInfo video rendering start");
        }
        if(what == PPYVideoView.INFO_REAL_BITRATE){
            Log.d(ConstInfo.TAG, "onInfo real bitrate : "+String.valueOf(extra));
        }
        if(what == PPYVideoView.INFO_REAL_FPS){
            Log.d(ConstInfo.TAG, "onInfo real fps : "+String.valueOf(extra));
        }
        if(what == PPYVideoView.INFO_REAL_BUFFER_DURATION){
            Log.d(ConstInfo.TAG, "onInfo real buffer duration : "+String.valueOf(extra));
        }
        if(what == PPYVideoView.INFO_CONNECTED_SERVER){
            Log.d(ConstInfo.TAG, "connected to media server");
        }
        if(what == PPYVideoView.INFO_DOWNLOAD_STARTED){
            Log.d(ConstInfo.TAG, "start download media data");
        }
        if(what == PPYVideoView.INFO_GOT_FIRST_KEY_FRAME){
            Log.d(ConstInfo.TAG, "got first key frame");
        }
    }

    @Override
    public void onCompletion() {
        Log.d(ConstInfo.TAG, "onCompletion");
    }

    @Override
    public void onVideoSizeChanged(int i, int i1) {
        Log.d(ConstInfo.TAG, "play setOnVideoSizeChanged w="+i+" h="+i1);
    }
});

设置播放地址

注意：点播播放器用PPYVideoView.VOD_HIGH_CACHE，直播播放器用PPYVideoView.LIVE_LOW_DELAY


new Thread(new Runnable() {
    @Override
    public void run() {
        mVideoView.setDataSource(getCurrentUrl(),PPYVideoView.VOD_HIGH_CACHE);
        mVideoView.prepareAsync();
    }
}).start();

开始播放

注意：播放器在setListener的回调中收到onPrepared中调用start接口开始播放


mVideoView.setListener(new PPYVideoViewListener() {
    @Override
    public void onPrepared() {
        Log.d(ConstInfo.TAG, "play onPrepared");

         mVideoView.start();
    }
    ...
});

播放结束


mVideoView.stop(false);

释放播放资源在Activity的onDestroy加入释放代码


@Override
protected void onDestroy()
{
    super.onDestroy();
    mVideoView.stop(false);
    mVideoView.release();
}

文本导读：
功能特点
运行环境
快速集成
简单播放示例