ApsaraVideo Live:Implement RTS stream pulling on Android

Step 1: Load the RTS library

Add the static initializer to your Activity:

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

Step 2: Create a player

Create an AliPlayer instance using the AliPlayerFactory class.

// Create a player instance
AliPlayer mAliPlayer = AliPlayerFactory.createAliPlayer(context);
// Optional: Set a trace ID for single-point tracing
// Use a unique identifier for the user or device, such as a user ID, IMEI, or IDFA.
mAliPlayer.setTraceId("traceId");

Step 3: Set the display view

The player supports three view types: AliDisplayView (recommended), SurfaceView, and TextureView.

<!-- Player rendering view -->
<com.aliyun.player.videoview.AliDisplayView
    android:id="@+id/ali_display_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_gravity="center" />

AliDisplayView mAliDisplayView = findViewById(R.id.display_view);
// Set the playback view type using setPreferDisplayView()
mAliDisplayView.setPreferDisplayView(AliDisplayView.DisplayViewType.SurfaceView);
mAliPlayer.setDisplayView(mAliDisplayView);

<!-- Player rendering view -->
<SurfaceView
    android:id="@+id/surface_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_gravity="center" />

SurfaceView mSurfaceView = findViewById(R.id.surface_view);
mSurfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {
    @Override
    public void surfaceCreated(@NonNull SurfaceHolder holder) {
        mAliPlayer.setSurface(holder.getSurface());
    }

    @Override
    public void surfaceChanged(@NonNull SurfaceHolder holder, int format, int width, int height) {
        mAliPlayer.surfaceChanged();
    }

    @Override
    public void surfaceDestroyed(@NonNull SurfaceHolder holder) {
        mAliPlayer.setSurface(null)
    }
});

<!-- Player rendering view -->
<TextureView
    android:id="@+id/texture_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_gravity="center" />

TextureView mTextureView = findViewById(R.id.texture_view);
mTextureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
    @Override
    public void onSurfaceTextureAvailable(@NonNull SurfaceTexture surface, int width, int height) {
        mAliPlayer.setSurface(new Surface(surface));
    }

    @Override
    public void onSurfaceTextureSizeChanged(@NonNull SurfaceTexture surface, int width, int height) {
        mAliPlayer.surfaceChanged();
    }

    @Override
    public boolean onSurfaceTextureDestroyed(@NonNull SurfaceTexture surface) {
        mAliPlayer.setSurface(null);
        return true;
    }

    @Override
    public void onSurfaceTextureUpdated(@NonNull SurfaceTexture surface) {

    }
});

Step 4: Set the playback source

The player supports four playback source types: VidSts, VidAuth, VidMps, and UrlSource. For RTS playback, use UrlSource with an artc:// URL.

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

For details on other playback source types, see Basic Features.

Step 5: Configure low-latency parameters

ApsaraVideo Player SDK V6.3.0 and later automatically applies optimal low-latency settings when the playback URL starts with artc:// and mMaxDelayTime, mHighBufferDuration, and mStartBufferDuration in PlayerConfig have not been manually modified. The automatic values are:

To override these defaults, configure them manually:

// 1. Get and modify the configurations
PlayerConfig config = mAliPlayer.getConfig();
if (playUrl.startWith("artc://")) {
    // Maximum delay: 1000 milliseconds
    config.mMaxDelayTime = 1000;
    // Buffer duration for playback startup: 10 milliseconds
    config.mStartBufferDuration = 10;
    // Buffer duration for stuttering recovery: 10 milliseconds
    config.mHighBufferDuration = 10;
} else {
    // Use default configurations or customize to other configurations
}

// 2. Apply the configurations
mAliPlayer.setConfig(config);

Step 6: Start playback

// Prepare for playback
mAliPlayer.prepare();
// Start playback
mAliPlayer.start();

Start

mAliPlayer.start();

Stop

mAliPlayer.stop();

Destroy the player

Destroy the player instance using synchronous or asynchronous destruction.

// Synchronous destruction. The system automatically calls the stop interface.
mAliPlayer.release();
// Asynchronous destruction. The system automatically calls the stop interface.
mAliPlayer.releaseAsync();

Automatic degradation (enabled by default)

When RTS stream pulling fails and no custom degradation is configured, the player automatically degrades to the default FLV address derived from the RTS URL.

// 1 means enabled, 0 means disabled. Enabled by default.
AliPlayerGlobalSettings.setOption(AliPlayerGlobalSettings.ALLOW_RTS_DEGRADE, 1);

Custom degradation

Specify a degradation URL (such as an HLS or FLV address) when RTS stream pulling fails.

PlayerConfig config = mAliPlayer.getConfig();
// Optional: Configure other items in config
UrlSource urlSource = new UrlSource();
urlSource.setUri(downgradeUrl);
// Set the degradation URL
mAliPlayer.enableDowngrade(urlSource, config);