Tous les produits
Search
Centre de documentation

ApsaraVideo Live:Lecture standard de flux en direct

Dernière mise à jour :Aug 08, 2026

Le SDK ApsaraVideo Player pour iOS prend en charge la lecture de flux en direct standard aux formats RTMP, FLV et HLS.

Important

Pour plus d'informations sur les fonctionnalités, la référence API et la FAQ, consultez la rubrique Player iOS.

Procédure

Étape 1 : Intégrer le SDK

Pour plus d'informations, consultez la rubrique Intégrer le SDK ApsaraVideo Player pour iOS.

Étape 2 : Implémenter la lecture de flux en direct

  1. Prise en main.

    Pour mettre en œuvre les fonctionnalités de lecture de base, consultez la rubrique Prise en main.

  2. Définissez la source du flux en direct.

    Le SDK prend en charge deux méthodes de lecture de flux en direct : UrlSource et la lecture chiffrée.

    UrlSource

    Pour lire un flux en direct avec la méthode UrlSource, définissez la propriété setUrl sur l'URL de streaming. L'URL peut provenir d'un service tiers ou d'ApsaraVideo Live.

    Vous pouvez générer des URL de streaming dans la console ApsaraVideo Live à l'aide du Générateur d'URL.

    AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:url]; // Required. The playback URL. This can be a streaming URL from a third-party service or from ApsaraVideo Live.
    [self.player setUrlSource:urlSource];

    Lecture chiffrée

    Pour plus d'informations sur la lecture de flux en direct avec chiffrement DRM, consultez la rubrique Lire une vidéo chiffrée.

  3. Gérez plusieurs définitions.Changement de définitionNotifications de changement de définition

    Remarque
    • Cette fonctionnalité prend en charge les URL de streaming ApsaraVideo Live pour les flux de qualité originale ou transcodés. Le transcodage par défaut et personnalisé est pris en charge. Pour plus d'informations, consultez la rubrique Cas d'utilisation.

    • Cette fonctionnalité est prise en charge pour les flux en direct utilisant le protocole ApsaraVideo Real-Time Communication (ARTC) ou FLV.

    • Définissez la taille du groupe d'images (GOP) pour l'ingestion de flux sur 1 s ou 2 s. Une taille plus grande peut provoquer des sauts lors du changement de flux.

    • Pour le domaine de streaming, activez Output RTMP timestamps during FLV playback et Output RTMP timestamps after upstream disconnection. Dans la configuration de transcodage, activez Inherit timestamps from source et Inherit keyframes from source. Sinon, le changement de flux peut saccader ou échouer. Pour activer ces options, soumettez un ticket.

    • Le basculement vers une URL de streaming qui ne répond pas aux exigences précédentes échouera.

    Pour changer de définition, appelez la méthode switchStream et transmettez l'URL du flux avec la nouvelle définition.

    [self.player switchStream:newUrl];

    Le lecteur renvoie des rappels en cas de succès ou d'échec du changement de définition.

    // Callback for a successful switch.
    - (void)onStreamSwitchedSuccess:(AliPlayer*)player URL:(NSString*)URL;
    
    // Callback for a failed switch.
    - (void)onStreamSwitchedFail:(AliPlayer*)player URL:(NSString*)URL errorModel:(AVPErrorModel *)errorModel;