Videos und Livestreams von der eigenen Website aus über die DCAST API betreiben

Wenn Ihr Produkt bereits über eigene Seiten, Nutzer und eine eigene Datenbank verfügt, ist es ein Rückschritt, Besucher auf ein separates Video-Dashboard zu schicken. Sie möchten, dass Ihr eigener Code Videos hinzufügt, auflistet und Übertragungen startet, während die Besucher auf Ihrer Website bleiben. Dieser Artikel führt Sie mit der DCAST API durch dieses Setup, zeigt die Entscheidungen, die Sie zuerst treffen sollten, und die Fehler, auf die Sie vor dem Start prüfen sollten.

Verbinden Sie Ihre Website einmalig über die API mit DCAST; danach fügt Ihr eigener Code neue Videos hinzu und erstellt Livestreams, ohne dass Sie das DCAST-Dashboard aufrufen müssen.

Den Schlüssel auf Ihrem Server behalten und die Zuständigkeiten klären

Bevor Sie Upload-Code schreiben, entscheiden Sie, wo der API-Schlüssel liegt. Bewahren Sie den API-Schlüssel auf Ihrem Server auf und legen Sie ihn niemals in eine Seite, die Ihre Besucher laden. Jeder, der den Seitenquelltext oder das Netzwerkprotokoll öffnet, kann einen an den Browser ausgelieferten Schlüssel kopieren und von da an im Namen Ihres Kontos handeln. Speichern Sie ihn in einer Umgebungsvariablen, halten Sie ihn aus der Versionsverwaltung heraus und lassen Sie Ihren Browser nur mit Routen Ihres eigenen Backends sprechen. Diese Routen sollten prüfen, ob der Besucher hochladen darf, bevor sie die Video-API aufrufen.

Ein über die API hinzugefügtes Video gehört zu dem Konto, dem der API-Schlüssel gehört. Wenn sich mehrere Projekte einen Schlüssel teilen, landen alle Videos in einer Bibliothek und Sie können nicht erkennen, welche Inhalte zu wem gehören. Verwenden Sie nach Möglichkeit für jedes Projekt einen eigenen Schlüssel, damit Sie einen rotieren können, ohne die anderen zu beeinträchtigen, und damit ein Leck eine geringere Reichweite hat.

Ein Video aus Ihrem eigenen Code hochladen

Wenn Sie ein Video über die API hinzufügen, geben Sie ihm einen Titel, einen Dateinamen, eine Dateigröße und eine Sichtbarkeit wie public.

Jede Upload-Anfrage liefert die Adresse zurück, an die Ihre Website die Videodatei sendet, sowie eine Status-Adresse, die Ihrer Website mitteilt, wann das Video bereit zur Anzeige ist.

Die Datei selbst wird mit einer PUT-Anfrage an die zurückgegebene Upload-Adresse gesendet.

Entscheiden Sie, wer die Bytes sendet. Das Senden von Ihrem Server aus ist der einfachste Weg, um zu protokollieren und es erneut zu versuchen. Das Senden direkt aus dem Browser des Besuchers erspart Ihrem Backend das Weiterreichen großer Dateien, aber dann müssen Sie sicher sein, dass die Upload-Adresse für diesen Besucher unbedenklich offengelegt werden kann, und Sie müssen einen Tab behandeln, der auf halbem Weg geschlossen wird. Wählen Sie pro Projekt einen Ansatz, halten Sie schriftlich fest, warum Sie ihn gewählt haben, und testen Sie ihn mit einer gedrosselten Verbindung.

Der Speicherplatz für die Datei wird für Ihr Konto in dem Moment beansprucht, in dem der Upload angefordert wird, noch bevor das erste Byte der Datei übertragen wird.

Lesen Sie die Antwort auf die Upload-Anfrage, bevor Sie mit dem Senden der Bytes beginnen, und brechen Sie ab, wenn es sich um einen Fehler handelt. Eine große Datei an eine Adresse zu schicken, die Sie nie bestätigt haben, verschwendet die Zeit Ihres Besuchers und Ihre Bandbreite. Zeigen Sie eine schlichte Meldung an, wenn die Anfrage abgelehnt wird, und vermeiden Sie es, in einer engen Schleife erneut zu versuchen, denn das wiederholt nur dieselbe Ablehnung.

