阿里云播放器SDK使用说明

//MPChart maven仓库地址，如果不需要曲线图，可以删除
maven { url 'https://jitpack.io' }
//阿里云相关SDK(阿里云播放器、RTSSDK) maven仓库地址，如果使用IJKPlayer可以删除
maven { url 'http://maven.aliyun.com/nexus/content/repositories/releases' }

ext {
    compileSdkVersion = 25
    buildToolsVersion = "25.0.3"
    minSdkVersion = 21
    targetSdkVersion = 25

    versionCode = 800800
    versionName = "0.8.8"
    appVersionCode = 1
    appVersionName = "1.0"

    externalRecyclerView = 'com.android.support:recyclerview-v7:25.4.0'
    externalMPAndroidChart = 'com.github.PhilJay:MPAndroidChart:v3.1.0'
    externalSupportAppCompat = 'com.android.support:appcompat-v7:25.4.0'

    //ARTC直播播放器
    externalAliyunARTCNet = 'com.aliyun.rts.android:RtsSDK:1.6.0'
    externalAliyunARTC = 'com.aliyun.sdk.android:AliyunArtc:5.3.2'
    externalAliyunPlayer = 'com.aliyun.sdk.android:AliyunPlayer:5.3.2-full'

    //required, enough for most devices.
    //implementation 'tv.danmaku.ijk.media:ijkplayer-java:0.8.8'
    //implementation 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.8'
}

通过AliPlayerFactory类可创建两种播放器：AliPlayer和AliListPlayer。单个播放功能使用AliPlayer，创建方法如下所示：

AliPlayer aliyunVodPlayer;
.....
aliyunVodPlayer = AliPlayerFactory.createAliPlayer(getApplicationContext());

播放器提供了多种监听事件，如onPrepared，onCompletion等事件。设置方法如下所示：

aliyunVodPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        //播放完成事件
    }
});
aliyunVodPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    @Override
    public void onError(ErrorInfo errorInfo) {
        //出错事件
    }
});
aliyunVodPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //准备成功事件
    }
});
aliyunVodPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
    @Override
    public void onVideoSizeChanged(int width, int height) {
        //视频分辨率变化回调
    }
});
aliyunVodPlayer.setOnRenderingStartListener(new IPlayer.OnRenderingStartListener() {
    @Override
    public void onRenderingStart() {
        //首帧渲染显示事件
    }
});
aliyunVodPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(int type, long extra) {
        //其他信息的事件，type包括循环播放开始、缓冲位置、当前播放位置、自动播放开始等
    }
});
aliyunVodPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    @Override
    public void onLoadingBegin() {
        //缓冲开始
    }
    @Override
    public void onLoadingProgress(int percent, float kbps) {
        //缓冲进度
    }
    @Override
    public void onLoadingEnd() {
        //缓冲结束
    }
});
aliyunVodPlayer.setOnSeekCompleteListener(new IPlayer.OnSeekCompleteListener() {
    @Override
    public void onSeekComplete() {
        //拖动结束
    }
});
aliyunVodPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
    @Override
    public void onSubtitleShow(long id, String data) {
        //显示字幕
    }
    @Override
    public void onSubtitleHide(long id) {
        //隐藏字幕
    }
});
aliyunVodPlayer.setOnTrackChangedListener(new IPlayer.OnTrackChangedListener() {
    @Override
    public void onChangedSuccess(TrackInfo trackInfo) {
        //切换音视频流或者清晰度成功
    }
    @Override
    public void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo) {
        //切换音视频流或者清晰度失败
    }
});
aliyunVodPlayer.setOnStateChangedListener(new IPlayer.OnStateChangedListener() {
    @Override
    public void onStateChanged(int newState) {
        //播放器状态改变事件
    }
});
aliyunVodPlayer.setOnSnapShotListener(new IPlayer.OnSnapShotListener() {
    @Override
    public void onSnapShot(Bitmap bm, int with, int height) {
        //截图事件
    }
});

