Cette page présente l'API Live Stream. L'API Live Stream transcode les signaux en direct mezzanine dans des formats de streaming direct aux consommateurs, y compris le streaming adaptatif dynamique sur HTTP (DASH/MPEG-DASH) et le streaming HTTP en direct (HLS), pour plusieurs plates-formes d'appareils.
Vous devez d'abord créer un point de terminaison d'entrée, puis créer une ressource de canal qui transcode le signal d'entrée SRT ou RTMP en direct dans un 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.
Caractéristiques
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
Chiffrement du contenu
Écrans (images et vidéos)
Entrées et sorties compatibles
Les tableaux suivants présentent les formats d'entrée et de sortie acceptés pour 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 sorties | Formats compatibles |
|---|---|
| Protocoles | Apple HLS avec les segments fMP4 et MPEG2-TS, MPEG-DASH avec les 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 Sprite Sheet | Mosaïques JPG, images individuelles |
Consultez les configurations compatibles pour le chiffrement du 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 précises d'IAM vous permettent de contrôler ce qu'il est possible de faire avec les données multimédias et par qui.
Concepts et terminologie
Cette section fournit un glossaire des termes utiles permettant d'utiliser 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 affichages et publie des flux en direct de sortie dans certains formats à l'emplacement spécifié. Vous pouvez inclure un flux principal et un flux d'entrée de secours dans le même canal.
É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 coupures publicitaires
- Couper/Réactiver le son du flux en direct
- Insérer un écran dans la diffusion en direct
- Revenir au programme (diffusion en direct)
- Changer l'entrée de la chaîne
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 les configurations de votre flux, telles que la résolution d'entrée, le type d'entrée et le recadrage de la vidéo.
Un point de terminaison d'entrée est constitué 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.