Tous les produits
Search

Ce produit

    ApsaraVideo Live:Pulled-stream relay

    Centre de documentation

    ApsaraVideo Live:Pulled-stream relay

    Dernière mise à jour :Aug 19, 2026

    Le relais de flux tiré vous permet de tirer des sources existantes (diffusion en direct ou vidéo à la demande) et de les pousser en tant que nouveaux flux en direct.

    Présentation

    Le relais de flux tiré extrait le contenu provenant de flux en direct tiers ou de vidéos enregistrées, puis le diffuse aux spectateurs en temps réel, sans passer par les étapes d'ingestion traditionnelles.

    Flux de travail :

    image

    Scénario type : Accès à la surveillance véhiculaire

    Les dispositifs embarqués dans les véhicules émettent souvent des flux vidéo via des protocoles propriétaires, tels que JT/T 1078 ou la norme de la province du Jiangsu. Pour connecter un tel flux à ApsaraVideo Live, utilisez une passerelle de conversion de protocole afin de transformer le flux propriétaire en flux RTMP standard. Créez ensuite une tâche de relais de flux tiré. Définissez le paramètre Source Stream Type sur Live Stream, spécifiez le protocole du flux source comme étant RTMP, puis saisissez l'URL du flux source RTMP converti ainsi que l'URL d'ingestion de destination. Les clients mobiles peuvent alors lire le flux à l'aide du SDK Alibaba Cloud Player.

    Remarques d'utilisation

    • Cette fonctionnalité est payante. La facturation débute le 5 décembre 2025 à 00:00. Tarification : Frais de relais de flux tiré.

    • Chaque tâche pousse un seul flux. Pour pousser plusieurs flux, créez plusieurs tâches.

    • Il vous incombe de veiller à ce que le contenu utilisé avec cette fonctionnalité respecte toutes les lois et réglementations applicables. ApsaraVideo Live fournit uniquement le service de transmission de flux. En cas de menace légale identifiée, ApsaraVideo Live interrompt le service pour le contenu concerné et se réserve le droit d'engager des actions en justice.

    • Pour tirer ou pousser des flux en dehors de la Chine continentale, définissez la région de la tâche sur une région située hors de Chine continentale.

    • Cette fonctionnalité prend en charge les rappels d'événements. Pour plus de détails, consultez la rubrique Rappels d'événements pour le relais de flux tiré.

    • Chaque compte peut exécuter jusqu'à 100 tâches simultanées.

    Prérequis

    • ApsaraVideo Live est activé.

    • Vous disposez des informations requises concernant la source en direct ou VOD.

      Type de source

      Informations

      En direct

      • L'URL de lecture du flux en direct.

      • Protocoles pris en charge : RTMP, SRT et HTTP-FLV.

      VOD

      Vidéo

      • Le chemin d'URL de la source vidéo.

        Remarque

        Le chemin d'URL de la vidéo doit commencer par http:// ou https:// et se terminer par .mp4 ou .flv.
      Remarque

      • Maximum de 30 ID de ressources multimédias VOD ou chemins d'URL de source vidéo.

      • Codecs vidéo pris en charge : H.264 et H.265.

      • Codec audio pris en charge : AAC. Taux d'échantillonnage : de 16 kHz à 44,1 kHz.

      • Les sources VOD doivent utiliser le format MP4 ou FLV.

    • Une URL d'ingestion est générée à partir de votre domaine d'ingestion. Pour plus d'informations, consultez la rubrique Générer des URL de streaming.

    Procédure

    Créer une tâche

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sélectionnez une région de centre en direct.

    4. Cliquez sur Create Task.

    5. Configurez les paramètres de la tâche.

      Le tableau suivant décrit les paramètres de la tâche.

      Paramètre

      Description

      Region

      La région de la tâche. Sélectionnez-la en fonction de la région des données source ou de la région de destination.

      Remarque

      Régions prises en charge : Chine (Shanghai), Chine (Pékin), Chine (Shenzhen), Singapour et Indonésie (Jakarta).

      Task Name

      Un nom personnalisé pour la tâche.

      Task Time

      Spécifiez les heures de début et de fin pour la tâche.

      Remarque

      La tâche démarre automatiquement à l'heure de début spécifiée. Si elle s'arrête ou ne parvient pas à démarrer, cliquez sur Enable ou Restart dans la console.

      Callback Information

      Obligatoire. L'URL webhook pour les notifications d'événements de tâche.

      Source Type

      Le type de flux source. Valeurs possibles :

      • Live Stream

      • VOD Asset

      • Video Path

      Playback Times

      Nombre de boucles pour les vidéos de la liste de lecture. Sélectionnez une boucle infinie ou spécifiez un nombre.

      Remarque

      Disponible uniquement lorsque le paramètre Source Stream Type est défini sur VOD Asset ou Video Path.

      Destination Ingest URL

      L'URL de destination RTMP vers laquelle pousser le flux.

      Remarque

      Exemple d'URL d'ingestion ApsaraVideo Live :

      rtmp://ingestdomain.com//?auth_key=922353-0-0-f68cba72490a3328a1167c9**

      Paramètres selon le type de flux source :

      1. Si le paramètre Source Stream Type est défini sur Live Stream, la source prend en charge les protocoles RTMP, SRT et HTTP-FLV.

      2. Si le paramètre Source Stream Type est défini sur VOD Asset, saisissez l'ID de ressource multimédia dans la liste vidéo. Vous pouvez ajouter jusqu'à 30 vidéos, et le système les lit séquentiellement. Pour le paramètre Playback Times, sélectionnez Loop ou Specified.

      3. Si le paramètre Source Stream Type est défini sur Video Path, saisissez l'URL de la vidéo.

        Remarque

        Le chemin d'URL de la vidéo doit commencer par http:// ou https:// et se terminer par .mp4 ou .flv.

    6. Cliquez sur Submit pour créer la tâche.

    Remarque

    Vous pouvez également utiliser l'opération API CreateLivePullToPush pour créer une tâche.

    Interroger une tâche

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sélectionnez la région où vous avez créé la tâche Pulled-stream Relay. Vous pouvez ensuite effectuer une recherche par Task ID, Task Name ou Destination Ingest URL.

    Remarque

    Vous pouvez également utiliser l'opération API DescribeLivePullToPush.

    Modifier une tâche

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sur la page Pulled-stream Relay, localisez la tâche que vous souhaitez modifier et cliquez sur Edit dans la colonne Actions.

    4. Sur la page de modification, ajustez les paramètres selon vos besoins et cliquez sur Submit.

      1. Si une tâche est dans l'état Not Started, vous pouvez modifier ses paramètres Task Time, Callback Information et Source Type.

      2. Si une tâche est dans l'état Stopped, vous pouvez modifier ses paramètres Callback Information et Source Type.

      3. Si la tâche se trouve dans tout autre état, vous ne pouvez pas la modifier.

    Remarque

    Vous pouvez également utiliser l'opération API UpdateLivePullToPush.

    Supprimer une tâche

    Important

    Les tâches de relais de flux tiré ne peuvent pas être récupérées.

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sur la page Pulled-stream Relay, localisez la tâche que vous souhaitez supprimer et cliquez sur Delete dans la colonne Actions.

    4. Dans la boîte de dialogue qui s'affiche, cliquez sur Delete pour supprimer la tâche.

    Remarque

    Vous pouvez également utiliser l'opération API DeleteLivePullToPush.

    Démarrer une tâche

    Remarque

    • Seules les tâches dans l'état Stopped peuvent être activées.

    • La tâche démarre automatiquement à l'heure de début spécifiée.

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sur la page Pulled-stream Relay, localisez la tâche que vous souhaitez démarrer et cliquez sur Enable dans la colonne Actions.

    4. Dans la boîte de dialogue qui s'affiche, cliquez sur Enable pour démarrer la tâche.

    Redémarrer une tâche

    Remarque

    Seules les tâches dans l'état Running peuvent être redémarrées.

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sur la page Pulled-stream Relay, localisez la tâche que vous souhaitez redémarrer et cliquez sur Restart dans la colonne Actions.

    4. Dans la boîte de dialogue qui s'affiche, cliquez sur Restart pour redémarrer la tâche.

    Remarque

    Vous pouvez également utiliser l'opération API RestartLivePullToPush.

    Arrêter une tâche

    Remarque

    Vous pouvez Stop une tâche dont le statut est Running.

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay.

    3. Sur la page Pulled-stream Relay, localisez la tâche que vous souhaitez arrêter et cliquez sur Stop dans la colonne Actions.

    4. Dans la boîte de dialogue qui s'affiche, cliquez sur Stop pour arrêter la tâche.

    Remarque

    Vous pouvez également utiliser l'opération API StopLivePullToPush.

    FAQ

    Comment générer une URL de streaming après avoir créé une tâche ?

    L'URL de streaming pour une tâche de relais de flux tiré doit être générée en fonction du domaine de streaming associé, de l'AppName et du StreamName correspondant à l'URL d'ingestion de destination. Vous pouvez générer cette URL à l'aide du générateur d'URL dans la console ou par concaténation personnalisée.

    Une tâche de relais de flux tiré reprend-elle automatiquement si le flux source tiers se déconnecte ?

    Lorsqu'un flux source tiers se déconnecte, le statut de la tâche passe à Recovering (abnormal). Par défaut, le système tente de retiraer le flux toutes les minutes, jusqu'à trois fois.

    • Si le flux source est rétabli et que le tirage du flux réussit dans un délai de 3 minutes, le statut de la tâche passe automatiquement à Running (Normal).

    • Si les trois tentatives échouent, le statut de la tâche passe à Offline, et le système n'essaie plus automatiquement de tirer le flux. Pour redémarrer la tâche, cliquez sur le bouton Restart dans la console ou appelez l'API RestartLivePullToPush.