Überblick
Remote-Assets werden hauptsächlich über die Assets Operations hinzugefügt, mit einigen Ausnahmen, die unten aufgeführt sind. Beachten Sie, dass die GET-Operationen für Assets sowohl für aufgenommene als auch für Remote-Assets verwendet werden können.
Autorisierung
Arbeitsablauf
Hier sind die Schritte zum Einrichten eines Remote-Assets:
In den folgenden Abschnitten werden wir uns jeden dieser Schritte ansehen.
Erstelle das Video
Bevor Sie Remote-Assets hinzufügen können, müssen Sie ein Videoobjekt in Ihrer Video Cloud-Medienbibliothek erstellen, indem Sie eine POST-Anfrage verwenden, um:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
Fügen Sie im Anfragetext ein JSON-Objekt ein, das minimal den Videonamen enthält, aber möglicherweise zusätzliche Metadaten:
{
"name": "My Remote Video",
"description": "A short description of the video",
"tags": ["remote", "fall_campaign"],
"reference_id": "myUniqueReferenceID"
}
Einzelheiten zum Video-Erstellen-Vorgang finden Sie im API-Referenz.
Wiedergabeversionen hinzufügen
Fügen Sie als Nächstes eine oder mehrere Remote-Videowiedergaben in voller Länge hinzu, indem Sie eine POST-Anfrage senden an:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
Die JSON im Anforderungstext muss mindestens die Remote-URL enthalten, kann jedoch andere Metadaten für die Wiedergabe enthalten:
{
"video_duration": 31487,
"name": "RA - Great Blue Heron",
"remote_url": "//some.site.com/videos/mp4/greatblueheron.mp4",
"encoding_rate": 983000,
"frame_height": 360,
"size": 3887659,
"frame_width": 640,
"video_codec": "h264",
"video_container": "MP4",
"progressive_download": true
}
Hinweise
- Verwenden Sie diesen Endpunkt nur zum Hinzufügen von Videowiedergaben in voller Länge (normalerweise eine .mp4- oder .mov-Datei). Verwenden Sie zum Hinzufügen segmentierter Streams wie HLS oder DASH die im nächsten Abschnitt beschriebenen Manifest-Endpunkte.
-
Video Cloud überprüft die Remote-Videodateien nicht, sodass Video Cloud durch die Bereitstellung zusätzlicher Metadaten diese Informationen in Studio (oder im Brightcove-Player, wenn Sie den Player für die Anzeige der Metadaten konfigurieren) anzeigen können.
Einzelheiten zum Vorgang zum Hinzufügen einer Wiedergabe finden Sie im API-Referenz.
- Wiedergaben für Remote-Assets müssen die
video_codecundvideo_containerFelder richtig zu arbeiten. - MP4-Wiedergaben muss habe den
"progressive_download": trueFeld so eingestellt, dass es im Brightcove-Player richtig funktioniert - Gemischte Assets sind nicht zulässig. Sie können einem aufgenommenen Video keine Remote-Wiedergabe hinzufügen
- Wenn Ihr CDN oder ein anderes entferntes Repository sowohl HTTP- als auch HTTPS-Bereitstellung unterstützt, geben Sie die URL für entfernte Assets mit einer protokollneutralen URL an, wie im obigen Beispiel gezeigt (d. h. verwenden Sie "//my.domain/path/..." anstelle von "https://my.domain/path/...")
Manifeste hinzufügen
Beachten Sie, dass Sie zum Hinzufügen von segmentierten Remotetypen wie DASH- und HLS-Darstellungen nur das Video erstellen und dann die Manifeste hinzufügen müssen nicht müssen Sie "Wiedergaben hinzufügen", wie im vorherigen Abschnitt erläutert.
Sie können nicht nur Darstellungen in voller Länge hinzufügen, sondern auch Manifeste für segmentierte Darstellungen wie HLS, HDS und ISM hinzufügen, indem Sie eine POST-Anfrage an den Endpunkt für den Manifesttyp senden:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
Geben Sie im Anforderungstext-JSON die Remote-URL und einen Namen an (optional):
{
"remote_url": "https://some.site.com/avideo/hls/chickadee/chickadee.m3u8",
"name": "chickadee_hls"
}
Einzelheiten zur Verwendung der Operationen zum Hinzufügen von Manifesten finden Sie im entsprechenden Abschnitt der API-Referenz:
Poster/Miniaturansicht hinzufügen
Sie können Ihrem Video ein Remote-Poster und eine Miniaturansicht hinzufügen, indem Sie POST-Anfragen an diese Endpunkte senden:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
Im Anforderungstext-JSON müssen Sie die Remote-URL für das Bild angeben, und Sie können einen Namen hinzufügen, wenn Sie möchten:
{
"remote_url": "https://some.site.com/images/great-blue-heron-poster.png"
}
Einzelheiten zu den Vorgängen finden Sie in der API-Referenz:
Textspuren hinzufügen
Textspuren können verwendet werden, um Ihrem Video Untertitel, Kapitel und andere zeitbasierte Metadaten hinzuzufügen.
Im Gegensatz zu Wiedergabeversionen und Bildern werden Textspuren für Remote-Asset-Videos genauso behandelt wie für Videos, die in das Video Cloud-System aufgenommen wurden. Um die Textspuren tatsächlich zu einem Video hinzuzufügen, müssen Sie das Medienmodul in Studio oder das verwenden CMS API Videobetrieb aktualisieren.
Ersetzen Sie die Fernbedienung durch aufgenommene
Sie können ein Remote-Asset-Video durch ein aufgenommenes ersetzen, indem Sie eine Anfrage an die Dynamic Ingest API stellen:
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
Der einfachste Anfragetext würde so aussehen:
{
"master": {
"url": "https://host/master.mp4"
}
}
Siehe die Dynamic Ingest API-Referenz für zusätzliche Optionen und Informationen.
Eine der häufigsten Anwendungen von Remote-Asset-Videos besteht darin, ein Platzhaltervideo zur Verwendung in einem Live-Streaming-Ereignis zu erstellen. Wenn die Veranstaltung abgeschlossen ist, möchten Sie möglicherweise das "Live"-Video durch eine Video-on-Demand-Aufzeichnung der Veranstaltung ersetzen, die in demselben Player angezeigt wird, den Sie für den Livestream verwendet haben. Sie können dies mit der oben beschriebenen Methode tun, sie kann jedoch auch verwendet werden, um jedes Remote-Asset-Video in ein Video umzuwandeln, das in Video Cloud aufgenommen wird.
Assets ändern
Neben dem Hinzufügen von Remote-Assets für ein Video gibt es auch Operationen zum Abrufen, Aktualisieren und Löschen der Asset-Informationen. Diese Operationen verwenden die oben beschriebenen Endpunkte, jedoch mit GET-, PATCH- oder DELETE-Anforderungen. Bei Aktualisierungs- und Löschanforderungen müssen Sie die Asset-ID (die in der Antwort auf POST- und GET-Anfragen enthalten ist) zur Anforderungs-URL hinzufügen:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
Siehe die API-Referenz Einzelheiten zu den Abruf-, Aktualisierungs- und Löschvorgängen.