Messen Sie die Dateigröße auf Ihrer Seite und senden Sie genau diese Zahl. Eine Abweichung zwischen der angegebenen Größe und der tatsächlichen Datei ist ein Fehler, der sich erst bei großen Uploads zeigt. Probieren Sie daher eine kleine Datei und eine Datei von mehreren Gigabyte aus, bevor Sie dem Ablauf vertrauen.

Auf die Status-Adresse warten, bevor Sie ein Video anzeigen

Ihre Website sollte nicht in dem Moment einen Player anzeigen, in dem das PUT abgeschlossen ist. Über die Status-Adresse aus der Upload-Anfrage erfährt Ihre Website, dass das Video bereit zur Anzeige ist. Speichern Sie sie deshalb zusammen mit dem Videodatensatz in Ihrer eigenen Datenbank.

Fragen Sie mit wachsenden Abständen ab, zum Beispiel anfangs alle paar Sekunden und später alle dreißig Sekunden, und hören Sie nach einem sinnvollen Limit auf. Speichern Sie den zuletzt bekannten Zustand mit einem Zeitstempel, damit ein Neustart des Servers ein Video nicht aus den Augen verliert. Wenn das Limit erreicht ist, markieren Sie das Video in Ihrer Oberfläche als verzögert, statt einen Ladekreisel anzuzeigen, der nie endet.

Jedes Video in der Liste zeigt seinen Status, zum Beispiel ready, zusammen mit der Adresse seiner Player-Seite.

Nutzen Sie diese Liste als Sicherheitsnetz. Ein nächtlicher Job, der Ihre Datenbank mit der Liste abgleicht, erfasst jedes Video, dessen Statusabfrage verpasst wurde, etwa weil Ihr Server während des Wartens ausgefallen war. Beheben Sie die Abweichung, indem Sie Ihren eigenen Datensatz aktualisieren, nicht indem Sie die Datei erneut hochladen.

Eine Galerie aus Ihrer Bibliothek aufbauen

Ihre Website liest die Liste Ihrer Videos mit dem Status jedes einzelnen und ruft für jedes davon den fertigen Player-Code ab, sodass sie aus Ihrer DCAST-Bibliothek eine eigene Videogalerie aufbauen kann.

Die Liste Ihrer Videos enthält nur die Videos des Kontos, dem der Schlüssel gehört, niemals die Videos eines anderen Kontos.

Die Liste ist seitenweise aufgebaut und nennt die Gesamtzahl Ihrer Videos, sodass Ihre Website eine große Bibliothek seitenweise durchblättern kann.

Rufen Sie nicht bei jedem Seitenaufruf die gesamte Bibliothek ab. Speichern Sie die Liste kurzzeitig im Cache Ihres Servers, zeigen Sie Besuchern nur Videos mit dem Status ready und verwenden Sie die Gesamtzahl, um Seitenlinks zu erzeugen. Leeren Sie den Cache, wenn Ihr eigener Code ein Video hinzufügt, damit der neue Eintrag sofort erscheint.

Die Anfrage nach dem Player-Code eines Videos, das zu einem anderen Konto gehört, wird mit „nicht gefunden“ beantwortet. Behandeln Sie diese Antwort in Ihrem Code als Normalfall. Wenn sie bei einer Kennung auftritt, die Sie selbst gespeichert haben, prüfen Sie zuerst, welchen Schlüssel Ihre Umgebung verwendet, denn ein falscher Schlüssel ist eine wahrscheinlichere Ursache als ein Ausfall.

Den Player auf Ihrer Seite platzieren

Der Player-Code liegt als schlichte Adresse, als iframe-Snippet und als responsive Variante vor, die sich der Seite anpasst.

Der Player-Code ist ein iframe, den Sie auf Ihrer eigenen Seite platzieren.

