Kontaktieren Sie Support
Systemstatus
Dieses Thema behandelt die Verwendung der Backlot API Inhalte in Video Cloud aufnehmen.
Einführung
Verwenden Sie die Backlot API um Inhalte programmgesteuert in die Video Cloud hochzuladen. Mit diesem Ansatz können Sie Ihr Content Management System (CMS) oder Ihre Workflows direkt in die Video Cloud-Plattform integrieren.
Du kannst den ... benutzen Backlot API zum programmgesteuerten Hochladen und Verwalten von Videos, Miniaturansichten und Untertiteldateien.
Wenn Sie Inhalte mithilfe der Backlot-API aufnehmen möchten, lesen Sie:
- Video- und Audio-Assets (für Videos und Thumbnails)
- Arbeiten mit Untertiteln
Der primäre Aufruf zum Hochladen von Dateien ("Assets" genannt) ist der /v2/assets Route.
Notiz: Fügen Sie kein Video mit einer Null hinzu external_id das heißt, ein external_id ohne Wert ("" ) oder ein Wert von "null". Solche externen Null-IDs können später nicht gesucht werden.
Video- und Audio-Assets
Wenn Sie ein Video auf hochladen Ooyala , Ooyala Transkodiert es automatisch mit den für Ihr Konto angegebenen Einstellungen und stellt die Videos für die Wiedergabe über Ihren Player zur Verfügung.
Wir empfehlen, dass Sie Videos hochladen Ooyala in H.264, aber wir unterstützen auch viele häufig verwendete Codecs.
- Erstellen Sie das Asset mit grundlegenden Eigenschaften
- Rufen Sie die "Upload-URLs" vom System ab
- Legen Sie für jede "Upload-URL" den entsprechenden Dateiblock in das System ein
Notiz: Wenn Sie jeden Chunk hochladen, signieren Sie die Anfrage nicht wie bei anderen Anfragen. Setzen Sie einfach den Chunk-Inhalt auf die genauen URLs ein. Diese URLs wurden bereits für Sie signiert.
Laden Sie URLs für neu erstelltes Asset hoch
[GET] /v2/assets/ {asset_id} /uploading_urls
Upload-Status festlegen
[PUT] / v2 / Assets / {Asset_ID} / Upload_status
{
„status“ :"hochgeladen“
}
Streams für ein Video anzeigen
Der Begriff Streams bedeutet in diesem Zusammenhang die internen Ooyala-Prozesse, die vom System gestartet werden, um Ihre Videos zu transkodieren.
[GET] / v2 / Assets / {Asset_ID} / Streams
Quelldateien für ein Video anzeigen
[GET] /v2/assets/ {asset_id} /source_file_info
URLs für automatisch generierte Vorschaubilder abrufen
[GET] / v2 / assets / {asset_id} / generate_preview_images
Laden Sie ein benutzerdefiniertes Vorschaubild hoch
[POST] / v2 / Assets / {Asset_ID} / Vorschau_Bilddateien
<Dateieinhalt>
Festlegen der Konfiguration des primären Vorschaubilds
- generated: Verwenden Sie das automatisch generierte Vorschaubild
- uploaded_file: Verwenden Sie das hochgeladene benutzerdefinierte Vorschaubild
- remote_url:: URL für das Vorschaubild
[PUT] / v2 / Assets / {Asset_ID} / Primär_Vorschau_Bild
{
"Typ": "generiert" | "uploaded_file" | "remote_url"
}
Über Metadaten
Ein Asset kann bis zu 100 Name / Wert-Paare von benutzerdefinierten Metadaten enthalten. Ein Name ist auf 128 Zeichen und sein Wert auf 2.048 Zeichen begrenzt.
Beispiele
In diesem Beispiel wird ein Video erstellt:
[POST] / v2 / Assets {
„name“ :"Honigdachs“,
"Dateiname": "Honeybadger.avi",
„asset_type“ :"Video“,
"file_size": 398422,
"chunk_size": 100000
}
Video Cloud gibt eine Antwort ähnlich der folgenden zurück:
{
„name“ :"Honigdachs“,
"Vorschau_Bild_url": null,
„asset_type“ :"Video“,
"Dauer": 0,
"embedded_code": {embedded_code},
"created_at": "2011-10-26T19: 40: 32 + 00: 00",
"time_restrictions": null,
"update_at": "2011-10-26T19: 40: 32 + 00: 00",
"external_id": null,
"Hosted_at": null,
"original_file_name": "Honeybadger.avi",
"Beschreibung": null,
"Status": "Hochladen"
}
In diesem Beispiel werden die Upload-URLs zurückgegeben:
[GET] /v2/assets/ {asset_id} /uploading_urls
Video Cloud gibt eine Antwort ähnlich der folgenden zurück:
["https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000000000-0000000099999&filesize=100000&expires=1314391791&signature=Jliypj/GtG
"https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000100000-0000000199999&filesize=100000&expires=1314391791&signature=qOjdkomEU9R9W
"https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000200000-0000000299999&filesize=100000&expires=1314391791&signature=+bT8Jft2kvN
"https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000300000-0000000398421&filesize=98422&expires=1314391791&signature=cObAITdnMx
In diesem Beispiel wird das Video als hochgeladen markiert Video Cloud So starten Sie die Verarbeitung der Datei:
[PUT] / v2 / Assets / {Asset_ID} / Upload_status
{
„status“ :"hochgeladen“
}
Video Cloud gibt eine Antwort ähnlich der folgenden zurück:
{
"status": "hochgeladen"
}
[GET] /v2/assets/ {asset_id} /source_file_info
Video Cloud gibt eine Antwort ähnlich der folgenden zurück:
{
"original_file_name": lakeside.wmv,
"source_file_url": {source_url} "
"Dateigröße": 25227886
}
Arbeiten mit Untertiteln
Sie können Videos oder Remote-Asset-Videos über die Backlot-API Untertitel hinzufügen.
Unterstützte Formate für Untertitel
| Dateierweiterung | Beschreibung |
|---|---|
| .vtt(WebVTT/) - this is the format required for HTML5 video players | WebVTT kann sowohl für eingebettete als auch für Sidecar-Untertitel in HTTP-Streaming-Formaten wie HLS und DASH verwendet werden. |
| .TTML(früher DXFP ) - wird in WebVTT konvertiert | TTML (Timed Text Markup Language-Datei). Im Allgemeinen hat eine Untertiteldatei dieses Typs die Erweiterung .dfxp (Distribution Format Exchange Profile). |
Laden Sie Untertitel hoch
[PUT] / v2 / Assets / {Asset_ID} / Closed_Captions / {Dfxp_File_Content}
Untertitel abrufen
[GET] / v2 / Assets / {Asset_ID} / Closed_Captions
Aktualisieren Sie Untertitel
[PUT] / v2 / Assets / {Asset_ID} / Closed_Captions
Geschlossene Untertitel löschen
[LÖSCHEN] / v2 / Assets / {Asset_ID} / Closed_Captions