CMS API를 사용하여 오디오 트랙 관리

이 항목에서는 CMS API를 사용하여 비디오의 오디오 트랙을 가져오고 업데이트하고 삭제하는 방법을 배웁니다.

서문

계정이 여러 오디오 트랙에 대해 활성화된 경우 비디오의 전체 또는 특정 오디오 트랙을 검색하고 트랙의 메타데이터를 업데이트하거나 삭제할 수 있습니다.

또한 오디오 트랙 수집에 대한 자세한 내용은 여러 오디오 트랙 구현을 참조하십시오.

인증 요청

CMS API에 대한 요청에는 액세스 토큰이 포함된 인증 헤더가 필요합니다. 클라이언트 자격 증명을 얻고 이를 사용하여 액세스 토큰을 검색하는 방법에 대한 자세한 내용은 Brightcove OAuth 개요를 참조하십시오 .

비디오 메타데이터를 가져오고 업데이트하는 데 필요한 작업은 다음과 같습니다video-cloud/video/all .

개요 참조: 인증에 대한 자세한 내용은 CMS API를 참조하십시오.

비디오의 오디오 트랙 가져오기

모든 오디오 트랙

요청

  
GET
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/audio_tracks
  
샘플 응답
[
	{
		"id": "en_main",
		"language": "en",
		"variant": "main",
		"duration": 25588,
		"encoding_rates": [
			63000,
			96000,
			127000,
			192000
		],
		"is_default": true
	},
	{
		"id": "es_alternate",
		"language": "es",
		"variant": "alternate",
		"duration": 27328,
		"encoding_rates": [
			64000,
			96000,
			128000,
			192000
		],
		"is_default": false
	}
]

오디오 트랙 1개

요청

  
GET
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/audio_tracks/{audio_track_id}
  
샘플 응답
{
	"id": "es_alternate",
	"language": "es",
	"variant": "alternate",
	"duration": 27328,
	"encoding_rates": [
		64000,
		96000,
		128000,
		192000
	],
	"is_default": false
}

오디오 트랙 업데이트

요청

  
PATCH
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/audio_tracks/{audio_track_id}
  

샘플 요청 본문

샘플 응답
{
  "language": "es-MX",
	"variant": "alternate",
	"is_default": false
}

아래 표는 오디오 트랙 속성을 보여주고 업데이트할 수 있는 속성을 나타냅니다.

오디오 트랙 필드
필드 유형 설명
id 문자열 읽기 전용 값. 트랙의 원래 언어 코드와 변형으로 구성됩니다.
duration 번호 읽기 전용 값. 오디오 트랙의 지속 시간(밀리초)입니다.
encoding_rates 배열(정수) 읽기 전용 값. 트랜스코딩된 오디오 트랙의 인코딩 속도(KBPS)
is_default 부울 트랙이 재생될 기본 트랙인지 여부
language 스트링 오디오 언어를 식별하는 ISO 언어 코드입니다. 와 같은 기본 코드fr또는 로캘 식별자가 있는 코드 (예:) 를 사용할 수fr-CA. See the ISO Language Code Table있습니다.
variant 열거형 유효한 값은 다음과 같습니다.
  • main
  • alternate
  • dub
  • commentary
  • descriptive

오디오 트랙 삭제

요청

  
DELETE
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/audio_tracks/{audio_track_id}
  

성공적인 요청은 204 NO CONTENT 응답을 반환합니다.