ApsaraVideo Live:Native RTS SDK for Android

Load the library

Add System.loadLibrary("RtsSDK"); to the required activity based on your business requirements.

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

Create a player

Use the AliPlayerFactory class to create a player. You can create the following two types of players: AliPlayer and AliListPlayer. If you want to play a single stream, use AliPlayer. You can run the following code to create an AliPlayer:

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

Set player listeners

ApsaraVideo Player SDK provides a variety of listeners, such as onPrepared and onCompletion. You can run the following code to set listeners:

aliyunVodPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    @Override
    public void onError(ErrorInfo errorInfo) {
        // Listens to the occurrence of errors.
    }
});
aliyunVodPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        // Listens to successful preparation.
    }
});
aliyunVodPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
    @Override
    public void onVideoSizeChanged(int width, int height) {
        // Listens to the change of video resolution.
    }
});
aliyunVodPlayer.setOnRenderingStartListener(new IPlayer.OnRenderingStartListener() {
    @Override
    public void onRenderingStart() {
        // Listens to the display of the first frame.
    }
});
aliyunVodPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(int type, long extra) {
        // Listens to other events, such as the start of loop playback, the buffer position, the current playback position, and the start of autoplay.
    }
});
aliyunVodPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    @Override
    public void onLoadingBegin() {
        // Listens to the start of buffering.
    }
    @Override
    public void onLoadingProgress(int percent, float kbps) {
        // Listens to the buffering progress.
    }
    @Override
    public void onLoadingEnd() {
        // Listens to the end of buffering.
    }
});
aliyunVodPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
    @Override
    public void onSubtitleShow(long id, String data) {
        // Listens to the display of subtitles.
    }
    @Override
    public void onSubtitleHide(long id) {
        // Listens to the hiding of subtitles.
    }
});
aliyunVodPlayer.setOnTrackChangedListener(new IPlayer.OnTrackChangedListener() {
    @Override
    public void onChangedSuccess(TrackInfo trackInfo) {
        // Listens to the success of switching between audio and video streams or between resolutions.
    }
    @Override
    public void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo) {
        // Listens to the failure of switching between audio and video streams or between resolutions.
    }
});
aliyunVodPlayer.setOnStateChangedListener(new IPlayer.OnStateChangedListener() {
    @Override
    public void onStateChanged(int newState) {
        // Listens to the change of player status.
    }
});
aliyunVodPlayer.setOnSnapShotListener(new IPlayer.OnSnapShotListener() {
    @Override
    public void onSnapShot(Bitmap bm, int with, int height) {
        // Listens to the capture of snapshots.
    }
});

Configure a playback source

ApsaraVideo Player supports four types of playback sources: VidSts, VidAuth, VidMps, and UrlSource. UrlSource is used for URL-based playback. If you use UrlSource, you must prefix URLs with artc:// to use the RTS feature.

UrlSource urlSource = new UrlSource();
urlSource.setUri("artc://<Streaming URL>");
aliyunVodPlayer.setDataSource(urlSource);

Set the user interface (UI) view

If the playback source contains video images, you must set the UI view to display the video images. SurfaceView and TextureView are supported. Sample code for 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.surfaceChanged();
    }
    @Override
    public void surfaceDestroyed(SurfaceHolder holder) {
        aliyunVodPlayer.setDisplay(null);
    }
});

Set playback control

You must create playback control buttons and associate click events with playback control methods to implement playback control. The basic control functions include playing and stopping. Sample code:

// Prepare for playback. You can specify the start() method in the callback so that the playback starts upon the completion of preparation.
aliyunVodPlayer.prepare();
// Start playback.
aliyunVodPlayer.start();
// Stop playback.
aliyunVodPlayer.stop();
// Reset the player.
aliyunVodPlayer.reset();
// Release the player. The player cannot be used after it is released.
aliyunVodPlayer.release();

Set playback parameters

You can set playback parameters to improve the RTS effect.

// Query the configurations.
PlayerConfig config = mAliyunVodPlayer.getConfig();
// Set the maximum latency to 1 second. The Alibaba Real-Time Communication (ARTC) protocol controls the latency.
config.mMaxDelayTime = 1000;
// Set the buffer period to 10 milliseconds. The ARTC protocol controls the buffer period. 
config.mHighBufferDuration = 10;
config.mStartBufferDuration = 10;
.... // Configure other settings.
// Load the settings for the player.
mAliyunVodPlayer.setConfig(config);

Enable or disable logging

// Enable logging.
Logger.getInstance(context).enableConsoleLog(true);
Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_TRACE);
// Disable logging.
Logger.getInstance(context).enableConsoleLog(false);
Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_NONE);

Use a degraded protocol for live streaming

You can change the prefix of a source URL from artc:// to the HTTP-FLV format, and then update the UrlSource in ApsaraVideo Player. This way, you can use a degraded protocol to play live streams.

/**
 * Configure the degradation policy.
 */
private void willBeDemoted() {
    mRtsAliPlayer.stop();
    if (mUrl.startsWith("artc://")) {
        setDataSource("http://xxxx.flv");
        mRtsAliPlayer.prepare();
    }
}

Obtain the TraceId

When a message that is passed through by the playback component is returned in a player event callback, parse the JSON string that describes the player event. The code that you obtain is the message in RTS SDK. When you receive E_HELP_SUPPORT_ID_SUBSCRIBE, parse the part of the string after "-sub-" to obtain the TraceId.

private static final int TRACE_ID_CODE = 104;

// 1. Listen to the onInfo callback and parse the RTS event message.
mRtsAliPlayer.setOnInfoListener(infoBean -> {
    if (infoBean.getCode() == InfoCode.DirectComponentMSG) {
        String extraMsg = infoBean.getExtraMsg();
        parseDirectComponentMSG(extraMsg);
    }
});

private void parseDirectComponentMSG(String msg) {
    if (msg.contains("code=" + TRACE_ID_CODE)) {
        parseTraceId(msg);
    }
}

/**
 * Parse the TraceId.
 */
private void parseTraceId(String msg) {
    String[] split = msg.split("-sub-");
    if (split.length >= 1) {
        mTraceId = "RequestId:" + (split[1].substring(0, split[1].length() - 1));
        mTraceId = mTraceId.replace("\"", "").replace("\\", "");
    }
}