Ingerir videos con pistas de audio en varios idiomas

Introducción

Las pistas de audio de idioma en sus videos de origen se pueden conservar en sus representaciones de video de Brightcove. La ingestión de pistas de audio en varios idiomas se admite a través de API de ingesta dinámica solo,

Para obtener información general sobre cómo ingerir videos usando la API, consulte la descripción general de la API de ingesta dinámica .

Notas y limitaciones

• Debe ingresar solo códigos de tres letras ISO 639-2 , utilizando solo códigos de terminología y no de bibliografía .
• Cuando los códigos de idioma proporcionados no coincidan con el audio de origen, procesaremos el idioma predeterminado y lo etiquetaremos con el código de idioma proporcionado.
• Si especifica un código de idioma de bibliografía y coincide con una pista de origen, adjuntaremos el código de idioma a esa pista, pero siempre debe usar códigos de idioma de terminología .
• Cuando se especifican varias pistas como default usaremos el primero encontrado en la fuente (si lo hay) o el primero ingerido como predeterminado
• Si especifica una pista que no está en inglés como predeterminada, pero no language se proporciona para la pista, la etiquetaremos como "eng".
• Hay un límite de 100 trabajos que pueden estar en la cola de procesamiento (a menos que especifique un procesamiento de prioridad baja ). Si está agregando una gran cantidad de pistas de audio, puede alcanzar este límite y las solicitudes fallarán hasta que la cola de procesamiento caiga por debajo de 100. Consulte Estrategia de recuperación/reintento para obtener más detalles.
• No se admiten todos los tipos de servicios de audio: solo se pueden utilizar los siguientes tipos:
  • main
  • alternate
  • commentary
  • dub
  • descriptive
• Cuando agregas ing > principal e inglés > pistas de comentarios durante la ingestión y la fuente contiene un inglés sin tipo de servicio de audio, el audio de la fuente no aparecerá en las representaciones de salida.
• Si incluye dos pistas con el mismo código de idioma y especifica una como variant y no proporciona ningún tipo de servicio para el otro, la ingesta fallará.
• Cuando un video con una sola pista de audio se reemplaza por un video con varias pistas de audio en varios idiomas, la pista del único idioma original también se incluirá en las representaciones, con su identificador de idioma original.
• Tanto las múltiples pistas de audio dentro del video de origen como los archivos de audio separados adicionales se pueden usar para múltiples pistas de audio. Sin embargo, Video Cloud no almacena maestros de audio; los archivos de audio independientes que se utilizan como pistas de audio alternativas deben alojarse en direcciones URL públicas.
• De manera predeterminada, las pistas de audio externas se fusionarán con las contenidas en el video. Si, en cambio, desea reemplazar las pistas de audio contenidas en el video, puede configurar el merge_with_existing bandera a false.
• Ingest no fallará el trabajo para ninguna pista maestra que no sea parte de la información de medios y esa pista se omitirá.
• Para la entrada de pistas de audio maestras, cualquiera de los idiomas o las variantes se pueden pasar en el master.audio_tracks objeto también. En ese caso, buscaremos eso en la información de medios y lo omitiremos si no está presente.
• Cuando el idioma o la variante de una pista no se especifica en la solicitud, por defecto usaremos eng por el idioma y main para la variante.

Uso de la API de ingesta dinámica

Hay dos pasos para ingerir un video usando la API de Ingesta Dinámica

1. Cree un objeto de video en Video Cloud usando la API CMS
2. Ingerir el video usando la API de Ingesta Dinámica

https: //cms.api.brightcove.com/v1/cuentas/ {id_cuenta} /videos

{
"nombre" : "Mi título de video"
}

https: //ingest.api.brightcove.com/v1/accounts/ {id_de_cuenta} /videos/ {id_de_video} /solicitudes de ingesta

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

{
  "maestro": {
    "url": " {origen_url} ",
    "pistas_de_audio": [
      {
        "idioma": "esp",
        "variante": "principal"
      },
      {
        "idioma": "fra",
        "variante": "principal"
      },
      {
        "idioma": "spa",
        "variante": "principal"
      }
    ]
  },
  "perfil": "Multiplataforma Extendido con MP4",
  "pistas_de_audio": 
    {
      "combinar_con_existente": verdadero,
      "maestros": [
        {
          "url": "https://some.site.com/audio/alternate-en.m4a",
          "idioma": "esp",
          "variante": "alternativo"
        },
        {
          "url": "https://some.site.com/audio/commentary-es.m4a",
          "idioma": "spa",
          "variante": "comentario"
        }
    }
  ]
}

Múltiples pistas de audio en Brightcove Player

Cuando incrusta un video con varias pistas de audio en un Brightcove Player, las pistas estarán disponibles desde un selector en la barra de control del reproductor:

Configuración de la pista de audio predeterminada

No puede establecer la pista de audio predeterminada durante la ingestión (la primera pista de audio encontrada en el procesamiento se establecerá como predeterminada). Sin embargo, puede cambiar la pista predeterminada en Studio o mediante la API de CMS.

En el estudio

Para obtener instrucciones sobre cómo configurar la pista de audio predeterminada en Studio, consulte Configuración de la pista de audio predeterminada .

Usando la API de CMS

Para obtener instrucciones sobre cómo configurar la pista de audio predeterminada mediante la API de CMS, consulte Actualización de pistas de audio .

Tipo de servicio de audio

Compatibilidad con códecs de audio Dolby (ac-3 y eac-3), incluidos los metadatos del tipo de servicio de audio. (El audio AAC no puede contener metadatos de tipo de servicio).

Se pueden especificar los siguientes tipos de servicios para las pistas Dolby admitidas:

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