Configurer les sous-titres et les traductions automatiques

Cette page explique comment configurer les sous-titres générés par IA et les sous-titres traduits pour une diffusion en direct.

Les sous-titres et les traductions générés par IA sont compatibles avec les flux en direct HLS et DASH.

Avant de commencer

Cette page suppose que vous avez suivi les étapes de la section Avant de commencer du guide de démarrage rapide pour les diffusions en direct HLS ou du guide de démarrage rapide pour les diffusions en direct MPEG-DASH.

Pays acceptés

Les codes de langue pour les sous-titres générés par IA sont acceptés pour chaque établissement.

Afficher les emplacements

Emplacement Codes de langue acceptés
asia-northeast1 en-US
asia-south1 en-IN
en-GB
en-US
asia-southeast1 en-US
australia-southeast1 en-AU
europe-west1 da-DK
nl-NL
en-GB
en-US
fr-FR
de-DE
it-IT
es-ES
europe-west2 en-GB
europe-west3 da-DK
nl-NL
en-GB
en-US
fr-FR
de-DE
it-IT
es-ES
northamerica-northeast1 en-CA
fr-CA
us-central1 en-US
pt-BR
es-CO
es-MX
es-US
us-east1 en-US
pt-BR
es-CO
es-MX
es-US
us-west1 en-US
pt-BR
es-CO
es-MX
es-US

La fonctionnalité de traduction générée par IA n'est disponible que sur us-west1 et europe-west1. Tous les codes de langue acceptés pour les sous-titres générés par IA sont acceptés comme codes de langue source et cible pour les traductions générées par IA.

Utilisez us-west1 ou europe-west1 pour toutes les requêtes API sur cette page.

Créer le point de terminaison d'entrée

Pour créer le point de terminaison d'entrée, utilisez la méthode projects.locations.inputs.create.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : emplacement dans lequel créer le point de terminaison d'entrée ; utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • INPUT_ID : identifiant défini par l'utilisateur pour le nouveau point de terminaison d'entrée à créer (auquel vous envoyez votre flux d'entrée). Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par [a-z0-9], et peut contenir des tirets (-) entre les caractères. Par exemple, my-input.

Corps JSON de la requête : 

{
  "type": "RTMP_PUSH"
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Copiez le OPERATION_ID renvoyé pour l'utiliser dans la section suivante.

Vérifier le résultat

Utilisez la méthode projects.locations.operations.get pour vérifier si le point de terminaison d'entrée a été créé. Si la réponse contient "done: false", répétez la commande jusqu'à ce que la réponse contienne "done: true". La création du premier point de terminaison d'entrée dans une région peut prendre jusqu'à 10 minutes.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : emplacement de votre point de terminaison d'entrée. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • OPERATION_ID : identifiant de l'opération

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.livestream.v1.Input",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID",
    "createTime": CREATE_TIME,
    "updateTime": UPDATE_TIME,
    "type": "RTMP_PUSH",
    "uri":  INPUT_STREAM_URI, # For example, "rtmp://1.2.3.4/live/b8ebdd94-c8d9-4d88-a16e-b963c43a953b",
    "tier": "HD"
  }
}

Recherchez le champ uri et copiez le INPUT_STREAM_URI renvoyé pour l'utiliser ultérieurement dans la section Envoyer le flux d'entrée.

Créer la chaîne

Pour créer le canal, utilisez la méthode projects.locations.channels.create.

