ApsaraVideo Live:Implement RTS stream pulling on Android

Antes de começar

Verifique se você tem:

• Uma URL de streaming RTS que use o protocolo artc://

• O ApsaraVideo Player SDK V5.4.5.0 ou posterior. Para links de baixe, consulte Baixe do SDK

Limitações do RTS

O RTS apresenta as seguintes limitações:

• Sem suporte a pausa. Não é possível chamar pause em uma stream RTS ao vivo. Chame stop para encerrar a reprodução e, em seguida, chame prepare para retomar.

• Sem busca. O recurso de busca (arrastar a barra de progresso) não tem suporte.

Integrar o SDK

Adicione o ApsaraVideo Player SDK e as dependências do RTS usando o Maven.

1. Adicione o repositório Maven ao arquivo build.gradle no diretório raiz do projeto.

   // Maven repository for Alibaba Cloud SDKs (ApsaraVideo Player)
   maven { url 'http://maven.aliyun.com/nexus/content/repositories/releases' }

2. Inclua as seguintes dependências no arquivo app/build.gradle.

   def player_sdk_version = "x.x.x" // We recommend using the latest version.
   def rts_sdk_version = "7.12.0" // Independent version number, currently the latest version.
   
   // Player main library
   implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
   
   // RTS bridge component (AlivcArtc). The version number must match the player version exactly.
   // Must be integrated together with the RTS component.
   implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version"
   
   // RTS component
   implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"

Implementar a reprodução RTS

Use os métodos do ApsaraVideo Player SDK para reproduzir uma stream RTS. Para conhecer outros recursos do player, consulte Recursos avançados e Referência da API.

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

// 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");

<!-- 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) {

    }
});

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

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

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

Controlar a reprodução

mAliPlayer.start();

mAliPlayer.stop();

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

Degradação de RTS

Quando a recepção da stream RTS falha devido a timeout, o player pode degradar automaticamente para um protocolo alternativo. A degradação aplica-se apenas a cenários de timeout. Outros erros, como 404, 403 ou desconexão do streamer, acionam o callback onError.

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

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

Recuperar o TraceID

Cada sessão de reprodução RTS gera um TraceID para solução de problemas. Recupere-o por meio do callback de eventos do player:

// Listen for the player's onInfo callback and parse the DemuxerTraceID message
mAliPlayer.setOnInfoListener(infoBean -> {
    if (infoBean.getCode() == InfoCode.DemuxerTraceID) {
        String traceId = infoBean.getExtraMsg();
    }
});

Logging

Ative ou desative o logging no console para depuração:

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