다국어 메타데이터

서문

해외 시청자 (또는 같은 국가 내 다국어)가있는 경우 제목 및 설명과 같은 동영상 메타 데이터를 여러 언어로 제공 할 수 있습니다.

Video Cloud는 다음의 다국어 버전을 허용합니다.

• 이미지
• 텍스트 트랙
• 이름 (통해variants )
• 설명variants )
• 자세한 설명variants )
• 사용자 지정 필드 값variants )

변형 만들기

CMS API (비디오 변형만들기 ) 를 사용하면 배열을 추가하고variants관리하여 대안을name제공할 수 있습니다. descriptionlong_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 파일 수집 (텍스트 트랙 / 캡션)