Notez les points suivants dans la configuration du canal :

  • Un ElementaryStream, un TextStream, est utilisé pour les légendes.

    {
  "key": "webvtt_english_ai",
  "textStream": {
    "codec": "webvtt",
    "displayName": "English (AI captioned)",
    "languageCode": "en-US",
    "mapping": [
      {
        "inputTrack": 1 // audio track number
      }
    ]
  }
}

  • Le champ TextStream codec doit être défini sur webvtt.

  • Le champ TextStream mapping utilise inputTrack pour désigner la piste audio d'entrée à partir de laquelle générer les sous-titres. Le mappage ne doit pas inclure de champ inputCeaChannel, qui n'est utilisé que pour les sous-titres fermés fournis par l'utilisateur.

  • Définissez languageCode sur la langue parlée dans la piste audio.

  • Le flux élémentaire est utilisé pour créer un MuxStream avec la clé vtt_english_ai.

    {
  "key": "vtt_english_ai",
  "container": "vtt",
  "elementaryStreams": [
    "webvtt_english_ai"
  ],
  "segmentSettings": {
    "segmentDuration": "2s"
  }
}

    Ce flux mux est ensuite référencé dans les fichiers manifestes HLS et DASH.

    {
  "fileName": "main.m3u8",
  "type": "HLS",
  "muxStreams": [
    "mux_video_ts",
    "vtt_english_ai"
  ],
  "maxSegmentCount": 5
}

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : emplacement dans lequel créer le canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal à créer. Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par [a-z0-9], et peut contenir des tirets (-) entre les caractères.
  • INPUT_ID : identifiant défini par l'utilisateur pour le point de terminaison d'entrée
  • BUCKET_NAME : nom du bucket Cloud Storage que vous avez créé pour stocker le fichier manifeste et les fichiers de segment du flux en direct

Corps JSON de la requête :

