Übersicht
Remote-Assets werden hauptsächlich über die Asset-Vorgänge hinzugefügt, mit ein paar Ausnahmen, die unten aufgeführt sind. Beachten Sie, dass die GET Vorgänge für Assets sowohl für aufgenommene als auch für Remote-Assets verwendet werden können.
Autorisierung
Workflow
Hier sind die Schritte zum Einrichten eines Remote-Assets:
In den folgenden Abschnitten werden wir uns jeden dieser Schritte ansehen.
Erstellen Sie das Video
Bevor Sie Remote-Assets hinzufügen können, müssen Sie ein Video-Objekt in Ihrer Video Cloud-Medienbibliothek erstellen, indem Sie die POST-Anfrage verwenden, um:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
Fügen Sie im Anfragetext ein JSON-Objekt ein, das den Videonamen minimal enthält, aber zusätzliche Metadaten enthalten kann:
{
"name": "My Remote Video",
"description": "A short description of the video",
"tags": ["remote", "fall_campaign"],
"reference_id": "myUniqueReferenceID"
}
Einzelheiten zum Erstellen von Video finden Sie in der API-Referenz.
Formatvarianten hinzufügen
Fügen Sie als Nächstes eine oder mehrere Remote-Videowiedergaben in voller Länge hinzu, indem Sie eine POST-Anfrage an folgende Stelle stellen:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
Der JSON im Anforderungsteil 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": "//learning-services-media.brightcove.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 Manifestendpunkte.
-
Video Cloud überprüft die Remote-Videodateien nicht. Wenn Sie also zusätzliche Metadaten bereitstellen, kann Video Cloud diese Informationen in Studio anzeigen (oder im Brightcove Player, wenn Sie den Player für die Anzeige der Metadaten konfigurieren).
Einzelheiten zum Vorgang zum Hinzufügen von Formatvariante finden Sie in der API-Referenz.
- Renditionen für Remote-Assets müssen die haben
video_codec
undvideo_container
Felder, um richtig zu arbeiten. - Bei MP4-Formatvarianten muss das
"progressive_download": true
Feld festgelegt sein, damit es im Brightcove Player ordnungsgemäß funktioniert - Gemischte Assets sind nicht zulässig - Sie können einem aufgenommenen Video keine Remote-Wiedergabe hinzufügen
- Wenn Ihr CDN oder ein anderes Remote-Repository sowohl die HTTP- als auch die HTTPS-Bereitstellung unterstützt, geben Sie die URL für Remote-Assets mit einer protokollneutralen URL an, wie im obigen Beispiel gezeigt (dh verwenden Sie „//my.domain/path/...“ anstelle von "http://my.domain/path/...“)
Manifeste hinzufügen
Beachten Sie, dass Sie zum Hinzufügen von remote segmentierten Typen wie DASH- und HLS-Formatvarianten nur das Video erstellen und dann die Manifeste hinzufügen müssen - Sie müssen keine „Formatvarianten hinzufügen“, wie im vorherigen Abschnitt beschrieben.
Zusätzlich zum Hinzufügen von Formatvarianten in voller Länge können Sie auch Manifeste für segmentierte Formatvarianten wie HLS, HDS und ISM hinzufügen, indem Sie eine POST-Anfrage an den Endpunkt für den Manifesttyp stellen:
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 Anfragetext JSON die Remote-URL und einen Namen an (optional):
{
"remote_url": "http://learning-services-media.brightcove.com/avideo/hls/chickadee/chickadee.m3u8",
"name": "chickadee_hls"
}
Einzelheiten zur Verwendung der Add-Manifest-Vorgänge finden Sie im entsprechenden Abschnitt der API-Referenz:
Poster/Thumbnail hinzufügen
Sie können Ihrem Video ein Remote-Poster und ein Miniaturbild hinzufügen, indem Sie POST-Anfragen an diese Endpunkte stellen:
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 Anfragetext 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": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
}
Einzelheiten zu den Vorgängen finden Sie in der API-Referenz:
Hinzufügen von Textspuren
Textspuren können verwendet werden, um Ihrem Video Untertitel, Kapitel und andere zeitbasierte Metadaten hinzuzufügen.
Im Gegensatz zu Wiedergaben und Bildern werden Textspuren für Remote-Asset-Videos genauso behandelt wie für Videos, die in das Video Cloud-System aufgenommen werden. Um die Textspuren tatsächlich zu einem Video hinzuzufügen, müssen Sie das Medienmodul in Studio oder das verwenden CMS API Videobetrieb aktualisieren.
Remote ersetzen mit aufgenommenen
Sie können ein Remote-Asset-Video durch ein aufgenommenes Video 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": "http://host/master.mp4"
}
}
Weitere Optionen und Informationen finden Sie in der Dynamic Ingest-API-Referenz .
Eine der häufigsten Anwendungen von Remote-Asset-Videos besteht darin, ein Platzhaltervideo für die Verwendung in einem Live-Streaming-Ereignis zu erstellen. Sobald das Ereignis abgeschlossen ist, möchten Sie möglicherweise das „Live“ -Video durch eine Video-on-Demand-Aufzeichnung des Ereignisses ersetzen, das in demselben Player angezeigt wird, den Sie für den Live-Stream verwendet haben. Sie können dies tun, indem Sie die oben beschriebene Methode verwenden, obwohl sie auch verwendet werden kann, um jedes Remote-Asset-Video in ein Video Cloud aufgenommenes Video umzuwandeln.
Vermögenswerte ändern
Neben dem Hinzufügen von Remote-Assets für ein Video gibt es auch Vorgänge zum Abrufen, Aktualisieren und Löschen der Asset-Informationen. Diese Vorgänge verwenden die oben beschriebenen Endpunkte, jedoch mit GET, PATCH oder DELETE Requests. Für Aktualisierungs- und Löschanfragen müssen Sie die Asset-ID (die in der Antwort auf POST- und GET-Anfragen enthalten ist) hinzufügen, um die URL anzufordern:
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
In der API-Referenz finden Sie Einzelheiten zu den Ablage-, Aktualisierungs- und Löschvorgängen.