ApsaraVideo Live:Implémenter la lecture de flux RTS sur iOS

Créer un lecteur

1. Créez un lecteur.

   Créez une instance AliPlayer.

   // Create a player instance
   AliPlayer mAliPlayer = [[AliPlayer alloc] init];
   
   // Create a view container for displaying the playback content and set the player's rendering view
   UIView playerView = [[UIView alloc] initWithFrame:self.view.bounds];
   [self.view addSubview:playerView];
   mAliPlayer.playerView = playerView;
   
   [mAliPlayer setTraceID:traceId];

   Remarque

   Le lecteur propose les fonctionnalités Surveillance de la qualité de lecture, Traçage ponctuel et Statistiques de lecture vidéo, qui reposent toutes sur la génération de journaux d'instrumentation.

   Les capacités disponibles dépendent de la configuration du paramètre setTraceID :

   • Si setTraceID est omis (valeur par défaut), la génération de journaux d'instrumentation est activée. Vous pouvez utiliser la surveillance de la qualité de lecture et les statistiques de lecture vidéo, mais pas le traçage ponctuel.

   • setTraceID défini avec un ID de trace : l'ID de trace doit être un identifiant unique pour votre utilisateur ou votre appareil, tel qu'un ID utilisateur ou un ID d'appareil (IMEI ou IDFA). Lorsqu'un ID de trace est configuré, la génération de journaux d'instrumentation est activée et vous pouvez utiliser la surveillance de la qualité de lecture, le traçage ponctuel et les statistiques de lecture vidéo.

   • setTraceID défini sur DisableAnalytics : désactive la génération de journaux d'instrumentation. La surveillance de la qualité de lecture, le traçage ponctuel et les statistiques de lecture vidéo ne sont pas disponibles.

2. Définissez la source de lecture.

   Le lecteur prend en charge quatre sources de lecture : VidSts, VidAuth, VidMps et UrlSource. Pour utiliser RTS, définissez UrlSource avec une URL utilisant le protocole artc://.

   AVPUrlSource *urlSource = [[AVPUrlSource alloc] 
   urlWithString:"artc://<streaming URL>"]; 
   [mAliPlayer setUrlSource:urlSource];

   Remarque

   Pour plus d'informations sur la définition de la source de lecture, consultez la rubrique Fonctionnalités de base.

3. Configurez les paramètres de lecture.

   Configurez les paramètres de lecture afin d'optimiser l'expérience RTS.

   Remarque

   À partir de la version 6.3.0, le SDK du lecteur prend en charge la configuration automatique optimale pour une faible latence. Lorsque l'URL de lecture commence par artc:// et que vous n'avez pas modifié manuellement les valeurs MaxDelayTime, HighBufferDuration ou StartBufferDuration dans AVPConfig, le SDK utilise automatiquement les valeurs 1000, 10 et 10 pour la lecture effective.

   Pour personnaliser ces paramètres, utilisez l'exemple suivant :

   //1. Obtain and modify the configuration.
   AVPConfig *config = mAliPlayer.getConfig;
   
   if ([playUrl hasPrefix:@"artc://"]) {
       // The maximum latency. Unit: milliseconds. In this example, set the value to 1000, which is 1 second.
       [config setMaxDelayTime:1000];
       // The buffer duration for playback startup.
       [config setStartBufferDuration:10];
       // The buffer duration for stuttering recovery.
       [config setHighBufferDuration:10];
   } else {
       // You can use default configuration or specify custom values.
   }
   
   //2. Apply the configuration.
   [mAliPlayer setConfig:config];

4. Démarrez la lecture.

   // Prepare for playback
   [mAliPlayer prepare];
   // After prepare, you can synchronously call the start operation. Playback automatically starts when the onPrepared callback completes.
   [mAliPlayer start];

Contrôler la lecture

Le SDK ApsaraVideo Player prend en charge les commandes de lecture courantes telles que le démarrage, l'arrêt et la recherche temporelle.

 [mAliPlayer start];

[mAliPlayer stop];

// Synchronously destroy the player. The system automatically calls the stop method.
[mAliPlayer destroy];
// Asynchronously destroy the player. The system automatically calls the stop method.
[mAliPlayer destroyAsync];

Utiliser les fonctionnalités auxiliaires

1. Activation/Désactivation des journaux

   // Enable logging.
   [mAliPlayer setEnableLog:YES];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_TRACE callbackBlock:nil];
   
   // Disable logging.
   [mAliPlayer setEnableLog:NO];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_NONE callbackBlock:nil];

2. Repli de la diffusion en direct

   Remarque

   • Le repli s'applique uniquement aux scénarios de délai d'expiration (timeout). Si un délai d'expiration se produit et que vous avez configuré l'une des options de repli ci-dessous, le lecteur effectue automatiquement le repli. Sinon, il déclenche le rappel onError. Les erreurs telles que HTTP 404, 403 ou la déconnexion de l'émetteur ne déclenchent pas le repli.

   • Le repli automatique RTS permet de passer de RTS à FLV en utilisant le même domaine. Si vos domaines RTS et FLV diffèrent, configurez le repli RTS personnalisé pour spécifier le domaine FLV cible.

   1. Repli automatique RTS (activé par défaut)

      Si aucun repli personnalisé n'est configuré, le lecteur revient automatiquement à l'URL FLV par défaut associée à l'URL RTS lorsque la lecture de flux RTS échoue. Par exemple :

      // 1 indicates on, and 0 indicates off. The default value is on.
      [AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

   2. Repli RTS personnalisé

      Spécifiez une URL de secours (HLS ou FLV) pour la lecture RTS. Si la lecture de flux RTS échoue, le lecteur bascule automatiquement vers l'URL spécifiée.

      // Specify the downgrade source URL.
      AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
      // Optional. Configure other settings.
      AVPConfig *config = [mAliPlayer getConfig];
      // Specify the degraded streaming URL.
      [mAliPlayer enableDowngrade:urlSource config:config];

3. Obtenir l'ID de trace

   Chaque session de lecture à faible latence génère un ID de trace utile pour le dépannage. Récupérez-le depuis le rappel d'événement du lecteur.

   // Listen to the onPlayerEvent callback and parse the DemuxerTraceID message.
   - (void)onPlayerEvent:(AliPlayer*)mAliPlayer eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
       switch (eventWithString) {
           case EVENT_PLAYER_DEMUXER_TRACE_ID:
               {
                   NSString *traceId = description;
               }
                   break;
               default:
                   break;
       }
   }