{
  "inputAttachments": [
    {
      "key": "my-input",
      "input": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID"
    }
  ],
  "output": {
    "uri": "gs://BUCKET_NAME"
  },
  "elementaryStreams": [
    {
      "key": "es_video",
      "videoStream": {
        "h264": {
          "profile": "high",
          "widthPixels": 1280,
          "heightPixels": 720,
          "bitrateBps": 3000000,
          "frameRate": 30
        }
      }
    },
    {
      "key": "es_audio",
      "audioStream": {
        "codec": "aac",
        "channelCount": 2,
        "bitrateBps": 160000
      }
    },
    {
      "key": "webvtt_english_ai",
      "textStream": {
        "codec": "webvtt",
        "displayName": "English (AI captioned)",
        "languageCode": "en-US",
        "mapping": [
          {
            "inputTrack": 1
          }
        ]
      }
    }
  ],
  "muxStreams": [
    {
      "key": "mux_video_fmp4",
      "container": "fmp4",
      "elementaryStreams": [
        "es_video"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "mux_audio_fmp4",
      "container": "fmp4",
      "elementaryStreams": [
        "es_audio"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "mux_video_ts",
      "container": "ts",
      "elementaryStreams": [
        "es_video",
        "es_audio"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "vtt_english_ai",
      "container": "vtt",
      "elementaryStreams": [
        "webvtt_english_ai"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    }
  ],
  "manifests": [
    {
      "key": "manifest_dash",
      "fileName": "main.mpd",
      "type": "DASH",
      "muxStreams": [
        "mux_video_fmp4",
        "mux_audio_fmp4",
        "vtt_english_ai"
      ],
      "maxSegmentCount": 5
    },
    {
      "key": "manifest_hls",
      "fileName": "main.m3u8",
      "type": "HLS",
      "muxStreams": [
        "mux_video_ts",
        "vtt_english_ai"
      ],
      "maxSegmentCount": 5
    }
  ]
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Obtenir la chaîne

Vous pouvez vérifier le résultat de l'opération à l'aide du nouvel ID d'opération.

Une fois le canal créé, utilisez la méthode projects.locations.channels.get pour interroger l'état du canal.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : région où se trouve votre canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

La réponse complète contient le champ suivant :

{
  ...
  "streamingState": "STOPPED"
  ...
}

Cette réponse indique que vous pouvez maintenant démarrer le canal.

Démarrer la chaîne

Utilisez la méthode projects.locations.channels.start pour démarrer le canal. Une chaîne doit être démarrée avant de pouvoir accepter des flux d'entrée ou générer un flux de sortie.

Le démarrage du premier canal dans une région prend environ 10 minutes.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : région où se trouve votre canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour déterminer si le canal a démarré, obtenez les informations sur le canal comme précédemment. La réponse doit contenir les éléments suivants :

{
  ...
  "streamingState": "AWAITING_INPUT"
  ...
}

Envoyer le flux d'entrée

Maintenant que la chaîne est prête, envoyez un flux d'entrée au point de terminaison d'entrée pour générer la diffusion en direct. Vous pouvez télécharger un fichier MP4 (ou un autre fichier TEST_VOD_FILE) avec des sous-titres et utiliser ffmpeg pour l'envoyer au point de terminaison d'entrée.

Ouvrez une nouvelle fenêtre de terminal. Exécutez la commande suivante en utilisant le INPUT_STREAM_URI de la section Vérifier le résultat :

ffmpeg -re -stream_loop -1 -i "TEST_VOD_FILE" \
  -c:v copy -c:a aac -strict 2 -f "flv" "INPUT_STREAM_URI"

Vérifier les sous-titres dans le fichier manifeste de sortie

Exécutez la commande suivante pour afficher le contenu du fichier manifeste HLS généré :

gcloud storage cat gs://BUCKET_NAME/main.m3u8

Les sous-titres WebVTT en anglais générés par l'IA s'affichent dans le fichier manifeste de sortie, comme suit :

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub",LANGUAGE="en-US",NAME="English (AI captioned)",AUTOSELECT=YES,DEFAULT=YES,FORCED=NO,URI="vtt_english_ai/index-1.m3u8"

Arrêter la chaîne

Vous devez arrêter un canal avant de mettre à jour sa configuration.

Utilisez la méthode projects.locations.channels.stop pour arrêter le canal.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : région où se trouve votre canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Modifier la configuration du canal pour une traduction

Mettez à jour la configuration de la chaîne pour inclure les sous-titres traduits (c'est-à-dire une traduction).

Notez les ajouts suivants à la configuration du canal :

  • ElementaryStream, un TextStream, est utilisé pour les sous-titres d'une seule langue traduite.

    {
  "key": "webvtt_spanish_ai",
  "textStream": {
    "codec": "webvtt",
    "displayName": "Spanish (AI captioned)",
    "languageCode": "es-MX",
    "mapping": [
      {
        "inputTrack": 1, // audio track number
        "fromLanguageCode": "en-US" // original audio in English
      }
    ]
  }
}

  • Définissez languageCode sur la langue de traduction choisie.

  • Définissez fromLanguageCode sur la langue source d'origine de la piste audio.

  • Le flux élémentaire est utilisé pour créer un MuxStream avec la clé vtt_spanish_ai.

    {
  "key": "vtt_spanish_ai",
  "container": "vtt",
  "elementaryStreams": [
    "webvtt_spanish_ai"
  ],
  "segmentSettings": {
    "segmentDuration": "2s"
  }
}

    Ce flux mux est ensuite référencé dans les fichiers manifestes HLS et DASH.

    {
  "fileName": "main.m3u8",
  "type": "HLS",
  "muxStreams": [
    "mux_video_ts",
    "vtt_english_ai",
    "vtt_spanish_ai"
  ],
  "maxSegmentCount": 5
}

Pour mettre à jour le canal, utilisez la méthode projects.locations.channels.patch.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : emplacement dans lequel créer le canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal à créer. Cette valeur doit comporter entre 1 et 63 caractères, commencer et se terminer par [a-z0-9], et peut contenir des tirets (-) entre les caractères.

Corps JSON de la requête :

{
  "inputAttachments": [
    {
      "key": "my-input",
      "input": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID"
    }
  ],
  "output": {
    "uri": "gs://BUCKET_NAME"
  },
  "elementaryStreams": [
    {
      "key": "es_video",
      "videoStream": {
        "h264": {
          "profile": "high",
          "widthPixels": 1280,
          "heightPixels": 720,
          "bitrateBps": 3000000,
          "frameRate": 30
        }
      }
    },
    {
      "key": "es_audio",
      "audioStream": {
        "codec": "aac",
        "channelCount": 2,
        "bitrateBps": 160000
      }
    },
    {
      "key": "webvtt_english_ai",
      "textStream": {
        "codec": "webvtt",
        "displayName": "English (AI captioned)",
        "languageCode": "en-US",
        "mapping": [
          {
            "inputTrack": 1
          }
        ]
      }
    },
    {
      "key": "webvtt_spanish_ai",
      "textStream": {
        "codec": "webvtt",
        "displayName": "Spanish (AI captioned)",
        "languageCode": "es-MX",
        "mapping": [
          {
            "inputTrack": 1,
            "fromLanguageCode": "en-US"
          }
        ]
      }
    }
  ],
  "muxStreams": [
    {
      "key": "mux_video_fmp4",
      "container": "fmp4",
      "elementaryStreams": [
        "es_video"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "mux_audio_fmp4",
      "container": "fmp4",
      "elementaryStreams": [
        "es_audio"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "mux_video_ts",
      "container": "ts",
      "elementaryStreams": [
        "es_video",
        "es_audio"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "vtt_english_ai",
      "container": "vtt",
      "elementaryStreams": [
        "webvtt_english_ai"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    },
    {
      "key": "vtt_spanish_ai",
      "container": "vtt",
      "elementaryStreams": [
        "webvtt_spanish_ai"
      ],
      "segmentSettings": {
        "segmentDuration": "2s"
      }
    }
  ],
  "manifests": [
    {
      "key": "manifest_dash",
      "fileName": "main.mpd",
      "type": "DASH",
      "muxStreams": [
        "mux_video_fmp4",
        "mux_audio_fmp4",
        "vtt_english_ai",
        "vtt_spanish_ai"
      ],
      "maxSegmentCount": 5
    },
    {
      "key": "manifest_hls",
      "fileName": "main.m3u8",
      "type": "HLS",
      "muxStreams": [
        "mux_video_ts",
        "vtt_english_ai",
        "vtt_spanish_ai"
      ],
      "maxSegmentCount": 5
    }
  ]
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Vous pouvez vérifier le résultat de l'opération à l'aide du nouvel ID d'opération.

Redémarrez la chaîne et renvoyez le flux d'entrée

Comme précédemment, démarrez le canal et envoyez à nouveau le flux d'entrée.

Vérifier la traduction dans le fichier manifeste de sortie

Exécutez la commande suivante pour afficher le contenu du fichier manifeste HLS généré :

gcloud storage cat gs://BUCKET_NAME/main.m3u8

Les sous-titres WebVTT en anglais et en espagnol générés par IA s'affichent dans le fichier manifeste de sortie, comme suit :

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub",LANGUAGE="en-US",NAME="English (AI captioned)",AUTOSELECT=YES,DEFAULT=YES,FORCED=NO,URI="vtt_english_ai/index-1.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub",LANGUAGE="es-MX",NAME="Spanish (AI captioned)",AUTOSELECT=NO,DEFAULT=NO,FORCED=NO,URI="vtt_spanish_ai/index-1.m3u8"

Configurer les transcriptions générées par IA pour la distribution

Avant de configurer les sous-titres et les traductions générés par IA pour la distribution, familiarisez-vous avec la distribution des diffusions en direct vers des points de terminaison distants.

Pour distribuer des sous-titres et des traductions générés par IA à des points de terminaison distants, ne faites pas référence aux flux de texte au format webvtt qui ont été configurés précédemment lors de la création d'une chaîne avec des sous-titres générés par IA et de la mise à jour d'une chaîne pour la traduction. Les flux de texte à distribuer doivent être des sous-titres intégrés, avec le paramètre codec défini sur cea608 ou cea708.

Dans la configuration du canal, tenez compte des éléments suivants :

  • Un ElementaryStream, un TextStream, est utilisé pour les sous-titres, et un autre ElementaryStream, un TextStream, est utilisé pour la traduction.

    {
  "key": "embedded_english_ai",
  "textStream": {
    "codec": "cea608",
    "displayName": "English (AI captioned)",
    "languageCode": "en-US",
    "outputCeaChannel": "CC1", // closed caption channel that will contain AI-generated English captions
    "mapping": [
      {
        "inputTrack": 1 // audio track number
      }
    ]
  }
}

{
  "key": "embedded_spanish_ai",
  "textStream": {
    "codec": "cea608",
    "displayName": "Spanish (AI captioned)",
    "languageCode": "es-MX",
    "outputCeaChannel": "CC2", // closed caption channel that will contain AI-generated Spanish captions
    "mapping": [
      {
        "inputTrack": 1, // audio track number
        "fromLanguageCode": "en-US" // original audio in English
      }
    ]
  }
}

  • Le champ TextStream codec doit être défini sur cea608 ou cea708.

  • Le champ TextStream mapping utilise inputTrack pour désigner la piste audio d'entrée à partir de laquelle générer les sous-titres. Le mappage ne doit pas inclure de champ inputCeaChannel, qui n'est utilisé que pour les sous-titres fermés fournis par l'utilisateur.

  • Définissez outputCeaChannel sur le canal de sous-titres pour inclure les transcriptions générées par IA dans le flux de distribution.

  • Définissez languageCode sur la langue parlée dans la piste audio.

  • Les flux élémentaires sont inclus dans le champ elementaryStreams de l'objet DistributionStream.

    {
  "distributionStreams": [
    {
      "key": "ds1",
      "container": "ts", // to be used with an SRT distribution
      "elementaryStreams": [
        "es_video",
        "es_audio",
        "embedded_english_ai", // distribute both English
        "embedded_spanish_ai"  // and Spanish captions
      ]
    },
    {
      "key": "ds2",
      "container": "flv", // to be used with an RTMP distribution
      "elementaryStreams": [
        "es_video",
        "es_audio",
        "embedded_spanish_ai" // only distribute Spanish captions
      ]
    }
  ]
}

Suivez le guide de distribution de diffusions en direct vers un point de terminaison distant pour terminer la création de votre chaîne.

Configurations avancées

Définissez AutoTranscriptionConfig au niveau de la chaîne pour affiner davantage les flux de texte générés par IA en fonction de vos besoins.

Codes temporels des sous-titres

Par défaut, les sous-titres générés par IA s'affichent de manière asynchrone avec l'audio et la vidéo. Définissez le champ DisplayTiming dans AutoTranscriptionConfig sur SYNC pour les afficher de manière synchrone.

{
  "autoTranscriptionConfig": {
    "displayTiming": "SYNC"
  }
}

L'affichage synchrone des sous-titres réduit la latence de visionnage entre l'audio et le texte, mais augmente la latence globale de bout en bout du contenu multimédia.

Préréglages de qualité

Utilisez le champ QualityPreset dans AutoTranscriptionConfig pour configurer les préférences de qualité des flux de texte générés par l'IA.

Par exemple, vous pouvez réduire davantage la latence de la génération de flux de texte en définissant :

{
  "autoTranscriptionConfig" : {
    "qualityPreset": "LOW_LATENCY"
  }
}

Effectuer un nettoyage

Arrêter la chaîne

Utilisez la méthode projects.locations.channels.stop pour arrêter le canal. Vous devez arrêter la chaîne avant de pouvoir la supprimer.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : région où se trouve votre canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Arrêter le flux d'entrée

Si vous avez utilisé ffmpeg pour envoyer le flux d'entrée, la connexion est automatiquement interrompue une fois le canal arrêté.

Supprimer la chaîne

Utilisez la méthode projects.locations.channels.delete pour supprimer le canal. Vous devez supprimer le canal avant de pouvoir supprimer le point de terminaison d'entrée utilisé par le canal.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : région où se trouve votre canal. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • CHANNEL_ID : identifiant défini par l'utilisateur pour le canal

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Supprimer le point de terminaison d'entrée

Utilisez la méthode projects.locations.inputs.delete pour supprimer le point de terminaison d'entrée.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous le trouverez dans le champ Numéro du projet de la page Paramètres IAM.
  • LOCATION : emplacement de votre point de terminaison d'entrée. Utilisez l'une des régions disponibles.
    Afficher les emplacements
    • us-central1
    • us-east1
    • us-east4
    • us-west1
    • us-west2
    • northamerica-northeast1
    • southamerica-east1
    • asia-east1
    • asia-east2
    • asia-south1
    • asia-northeast1
    • asia-southeast1
    • australia-southeast1
    • europe-north1
    • europe-west1
    • europe-west2
    • europe-west3
    • europe-west4
  • INPUT_ID : identifiant défini par l'utilisateur pour le point de terminaison d'entrée

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Supprimer le bucket Cloud Storage

  1. Dans la console Google Cloud , accédez à la page du navigateur Cloud Storage.

    Accéder à la page du navigateur Cloud Storage

  2. Cochez la case à côté du bucket que vous avez créé.

  3. Cliquez sur Supprimer.

  4. Dans la boîte de dialogue qui s'affiche, cliquez sur Supprimer pour supprimer le bucket et son contenu.