サポート問い合わせ先| システムステータス
ページコンテンツ

    多言語メタデータ

    このトピックでは、さまざまな言語を話す視聴者向けに、動画に多言語メタデータを追加する方法の概要を説明します。多言語メタデータは、ブライトコーブビーコン顧客ですが、一般的にVideoCloudビデオで使用できます。

    入門

    国際的なオーディエンス（または同じ国内に多言語）がいる場合は、タイトルや説明などの動画メタデータを複数の言語で提供することができます。

    Video Cloud では、次の多言語バージョンを使用できます。

    • images — ローカライズされたポスター画像とサムネイル画像は、設定されている場合、Playback API の variants 配列で返されます (下記参照)
    • テキストトラック
    • 名前 (経由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-JP",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}

    レスポンスの例

     
    {
  "language": "ja-JP",
  "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-JP",
    "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。

    変更するフィールドのみを含める必要があります。リクエストの本文フィールドは、バリアントを作成する場合と同じですが、してもいいです not 含める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応答。

    バリアントは、PlaybackAPIと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-JP",
    "name": "バーゼル：ライン川",
    "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "custom_fields": {
      "language": "Japanese"
    }
  }
]

    画像とテキストトラック

    ローカライズされたテキストトラックは、Dynamic Ingest API を使用して追加できます。詳細については、WebVTT ファイルの取り込み (テキストトラック/キャプション) を参照してください。

    ローカライズされたポスター画像とサムネイル画像は、Dynamic Ingest API を使用して取り込まれ (イメージと Dynamic Ingest API を参照)、現在では Playback API によって variants 配列内の各言語エントリでも返されます。ある言語に対してローカライズされた画像が設定されている場合、対応するバリアントには poster、thumbnail、poster_sources、thumbnail_sources の各フィールドが含まれます。ローカライズされた画像が設定されていない場合、これらのフィールドは省略され、プレーヤーはトップレベルの poster/thumbnail にフォールバックします。

    バリアントごとに返される画像 URL は、CMS API が images["poster.<lang>"] および images["thumbnail.<lang>"] として保存する値と同一であり — 別途のマッピングは不要です。

    Playback API レスポンスの例 (抜粋):

    {
  "id": "6393991831112",
  "poster": "https://.../default/poster.jpg",
  "thumbnail": "https://.../default/thumbnail.jpg",
  "variants": [
    {
      "language": "ja-JP",
      "name": "グレートブルー",
      "poster":    "https://.../ja-JP/poster.jpg",
      "thumbnail": "https://.../ja-JP/thumbnail.jpg",
      "poster_sources":    [{ "src": "https://.../ja-JP/poster.jpg" }],
      "thumbnail_sources": [{ "src": "https://.../ja-JP/thumbnail.jpg" }]
    },
    {
      "language": "fr-FR",
      "name": "Le Grand Bleu"
    }
  ]
}
    ページの最終更新日22 Sep 2021