使用 CMS API 管理音軌

在本主題中，您將學習如何使用 CMS API 獲取、更新和刪除視頻的音軌。

簡介

如果您的帳戶啟用了多個音軌，您可以檢索視頻的所有或特定音軌，還可以更新音軌的元數據，或將其刪除。

有關攝取音軌的信息，另請參閱 實施多個音軌 。

驗證請求

對 CMS API 的請求需要一個包含您的訪問令牌的授權標頭。如需有關如何取得用戶端認證並使用它們來擷取存取權杖的詳細資訊，請參閱 Brightcove OAuth 概觀。

您需要獲取和更新視頻元數據的操作是video-cloud/video/all .

看到概述：內容管理系統接口有關身份驗證的更多詳細信息。

獲取視頻的音軌

所有音軌

請求

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

一個音軌

請求

  
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 響應。