Support Kontaktieren Sie Support | Systemstatus Systemstatus
Inhalt der Seite

    Remote-Assets

    In diesem Thema erfahren Sie, wie Sie mithilfe der CMS-API Remote-Assets, einschließlich Videos, Wiedergaben, Manifeste, Bilder und WebVTT-Textspuren, zu Video Cloud hinzufügen. In diesem Thema wird erläutert, wie Sie das Video einrichten und dann Remote-Assets hinzufügen, aktualisieren und entfernen.

    Ü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:

    <img class="bcls-image—no-border“ alt="Remote-Anlagen-Workflow“ src=“ /assets/images/cms/managing-videos/remote-assets-workflow.svg „“/>
    Workflow für Remote-Ressourcen

    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

    1. 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.
    2. 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.

    3. Renditionen für Remote-Assets müssen die haben video_codec und video_container Felder, um richtig zu arbeiten.
    4. Bei MP4-Formatvarianten muss das "progressive_download": true Feld festgelegt sein, damit es im Brightcove Player ordnungsgemäß funktioniert
    5. Gemischte Assets sind nicht zulässig - Sie können einem aufgenommenen Video keine Remote-Wiedergabe hinzufügen
    6. 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.

    Einschränkungen

  • SSAI wird für Remote-Assets nicht unterstützt.
  • DRM wird nur unterstützt, wenn Sie den Player für die Kommunikation mit dem DRM-Lizenzserver anpassen können. Dies ist mit dem Brightcove Player über ein Plugin möglich. Für andere Spieler müssen Sie die Spielerdokumentation konsultieren.
  • Analytics: Das Brightcove Analytics-System hängt von systemgenerierten Video-Metadaten ab, z. B. der Videodauer. Analysedaten für Remote-Assets sind weniger reich, es sei denn, Sie können diese Metadaten für das Remote-Asset bereitstellen.
  • Wiedergabegarantie: Alle in Video Cloud aufgenommenen Videos können im Brightcove Player wiedergegeben werden. Dies gilt für fast alle Remote-Assets, aber es gibt einige Edge-Fälle, in denen Videos möglicherweise nicht abgespielt werden. Es gibt ein paar erweiterte Funktionen von DASH und HLS, die wir zum Beispiel noch nicht unterstützen. Bei Nicht-BrightCove Playern müssen Sie überprüfen, ob das Videoformat von diesem Player vollständig unterstützt wird.

  • Seite zuletzt aktualisiert am 28 Sep 2020