ApsaraVideo Live:Relais de flux tiré

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 de tirage de flux. Sélectionnez une région en fonction de la région des données source ou de la région d'ingestion du flux. 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	Les heures de début et de fin de la tâche. Par défaut, l'heure de début est fixée à cinq minutes après l'heure actuelle, et l'heure de fin à 24 heures après l'heure de début. Le sélecteur d'heure propose des raccourcis 5 minutes, 30 minutes et 1 heure. Un raccourci ajuste l'heure de début en fonction de l'heure actuelle et conserve une heure de fin valide. 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 de rappel pour les événements de tâche de relais de flux tiré.
   Source Type	Le type de flux source. Pour plus de détails sur les paramètres, consultez cet élément de liste. Live Stream : prend en charge les protocoles de flux source RTMP, SRT et HTTP-FLV. VOD Asset : prend en charge le format vidéo MP4. S'il existe plusieurs vidéos avec le même ID vidéo, la vidéo ayant la résolution de transcodage la plus élevée est sélectionnée. Si les vidéos transcoded ont la même résolution, l'une d'elles est sélectionnée au hasard. S'il n'y a pas de vidéo transcoded, la vidéo originale est sélectionnée. Video Path
   Playback Times	Le nombre de boucles des vidéos dans la liste de lecture. Sélectionnez une boucle infinie ou spécifiez un nombre. Remarque Ce paramètre est disponible uniquement pour les sources VOD Asset ou Video Path, et contrôle Playback Times.
   Destination Ingest URL	L'URL d'ingestion de destination vers laquelle pousser le flux. Pour une source de flux en direct, rtmp:// et rtmps:// sont pris en charge. Pour une source vidéo à la demande ou de chemin vidéo, seul rtmp:// est pris en charge. Remarque Exemple d'URL d'ingestion ApsaraVideo Live : rtmp://ingestdomain.com//?auth_key=922353-0-0-f68cba72490a3328a1167c9**

   Paramètres dans Configuration du rappel :

   • Notification de changement de vidéo : ce commutateur s'affiche uniquement pour une source VOD Asset ou Video Path et est désactivé par défaut. Lorsqu'il est activé, un rappel informe votre serveur métier lorsque la source change de fichier.

   • Authentification du rappel : ce commutateur est désactivé par défaut. Lorsqu'il est activé, les requêtes de rappel incluent les en-têtes ALI-LIVE-TIMESTAMP et ALI-LIVE-SIGNATURE.

     Méthode de calcul de ALI-LIVE-SIGNATURE

     ALI-LIVE-SIGNATURE=LOWERCASE_HEX(MD5(SIGNCONTENT))
     SIGNCONTENT=PullFlowPushTaskID|ALI-LIVE-TIMESTAMP Value|Authentication KEY

     Description des champs :

     • PullFlowPushTaskID : après la création, il peut être obtenu dans la console.

     • ALI-LIVE-TIMESTAMP : l'horodatage UNIX (en secondes) au moment où la requête de rappel a été émise.

     • Authentication KEY : la clé d'authentification configurée par l'utilisateur pour l'adresse de rappel.

   • Clé d'authentification : ce champ s'affiche uniquement lorsque Authentification du rappel est activé. Saisissez de 16 à 64 caractères ASCII visibles (0x21 à 0x7e).

   Paramètres par type de flux source :

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

   2. Si 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 Playback Times, sélectionnez Loop ou Specified.

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

      Remarque

      Le chemin d'accès à l'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.

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. Ensuite, vous pouvez effectuer une recherche par terme en utilisant Task ID, Task Name ou Destination Ingest URL.

Copier une tâche

1. Dans le volet de navigation de gauche, sélectionnez Feature Management > Pulled-stream Relay pour accéder à la page Pulled-stream Relay.

2. Sélectionnez la région du centre en direct de la tâche. Localisez la tâche dans la liste des tâches et cliquez sur Copy dans la colonne Actions.

3. Sur la page de création de tâche, vérifiez ou modifiez la configuration préremplie, puis cliquez sur Submit pour créer une tâche. Les règles suivantes s'appliquent :

   • Si la tâche d'origine est Not Started, la configuration d'origine ainsi que les heures de début et de fin sont préremplies. Le nom de la tâche n'est pas prérempli.

   • Si la tâche d'origine est Running, Recovering ou Stopped, la configuration d'origine est préremplie, l'heure de début est définie à cinq minutes après l'heure actuelle et l'heure de fin d'origine est conservée. Le nom de la tâche n'est pas prérempli.

   • Si la tâche d'origine est Ended, l'action Copy n'est pas disponible.

   • Dans tous les scénarios de copie, Task Name est effacé. Si vous le laissez vide, le système génère un nom au format taskname_Timestamp.

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 Task Time, Callback URL, Playback Times, les paramètres de source modifiables dans Source Information, Callback authentication, Authentication key et Video switch notification.

   2. Si une tâche est dans l'état Stopped, vous pouvez modifier Callback URL, Playback Times, les paramètres de source modifiables dans Source Information, Callback authentication, Authentication key et Video switch notification.

   3. Dans tous les états de tâche, Region, Destination URL, Source Type et Source Protocol ne peuvent pas être modifiés. Les configurations de tâche ne peuvent pas être modifiées dans d'autres états.

Supprimer 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 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.

Démarrer 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 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

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.

Arrêter 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 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.

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 AppName et de 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 (anormal). Par défaut, le système tente de retiraer le flux toutes les minutes, jusqu'à trois fois.

• Si le flux source se rétablit 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 tiraer le flux. Pour redémarrer la tâche, cliquez sur le bouton Restart dans la console ou appelez l'API RestartLivePullToPush.