多語言元資料

簡介

如果您有國際觀眾（或在同一國家/地區使用多種語言），則可能需要提供多種語言的視頻元數據，例如標題和說明。

Video Cloud允許以下多種語言版本：

• 圖像
• 文字軌道
• 名稱（通過variants）
• 描述variants）
• 詳細描述variants）
• 自定義字段值variants）

創建變體

使用CMS API ( 創建視頻變體 ) 您可以添加和管理一系列variants提供替代方案name , description , long_description，以及特定於語言的自定義字段/值的映射。

要創建變體，請發送POST請求端點：

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

獲取變體

獲取所有變體

您可以通過發送GET請求端點：

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

獲取特定變體

要獲得特定變體，請發送GET請求端點：

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

這裡language是變體中使用的語言代碼，例如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": {
  }
}

更新變體

您可以通過發送PATCH請求端點：

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

這裡language是變體中使用的語言代碼，例如de-DE .

您只需要包含正在更改的字段。請求正文字段與創建變體相同，除了您可以不是包括language場地 .（如果你確實包括language field A VALIDATION_ERROR將被退回。）

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

刪除變體

要刪除變體，請發送DELETE請求端點：

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

不要包含請求正文。刪除成功，會返回一個204 No Content回复。

可以使用 Playback API 和 CMS API 檢索變體。在 Playback API 中，當您獲取視頻時，它們會作為頂級返回variants大批：

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

圖片和文字軌道

可以使用Dynamic Ingest API添加替代語言的圖像和文本軌道。有關詳細信息，請參閱以下主題：

• 影像和動態內嵌 API
• 提取WebVTT文件（文本軌道/字幕）