Cette page présente l'API Live Stream. L'API Live Stream transcode les signaux en direct mezzanine dans des formats de streaming adaptés à une diffusion directe auprès des consommateurs, y compris le streaming adaptatif dynamique sur HTTP (DASH/MPEG-DASH) et le streaming en direct HTTP (HLS), pour plusieurs plates-formes d'appareils.
Vous devez d'abord créer un point de terminaison d'entrée, puis une ressource de canal qui transcode le signal d'entrée SRT ou RTMP en direct en flux de sortie HLS ou DASH. Les flux de sortie créés par l'API Live Stream sont enregistrés dans des buckets Cloud Storage. Vous pouvez ensuite configurer un bucket Cloud Storage en tant que backend pour Media CDN.
Fonctionnalités
L'API Live Stream est compatible avec les fonctionnalités suivantes:
Provisionnement automatique de l'infrastructure
Intégration à Cloud Storage, Cloud Audit Logs et l'infrastructure Google Cloud
Configuration d'un flux d'entrée de sauvegarde pour la redondance
Passer du direct à la vidéo à la demande (VOD)
Chiffrement du contenu
Écrans (image et vidéo)
Entrées et sorties compatibles
Les tableaux suivants présentent les formats d'entrée et de sortie compatibles avec l'API Live Stream.
| Types d'entrée | Formats compatibles |
|---|---|
| Protocoles | SRT, RTMP |
| Codecs vidéo | H.264 (AVC) |
| Codecs audio | AAC |
| Sous-titres | CEA-608/708 intégré (passthrough) |
| Types de sortie | Formats compatibles |
|---|---|
| Protocoles | Apple HLS avec des segments fMP4 et MPEG2-TS, MPEG-DASH avec des segments fMP4 |
| Codecs vidéo | H.264 (AVC) |
| Codecs audio | AAC |
| Sous-titres | CEA-608/708 intégré (passthrough) |
| Chiffrement | AES-128, SAMPLE-AES, MPEG-CENC |
| Images de la feuille de sprites | Mosaïques JPG, images individuelles |
Consultez les configurations compatibles pour le chiffrement de contenu.
Contrôle des accès
Le modèle de contrôle des accès de l'API Live Stream est basé sur Identity and Access Management (IAM). Les autorisations IAM vous permettent de contrôler avec précision la manière dont les données multimédias peuvent être traitées, et par qui.
Concepts et terminologie
Cette section fournit un glossaire contenant des termes utiles pour l'utilisation de l'API Live Stream.
Canaux
Un canal est une ressource qui ingère le flux d'entrée via un point de terminaison d'entrée, le transcode en plusieurs interprétations et publie des flux de sortie en direct dans certains formats à l'emplacement spécifié. Vous pouvez inclure un flux d'entrée principal et de sauvegarde dans la même chaîne.
Événements de la chaîne
Un événement de canal est une sous-ressource d'un canal qui exécute des opérations sur une ressource de canal sans avoir à arrêter le canal. Les événements de canal suivants sont acceptés:
- Créer des repères de coupure publicitaire
- Couper/Réactiver le son de la diffusion en direct
- Insérer un écran dans la diffusion en direct
- Revenir au programme (diffusion en direct)
- Changer de canal
Encodeur
Un encodeur est un programme utilisé pour envoyer des flux d'entrée, tels que ffmpeg.
Points de terminaison d'entrée
Un point de terminaison d'entrée est un point de terminaison auquel votre encodeur envoie votre flux d'entrée. Vous pouvez utiliser le point de terminaison d'entrée pour spécifier des configurations pour votre flux, telles que la résolution d'entrée, le type d'entrée et le recadrage vidéo.
Un point de terminaison d'entrée se compose d'un URI RTMP ou SRT qui se présente comme suit:
rtmp://192.0.2.1/live/STREAM_ID
srt://192.0.2.1:4201?streamid=STREAM_ID
où STREAM_ID est une chaîne telle que b8ebdd94-c8d9-4d88-a16e-b963c43a953b.