Acquisition de vidéos avec pistes audio multilingues

Introduction

Les pistes audio en langue de vos vidéos sources peuvent être conservées dans les rendus vidéo de Video Cloud. L'ingestion de pistes audio multilingues est prise en charge via le API d'ingestion dynamique seul,

Pour des informations générales sur l'ingestion de vidéos à l'aide de l'API, veuillez consulter la section Vue d'ensemble de l'API d'ingestion dynamique.

Notes et limites

• Vous devez saisir uniquement des codes ISO 639-2 à trois lettres, en utilisant uniquement des codes de terminologie et non des codes de bibliographie .
• Si aucun code de langue fourni ne correspond à l'audio source, nous traiterons la langue par défaut et l'étiquetterons avec le code de langue fourni
• Si vous spécifiez un code de langue bibliographique et qu'il correspond à une piste source, nous attacherons le code de langue à cette piste, mais vous devez toujours toujours utiliser les codes de langue de la Terminologie .
• Lorsque plusieurs pistes sont spécifiées, default nous utiliserons la première trouvée dans la source (le cas échéant) ou la première ingérée par défaut
• Si vous spécifiez une piste non anglaise par défaut, mais qu'aucune piste n' language est fournie pour cette piste, nous la marquerons avec la mention « eng ».
• La file d'attente de traitement est limitée à 100 travaux (à moins que vous ne spécifiiez un traitement à faible priorité ). Si vous ajoutez un grand nombre de pistes audio, vous risquez d'atteindre cette limite et les demandes échoueront jusqu'à ce que la file d'attente de traitement descende en dessous de 100. Pour plus de détails, voir la stratégie de repli et de réaction .
• Tous les types de services audio ne sont pas pris en charge : seuls les types suivants peuvent être utilisés :
  • main
  • alternate
  • commentary
  • dub
  • descriptive
• Lorsque vous ajoutez des pistes principales eng > et des pistes de commentaires eng > pendant l'ingestion et que la source contient eng sans type de service audio, l'audio de la source sera manquant dans les rendus de sortie.
• Si vous incluez deux pistes avec le même code de langue variant et que vous en spécifiez une sans fournir de type de service pour l'autre, l'ingestion échouera.
• Lorsqu'une vidéo comportant une seule piste audio est remplacée par une vidéo comportant des pistes audio en plusieurs langues, la piste de la langue unique d'origine sera également incluse dans les rendus, avec son identifiant de langue d'origine.
• Il est possible d'utiliser à la fois plusieurs pistes audio dans la vidéo source et des fichiers audio supplémentaires séparés pour plusieurs pistes audio. Cependant, Video Cloud ne stocke pas les masters audio - les fichiers audio séparés utilisés comme pistes audio alternatives doivent être hébergés sur des URL publiques.
• Par défaut, les pistes audio externes seront fusionnées avec celles contenues dans la vidéo. Si vous souhaitez plutôt remplacer les pistes audio contenues dans la vidéo, vous pouvez définir l' merge_with_existing indicateur sur false.
• L'ingestion n ' échouera pas pour toute piste master qui ne fait pas partie de l'information média et cette piste sera ignorée.
• Pour l'entrée des pistes audio principales, n'importe quelle langue ou variante peut également être transmise dans l' master.audio_tracks objet. Dans ce cas, nous rechercherons cette information dans les informations sur les médias et l'ignorerons si elle n'est pas présente.
• Lorsque la langue ou la variante d'une piste n'est pas spécifiée dans la demande, nous utiliserons par défaut eng pour la langue et main pour la variante.

Utilisation de l'API Dynamic Ingest

L'acquisition d'une vidéo à l'aide de l'API d'acquisition dynamique se fait en deux étapes

1. Créer un objet vidéo dans le nuage de vidéos à l'aide de l'API CMS
2. Ingérer la vidéo à l'aide de l'API d'ingestion dynamique

https://cms.api.brightcove.com/v1/accounts/{account_id}/vidéos

{
"nom": "Titre de ma vidéo
}

https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/demandes d'ingestion

{
  "master": {
    "url": "{source_url}",
    "audio_tracks": [
      {
        "language": "eng",
        "variant": "main"
      },
      {
        "language": "spa",
        "variant": "main"
      }
    ]
  },
  "profile": "multi-platform-extended-static-with-mp4"
}

{
  "master" : {
    "url" :"{source_url}",
    "audio_tracks" : [
      {
        "langue" : "eng",
        "variante" : "principal"
      },
      {
        "langue" : "fra",
        "variante" : "principal"
      },
      {
        "langue" : "spa",
        "variante" : "principal"
      }
    ]
  },
  "profil" : "Multiplatform Extended with MP4",
  "audio_tracks" : 
    {
      "merge_with_existing" : true,
      "masters" : [
        {
          "url" : "https://some.site.com/audio/alternate-en.m4a",
          "langue" : "eng",
          "variante" : "alternate"
        },
        {
          "url" : "https://some.site.com/audio/commentary-es.m4a",
          "langue" : "spa",
          "variante" : "commentaire"
        }
    }
  ]
}

Plusieurs pistes audio dans le lecteur Brightcove

Lorsque vous intégrez une vidéo avec plusieurs pistes audio dans un lecteur Brightcove, les pistes seront disponibles à partir d'un sélecteur dans la barre de contrôle du lecteur :

Réglage de la piste audio par défaut

Vous ne pouvez pas définir la piste audio par défaut pendant l'ingestion (la première piste audio rencontrée lors du traitement sera définie comme piste par défaut). Vous pouvez toutefois modifier la piste par défaut dans Studio ou à l'aide de l'API CMS.

En studio

Pour savoir comment définir la piste audio par défaut dans Studio, reportez-vous à la section Définition de la piste audio par défaut.

Utilisation de l'API CMS

Pour savoir comment définir la piste audio par défaut à l'aide de l'API CMS, voir Mise à jour des pistes audio.

Type de service audio

Prise en charge des codecs audio Dolby (ac-3 et eac-3), y compris les métadonnées de type service audio. (Les fichiers audio AAC ne peuvent pas contenir de métadonnées de type service)

Les types de service suivants peuvent être spécifiés pour les pistes Dolby prises en charge :

• main
• music_and_effects
• visually_impaired
• hearing_impaired
• dialogue
• commentary
• emergency
• voice_over