ApsaraVideo Live:Implement RTS stream pulling on Android

Avant de commencer

Vérifiez que vous disposez des éléments suivants :

• Une URL de streaming RTS utilisant le protocole artc://

• ApsaraVideo Player SDK version 5.4.5.0 ou ultérieure. Pour les liens de téléchargement, consultez la rubrique Téléchargement du SDK

Limitations de RTS

RTS présente les limitations suivantes :

• Pas de prise en charge de la pause. L'appel à la méthode pause sur un flux RTS en direct n'est pas pris en charge. Appelez stop pour arrêter la lecture, puis appelez prepare pour la reprendre.

• Pas de recherche temporelle. La fonction de recherche (glissement de la barre de progression) n'est pas prise en charge.

Intégrer le SDK

Ajoutez le SDK ApsaraVideo Player et les dépendances RTS via Maven.

1. Ajoutez le dépôt Maven au fichier build.gradle situé dans le répertoire racine du projet.

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

2. Ajoutez les dépendances suivantes au fichier 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"

Implémenter la lecture RTS

Utilisez les méthodes du SDK ApsaraVideo Player pour lire un flux RTS. Pour découvrir les autres fonctionnalités du lecteur, reportez-vous aux rubriques Fonctionnalités avancées et Référence 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();

Contrôler la lecture

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

Dégradation RTS

Lorsque la réception du flux RTS échoue en raison d'un délai d'attente, le lecteur peut automatiquement basculer vers un protocole alternatif. La dégradation s'applique uniquement aux scénarios de délai d'attente. D'autres erreurs, telles que 404, 403 ou la déconnexion de l'émetteur, déclenchent plutôt le rappel 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);

Récupérer le TraceID

Chaque session de lecture RTS génère un TraceID pour le dépannage. Récupérez-le via le rappel d'événement du lecteur :

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

Journalisation

Activez ou désactivez la journalisation de la console pour le débogage :

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