播放器支持4种播放源：VidSts、VidAuth、VidMps、UrlSource。其中UrlSource是直接URL播放，需要将URL设置为artc://协议，才可以使用RTS服务。

UrlSource urlSource = new UrlSource();
urlSource.setUri("artc://xxxx");
aliyunVodPlayer.setDataSource(urlSource);

如果源有画面，需要设置显示的view（支持SurfaceView和TextureView）到播放器中，用来显示画面。本文以SurfaceView举例说明，如下所示：

surfaceView = (SurfaceView) findViewById(R.id.playview);
surfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {
    @Override
    public void surfaceCreated(SurfaceHolder holder) {
        aliyunVodPlayer.setDisplay(holder);
    }
    @Override
    public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
        aliyunVodPlayer.redraw();
    }
    @Override
    public void surfaceDestroyed(SurfaceHolder holder) {
        aliyunVodPlayer.setDisplay(null);
    }
});

用户自行创建播放器的播放控制按钮，在按钮事件里面实现播放器控制接口。基本控制功能有播放、暂停、停止、拖动（seek），其中seek功能仅对点播有效；直播使用暂停功能时会使画面停留在当前画面，使用恢复后会开始播放当前画面。使用示例如下所示：

//准备,在准备完成的回调接口中，调用start()可以开始播放
aliyunVodPlayer.prepare();
//开始播放
aliyunVodPlayer.start();
//暂停播放
aliyunVodPlayer.pause();
//停止播放
aliyunVodPlayer.stop();
//跳转到（不精准）
aliyunVodPlayer.seekTo(long position);
//重置
aliyunVodPlayer.reset();
//释放（释放后播放器将不可再被使用）
aliyunVodPlayer.release();

更多播放器SDK功能，请参见接口说明和功能使用。

参数配置如下所示，可以更好地发挥低延迟优势。

//获取配置
PlayerConfig config = mAliyunVodPlayer.getConfig();
//设置最大延迟为1秒，延迟控制由ARTC控制
config.mMaxDelayTime = 1000;
//设置播放器启播缓存为10毫秒，数据控制由ARTC控制。
config.mHighBufferDuration = 10;
config.mStartBufferDuration = 10;
....//其他设置
//给播放器加载配置
mAliyunVodPlayer.setConfig(config);

在合适的Activity内加入System.loadLibrary("RtsSDK");。

static {
    System.loadLibrary("RtsSDK");
}

- (AliPlayer *)aliPlayer{
    if (!_aliPlayer) {
        _aliPlayer = [[AliPlayer alloc] init];
        _aliPlayer.scalingMode =  AVP_SCALINGMODE_SCALEASPECTFIT;
        _aliPlayer.rate = 1;
    //如需实现AVPDelegate代理，添加此行
        _aliPlayer.delegate = self;
    //设置播放的视图，将您的播放视图赋值给aliplayer
        _aliPlayer.playerView = self.basePlayerView.playerView;
        _aliPlayer.autoPlay = YES;
    }
    return _aliPlayer;
}

AVPUrlSource *source = [[AVPUrlSource alloc] urlWithString:_url];
[self.aliPlayer setUrlSource:source];

AVPConfig *config = self.aliPlayer.getConfig;
//直播最大延迟
[config setMaxDelayTime:1000];
//卡顿恢复时长
[config setHighBufferDuration:10];
//起播最大延迟
[config setStartBufferDuration:10];
//重连次数
[config setNetworkRetryCount:2];
//重连时长  
[config setNetworkTimeout:15000];
 [_aliPlayer setConfig:config];
//默认为硬解，如播放器在准备过程中发现硬解失败，会自动切换到软解
 _aliPlayer.enableHardwareDecoder = YES;

[AliPlayer setEnableLog:YES];
[AliPlayer setLogCallbackInfo:LOG_LEVEL_DEBUG callbackBlock:nil];

[self.aliPlayer prepare];
[self.aliPlayer stop];
[self.aliPlayer destroy];
[self.aliPlayer reload];