API YouTube Live Streaming – Comprendre les diffusions et les diffusions

Ce guide présente brièvement les diffusions et les diffusions. Elle aborde également des cas d'utilisation montrant comment les diffuseurs utilisent l'API YouTube Live Streaming pour créer et gérer ces ressources.

  • Une diffusion correspond à un événement pouvant être regardé sur YouTube en temps réel. Chaque diffusion est une vidéo YouTube distincte. Une diffusion peut être et doit être liée à un seul flux.

  • Un flux vous permet de transmettre du contenu audio-vidéo à YouTube. Il définit les paramètres de diffusion de votre contenu sur YouTube. Le même flux peut être associé à trois diffusions en direct au maximum. De plus, il arrive souvent que les diffuseurs réutilisent le même flux pour de nombreuses diffusions différentes si celles-ci ont lieu à des moments différents.

Les autres sections présentent trois cas d'utilisation qui expliquent comment les utilisateurs de l'API utilisent généralement les diffusions et les flux.

Configurer un seul encodeur

Dans le cas d'utilisation le plus courant de l'API, votre chaîne YouTube comporte une série d'événements en direct programmés ou récurrents. En tant que propriétaire de la chaîne, vous disposez d'un seul encodeur et vous ne souhaitez le configurer qu'une seule fois. Vous allez donc effectuer les étapes suivantes:

  1. Créez une ressource liveStream dans l'API.
  2. Utilisez les paramètres de diffusion de contenu de cette ressource pour configurer l'encodeur pour le canal.

    3. Sachez que si vous possédez plusieurs chaînes, vous devez créer un flux différent pour chacune d'elles.

  3. Créez des ressources liveBroadcast dans l'API et liez toutes ces ressources à la ressource liveStream. Dans ce scénario, tous les événements en direct que vous programmez pour votre chaîne utilisent les mêmes paramètres de streaming. Cependant, un seul événement est en direct à la fois, et le contenu vidéo de chaque diffusion est unique.
  4. Chaque fois qu'un événement se produit, définissez l'état de la diffusion sur testing ou live, puis diffusez cet événement sur YouTube.

Créer un flux par diffusion

Une autre approche courante consiste à créer un flux distinct pour chaque diffusion. Dans ce scénario, vous allez créer une ressource liveStream distincte pour chaque ressource liveBroadcast, puis configurer votre encodeur de streaming pour qu'il utilise les paramètres appropriés pour chaque diffusion.

Cette approche peut s'avérer judicieuse si votre chaîne comporte plusieurs diffusions récurrentes, de sorte que deux diffusions peuvent avoir lieu simultanément. Il est donc impossible d'utiliser les mêmes paramètres de streaming pour les deux. En fait, votre chaîne peut traiter chaque diffusion récurrente comme une émission et ne créer qu'une seule ressource liveStream par émission. Chaque épisode d'une même émission correspond alors à une diffusion, et toutes les diffusions de la même émission peuvent être associées au même flux.

Créer des diffusions simultanées à l'aide d'un seul flux

Dans ce scénario, vous souhaitez diviser une diffusion en direct en plusieurs diffusions simultanées. Ainsi, vous disposez d'une ressource liveStream qui est liée à au moins deux ressources liveBroadcast dont l'état est live en même temps.

Par exemple, supposons que votre chaîne diffuse un flux en direct 24h/24 et 7j/7, mais que vous souhaitiez également créer une autre vidéo pour une interview qui a lieu pendant cette diffusion. Dans ce cas, le contenu de l'interview est un sous-ensemble du contenu de l'émission 24h/24, 7j/7.

Pour gérer ce cas de figure, vous devez créer deux ressources liveBroadcast et associer les deux diffusions au même flux. La diffusion 24h/24, 7j/7 est en cours, et la ressource associée est à l'état live bien avant le début de l'entretien. Lorsque l'entretien commence, vous mettez à jour l'état de la ressource associée à l'entretien en le définissant sur live, sans modifier la ressource de la diffusion 24h/24, 7j/7. Vous diffusez le même contenu en streaming sur deux vidéos distinctes en même temps.

À la fin de l'entretien, vous mettez à nouveau à jour la ressource associée à la diffusion de l'interview, en définissant cette fois son état sur complete. Cependant, vous n'arrêtez pas la diffusion de la vidéo, car la diffusion 24h/24 et 7j/7 se poursuit.