Metadatos multilingües

Introducción

Si tiene una audiencia internacional (o multilingüe dentro del mismo país), es posible que desee proporcionar metadatos de video, como el título y la descripción, en varios idiomas.

Video Cloud permite versiones multilingües de lo siguiente:

• imagenes
• pistas de texto
• nombre (a través de variants)
• descripción variants)
• descripción larga variants)
• valores de campo personalizados variants)

Creando una variante

Utilizando el CMS API (Crear una variante de video ) puede agregar y administrar una variedad de variants para proporcionar una alternativa name , description , long_description y mapa de campos/valores personalizados específicos de un idioma.

Para crear una variante, envíe un POST solicitud al punto final:

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/

{
  "language": "ja-JA",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}

{
  "language": "ja-JA",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}

Obteniendo variantes

Obtén todas las variantes

Puede obtener todas las variantes de un video enviando un GET solicitud al punto final:

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants

[
  {
    "language": "es-ES",
    "name": "Basilea: el Rin",
    "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
    "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
    "custom_fields": {
    }
  },
  {
    "language": "de-DE",
    "name": "Basel: Der Rhein",
    "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "custom_fields": {
    }
  },
  {
    "language": "ja-JA",
    "name": "バーゼル：ライン川",
    "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "custom_fields": {
      "language": "Japanese"
    }
  }
  ]

Obtén una variante particular

Para obtener una variante en particular, envíe un GET solicitud al punto final:

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

Aquí language es el código de idioma utilizado en la variante, como de-DE.

{
  "language": "de-DE",
  "name": "Basel: Der Rhein",
  "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
  "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
  "custom_fields": {
  }
}

Actualizar una variante

Puede actualizar una variante enviando un PATCH solicitud al punto final:

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

Aquí language es el código de idioma utilizado en la variante, como de-DE.

Solo necesita incluir los campos que están cambiando. Los campos del cuerpo de la solicitud son los mismos que para crear una variante, excepto que puedes no incluir la language campo. (Si incluye el language field a VALIDATION_ERROR Será devuelto.)

{
  "name": "Basilea: el Rin",
  "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "custom_fields": {
    "language": "Spanish"
 }
}

{
  "language": "es-ES",
  "name": "Basilea: el Rin",
  "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "custom_fields": {
    "language": "Spanish"
  }
}

Eliminar una variante

Para eliminar una variante, envíe un DELETE solicitud al punto final:

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

No incluya un cuerpo de solicitud. Una eliminación exitosa, devolverá un 204 No Content respuesta.

Las variantes se pueden recuperar utilizando la API de reproducción y la API de CMS. En la API de reproducción, se devuelven cuando obtienes un video, como un nivel superior variants formación:

"variants": [
  {
    "language": "de-DE",
    "name": "Basel: Der Rhein",
    "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "custom_fields": {}
  },
  {
    "language": "ja-JA",
    "name": "バーゼル：ライン川",
    "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "custom_fields": {
      "language": "Japanese"
    }
  }
]

Imágenes y pistas de texto

Se pueden agregar imágenes y pistas de texto para idiomas alternativos utilizando la API de ingesta dinámica. Para obtener más información, consulte los siguientes temas:

• Imágenes y API de ingesta dinámica
• Ingesta de archivos WebVTT (pistas de texto / subtítulos)