Mehrsprachige Metadaten

Einleitung

Wenn Sie ein internationales Publikum haben (oder innerhalb desselben Landes mehrsprachig sind), möchten Sie möglicherweise Videometadaten wie Titel und Beschreibung in mehreren Sprachen bereitstellen.

Video Cloud ermöglicht mehrsprachige Versionen der folgenden Elemente:

• Bilder
• Textspuren
• Name (via variants)
• Beschreibung variants)
• lange Beschreibung variants)
• benutzerdefinierte Feldwerte variants)

Variante erstellen

Mit der Option CMS API(Eine Videovarianteerstellen) können Sie ein Array von hinzufügen und verwalten, variants um eine Alternative bereitzustellen name description, long_description, und Karte der benutzerdefinierten Felder/Werte, die für eine Sprache spezifisch sind.

Um eine Variante zu erstellen, sende a POST Anfrage an den Endpunkt:

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

Varianten bekommen

Holen Sie sich alle Varianten

Alle Varianten für ein Video erhalten Sie per E-Mail GET Anfrage an den Endpunkt:

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

Holen Sie sich eine bestimmte Variante

Um eine bestimmte Variante zu erhalten, senden Sie eine GET Anfrage an den Endpunkt:

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

Hier language ist der in der Variante verwendete Sprachcode, z 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": {
  }
}

Aktualisieren einer Variante

Sie können eine Variante aktualisieren, indem Sie a PATCH Anfrage an den Endpunkt:

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

Hier language ist der in der Variante verwendete Sprachcode, z de-DE.

Sie müssen nur die Felder aufnehmen, die sich ändern. Die Felder des Anforderungshauptteils sind die gleichen wie beim Erstellen einer Variante, außer dass Sie können nicht umfassen die language Feld. (Wenn Sie die language field ein VALIDATION_ERROR Wird zurückgegeben.)

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

Eine Variante löschen

Um eine Variante zu löschen, senden Sie a DELETE Anfrage an den Endpunkt:

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

Fügen Sie keinen Anfragetext ein. Bei erfolgreichem Löschen wird eine 204 No Content Antwort zurückgegeben.

Varianten können sowohl über die Playback-API als auch über die CMS-API abgerufen werden. In der Playback-API werden sie als oberste Ebene zurückgegeben, wenn Sie ein Video erhalten variants Array:

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

Bilder und Textspuren

Bilder und Textspuren für alternative Sprachen können mithilfe der Dynamic Ingest API hinzugefügt werden. Einzelheiten finden Sie in den folgenden Themen:

• Bilder und die Dynamic Ingest API
• Aufnahme von WebVTT-Dateien (Textspuren/Untertitel)