Métadonnées multilingues

Introduction

Si vous avez un international audience (ou multilingue dans le même pays), vous souhaiterez peut-être fournir des métadonnées vidéo telles que le titre et la description en plusieurs langues.

Video Cloud autorise les versions multilingues des éléments suivants:

• images
• pistes de texte
• nom (via variants)
• la description variants)
• longue description variants)
• valeurs de champ personnalisées variants)

Créer une variante

En utilisant l' CMS API (Créer une variante vidéo), vous pouvez ajouter et gérer un tableau de variants fournir une alternative name, description, long_descriptionet carte des champs / valeurs personnalisés spécifiques à une langue.

Pour créer une variante, envoyez un POST demande au point 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"
  }
}

Obtenir des variantes

Obtenez toutes les variantes

Vous pouvez obtenir toutes les variantes d'une vidéo en envoyant un GET demande au point 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"
    }
  }
  ]

Obtenez une variante particulière

Pour obtenir une variante particulière, envoyez un GET demande au point final:

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

Ici language est le code de langue utilisé dans la variante, tel que fr-fr.

{
  "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": {
  }
}

Mettre à jour une variante

Vous pouvez mettre à jour une variante en envoyant un PATCH demande au point final:

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

Ici language est le code de langue utilisé dans la variante, tel que fr-fr.

Vous devez uniquement inclure les champs qui changent. Les champs du corps de la requête sont les mêmes que pour la création d'une variante, sauf que tu peux ne sont pas inclure language champ. (Si vous incluez le language field a VALIDATION_ERROR sera retourné.)

{
  "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"
  }
}

Supprimer une variante

Pour supprimer une variante, envoyez un DELETE demande au point final:

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

N'incluez pas de corps de requête. Une suppression réussie, renverra un 204 No Content réponse.

Les variantes peuvent être récupérées à l'aide du Playback API la CMS API. Dans le Playback API, ils sont renvoyés lorsque vous recevez une vidéo, en tant que variants tableau:

"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"
    }
  }
]

Images et pistes de texte

Des images et des pistes de texte pour d'autres langues peuvent être ajoutées à Dynamic Ingest API. Pour plus de détails, consultez les rubriques suivantes:

• Images et Dynamic Ingest API
• Acquisition de fichiers WebVTT (pistes de texte / légendes)