Wählen Sie nach dem Layout. Verwenden Sie die responsive Variante in Artikelseiten und Kartenrastern, in denen sich die Breite mit dem Bildschirm ändert. Verwenden Sie die schlichte Adresse, wenn Sie den iframe selbst bauen möchten, zum Beispiel um ein title-Attribut hinzuzufügen, das Screenreadern hilft. Prüfen Sie die Seite vor dem Start auf einem echten Smartphone, denn ein Frame mit fester Größe ist der häufigste Grund dafür, dass ein eingebettetes Video auf Mobilgeräten kaputt aussieht.

Sie können den Player Ihrer Videos und Übertragungen mit einem kurzen Einbettungscode auf Ihrer eigenen Website platzieren.

Standardmäßig funktioniert der eingebettete Player auf jeder Website, sodass ein Partner oder ein Fan Ihre Inhalte teilen kann, ohne vorher bei Ihnen nachzufragen.

Wenn Sie Kontrolle wünschen, listen Sie die Domains auf, auf denen Ihr Player erscheinen darf, und jede andere Website wird abgewiesen.

Legen Sie die Liste nach Ihrem Ziel fest. Beschränken Sie die Liste, wenn Sie den Zugang über Ihre eigene Website verkaufen und der Player nur dort erscheinen soll. Lassen Sie die Liste leer, wenn Ihr Ziel Reichweite ist, denn dann funktioniert jede Kopie des Einbettungscodes für jeden, der ihn einfügt.

Livestreams aus Ihrem Code starten

Ihre Website erstellt über die API eine Live-Übertragung und erhält die Adressen, an die gesendet wird, zusammen mit dem Player-Code für die Seite, die die Übertragung zeigt.

Eine neue Übertragung wird mit einer RTMP-Adresse, einer SRT-Adresse und, sofern verfügbar, einer HTTPS-Adresse für WHIP geliefert.

Eine über die API erstellte Live-Übertragung wird für Ihr Konto gespeichert und hat eine eigene Einbettungsadresse für den Player.

Wählen Sie die Sendeadresse, die zu Ihrem Encoder passt. RTMP wird von nahezu jedem Desktop-Encoder und jeder Hardware-Box akzeptiert, SRT kommt mit einem verlustbehafteten Netzwerk besser zurecht, wenn Ihr Encoder es unterstützt, und WHIP ermöglicht es einem Browser, ohne zusätzliche Software zu senden. Wenn Sie keinen triftigen Grund für eine andere Wahl haben, beginnen Sie mit RTMP und wechseln Sie zu den anderen, sobald Ihre erste Übertragung funktioniert.

Führen Sie vor einer echten Veranstaltung eine zehnminütige Probe durch, die über denselben Codepfad erstellt wird, den Sie am Tag selbst verwenden. Prüfen Sie, ob der Player auf Ihrer Seite das Bild zeigt, ob der Ton vorhanden ist und ob sich Ihr Encoder wieder verbindet, nachdem Sie das Netzwerk für ein paar Sekunden getrennt haben. Speichern Sie dann die Kennung der Übertragung, damit Ihr Support-Team sie später finden kann.

Diese Prüfungen vor dem Start durchführen

Arbeiten Sie diese kurze Liste der Reihe nach ab. Erstens: Durchsuchen Sie Ihre gebauten Seiten und Ihr Browser-Netzwerkprotokoll nach dem API-Schlüssel; er darf nirgends auftauchen. Zweitens: Laden Sie eine kleine Datei, eine große Datei und eine nicht unterstützte Datei hoch und bestätigen Sie, dass jede in einem Zustand endet, den Ihre Oberfläche erklären kann. Drittens: Öffnen Sie die Galerie als nicht angemeldeter Besucher und prüfen Sie, dass unfertige Videos ausgeblendet sind. Viertens: Fordern Sie einen Player für eine nicht existierende Kennung an und bestätigen Sie, dass Ihre Seite sich ordentlich verhält, statt einen leeren Frame anzuzeigen.

Sobald diese Prüfungen bestanden sind, sehen Ihre Besucher eine einzige Website, Ihr Code besitzt den Arbeitsablauf und die Videoplattform bleibt im Hintergrund. Beginnen Sie mit einem Upload und einer Galerieseite und fügen Sie Übertragungen hinzu, sobald der erste Teil ruhig läuft.