Ce guide présente brièvement les diffusions et les diffusions. Il présente également des cas d'utilisation qui montrent comment les diffuseurs créent et gèrent ces ressources à l'aide de l'API YouTube Live Streaming.
-
Une diffusion représente un événement pouvant être visionné sur YouTube au moment où il se produit. Chaque diffusion correspond à une vidéo YouTube distincte. Une diffusion peut être et doit être associée à un seul flux.
-
Un flux vous permet de transmettre du contenu audiovisuel à YouTube et définit les paramètres de diffusion de votre contenu sur YouTube. Un même flux peut être associé à trois diffusions en direct au maximum. Il est également fréquent 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 sections suivantes présentent trois cas d'utilisation qui expliquent comment les utilisateurs d'API utilisent généralement les diffusions et les flux.
Configurer un seul encodeur
Dans le cas d'utilisation de l'API le plus courant, votre chaîne YouTube propose une série d'événements en direct planifiés ou récurrents. En tant que propriétaire de la chaîne, vous disposez d'un seul encodeur et ne souhaitez le configurer qu'une seule fois. Vous devez donc créer une ressource liveStream dans l'API, puis utiliser les paramètres de diffusion de contenu de cette ressource pour configurer l'encodeur pour la chaîne. (Si vous possédez plusieurs chaînes, vous devez créer un flux différent pour chacune d'elles.)
Vous créez ensuite 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 sur votre chaîne utilisent les mêmes paramètres de streaming. Cependant, il ne peut y avoir qu'un seul événement en direct à la fois, et le contenu vidéo de chaque diffusion est unique.
Chaque fois qu'un événement se produit, vous définissez l'état de la diffusion sur testing ou live, puis vous 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 devez créer une ressource liveStream distincte pour chaque ressource liveBroadcast, puis configurer votre encodeur pour le streaming afin d'utiliser les paramètres appropriés pour chaque diffusion.
Cette approche peut s'avérer utile si votre chaîne diffuse plusieurs diffusions de manière récurrente, de sorte que deux diffusions peuvent avoir lieu simultanément. Dans ce cas, les deux diffusions ne peuvent pas utiliser les mêmes paramètres de streaming. En fait, votre chaîne peut traiter chaque diffusion récurrente comme une émission et créer une seule ressource liveStream par émission. Ensuite, chaque épisode de la même émission représenterait une diffusion, et toutes les diffusions de la même émission pourraient être associées au même flux.
Utiliser un flux pour créer simultanément des diffusions
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 associé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 vidéo distincte pour un entretien qui se déroulera pendant cette diffusion. Dans ce cas, le contenu de l'interview est un sous-ensemble du contenu diffusé 24h/24, 7j/7.
Pour gérer ce cas de figure, vous devez créer deux ressources liveBroadcast et lier les deux diffusions au même flux. La diffusion est continue et sa ressource présente 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 sur live sans modifier la ressource de la diffusion 24h/24, 7j/7. Vous diffusez donc le même contenu sur deux vidéos distinctes en même temps.
À la fin de l'entretien, vous mettez à jour la ressource de l'entretien, en définissant cette fois son état sur complete. Cependant, vous n'arrêtez pas de diffuser la vidéo, car la diffusion se poursuit 24h/24 et 7j/7.