Verwalten von Audiospuren mit der CMS-API

In diesem Thema erfahren Sie, wie Sie die CMS-API zum Abrufen, Aktualisieren und Löschen der Audiospuren Ihrer Videos verwenden können.

Einleitung

Wenn Ihr Konto für mehrere Audiospuren aktiviert ist, können Sie alle oder eine bestimmte Audiospur für ein Video abrufen und auch die Metadaten für die Spur aktualisieren oder sie löschen.

Siehe auch Implementieren mehrerer Audiospuren für Informationen zum Einlesen von Audiospuren.

Anfragen authentifizieren

Anfragen an die CMS-API erfordern einen Autorisierungsheader, der Ihre Zugriffstoken enthält. Ausführliche Informationen zum Abrufen von Client-Anmeldeinformationen und deren Verwendung zum Abrufen von Zugriffstoken finden Sie im Übersicht über Brightcove OAuth.

Die Vorgänge, die Sie zum Abrufen und Aktualisieren von Videometadaten benötigen, sind video-cloud/video/all.

Sehen Überblick: CMS-API für weitere Informationen zur Authentifizierung.

Audiospuren für ein Video abrufen

Alle Tonspuren

Anfrage

  
GET
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/audio_tracks
Beispielantwort 
[
	{
		"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
	}
]

Eine Audiospur

Anfrage

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

Aktualisieren von Audiospuren

Anfrage

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

Beispielanfragetext

Beispielantwort 
{
  "language": "es-MX",
	"variant": "alternate",
	"is_default": false
}

Die folgende Tabelle zeigt die Eigenschaften der Audiospuren und gibt an, welche davon aktualisiert werden können.

Audiospurfelder
Feld Typ Beschreibung
id Zeichenfolge SCHREIBGESCHÜTZTER Wert. Besteht aus dem ursprünglichen Sprachcode und der Variante für den Titel.
duration Nummer SCHREIBGESCHÜTZTER Wert. Dauer der Audiospur in Millisekunden.
encoding_rates Array (ganze Zahlen) SCHREIBGESCHÜTZTER Wert. Kodierungsraten für die transkodierte Audiospur in KBPS
is_default Boolescher Wert Ob der Titel der Standardtitel ist, der abgespielt werden soll
language Zeichenfolge Ein ISO-Sprachcode zur Identifizierung der Sprache des Tons. Sie können Basiscodes wie fr oder Codes mit einer Gebietsschemakennung verwenden, z. fr-CA. See the ISO Language Code TableB.
variant Aufzählung Gültige Werte sind:
  • main
  • alternate
  • dub
  • commentary
  • descriptive

Löschen einer Audiospur

Anfrage

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

Bei einer erfolgreichen Anfrage wird eine Antwort von 204 NO CONTENT zurückgegeben.