Zum Inhalt springen

Video-Integrationen

Videos von Bunny Stream, Cloudflare Stream, Panda Video oder einem eigenen HLS in Lektion und Beitrag, nur für Personen mit Zugang. Der Link jedes Anbieters, Schritt für Schritt zum Einfügen, der Signaturschlüssel von Bunny und Cloudflare unter Einstellungen › Video-Integrationen, Prüfen und was passiert, wenn der Anbieter den Schlüssel ablehnt.

Wer seine Videos schon bei Bunny Stream, Cloudflare Stream, Panda Video oder in einem eigenen HLS hostet, muss nichts neu hochladen: Füge den Videolink in eine Videolektion oder in den Text eines Feed-Status oder eines Inhaltsbeitrags ein, und das Video läuft in Memberfy, im Player des Anbieters (HLS im eigenen Player von Memberfy).

  • Nur für Personen mit Zugang. Den Player bekommt nur, wer die Lektion oder den Beitrag sehen darf. Wer nur die Kursübersicht oder eine gesperrte Lektion sieht oder keinen Zugang zum Bereich hat, bekommt die Videoadresse nicht, weder über die API noch über den Assistenten.
  • Das Video bleibt bei deinem Anbieter. Memberfy lädt das Video nicht herunter und kopiert es nicht, und es belegt keinen Speicher der Community: Der Player spielt direkt vom Ursprung ab.
  • Mit dem Signaturschlüssel (Bunny und Cloudflare) läuft die Videoadresse nach 6 Stunden ab und spielt außerhalb der Community nicht. Siehe Geschütztes Video.
AnbieterDer Link, den Memberfy annimmtSignaturschlüssel
Bunny Streamhttps://iframe.mediadelivery.net/embed/{bibliothek}/{video} (oder /play/), oder https://video.bunnycdn.com/play/{bibliothek}/{video}Optional
Cloudflare Streamhttps://customer-{code}.cloudflarestream.com/{id}, https://iframe.videodelivery.net/{id} oder https://watch.videodelivery.net/{id}Optional
Panda Videohttps://{player}.tv.pandavideo.com.br/embed/?v={id}Nicht nötig: spielt direkt von Panda
HLSEine Adresse https://…/datei.m3u8 auf einem öffentlichen ServerNicht nötig

Die Adresse muss genau zu einem dieser Dienste gehören. Eine ähnlich aussehende Domain (etwa bunnycdn.com.andere-seite.net), ein HLS über http, eine IP, ein Port oder ein interner Server werden in der Lektion abgelehnt; in einem Beitrag bleiben sie ein einfacher Link.

Schritt für Schritt

Rolle: Eigentümer oder Administrator für die Lektion; im Feed und in Inhalten, wer im Bereich posten darf.

Bunny Stream

  1. Öffne im Bunny-Dashboard die Videobibliothek (Stream) und das Video.
  2. Kopiere den Player-Link: die Adresse https://iframe.mediadelivery.net/embed/… aus dem Einbettungscode (oder den /play/-Link).
  3. Füge den Link in Memberfy in das Videofeld der Lektion (Typ Video) oder in den Beitragstext ein.
  4. Verlangt die Bibliothek einen Token zum Abspielen (Security › Embed view token authentication), hinterlege den Schlüssel: siehe Geschütztes Video. Ohne Schlüssel spielt ein Video aus einer Bibliothek mit Token nicht.

Cloudflare Stream

  1. Öffne im Cloudflare-Dashboard Stream und das Video.
  2. Kopiere den Player-Link: https://customer-{code}.cloudflarestream.com/{id} (oder den von iframe.videodelivery.net).
  3. Füge den Link in die Lektion oder den Beitrag ein.
  4. Verlangt das Video signierte Links (Require signed URLs), hinterlege den Signaturschlüssel des Kontos (den du unter Stream › Signing keys erstellst).

Panda Video

  1. Öffne im Panda-Dashboard das Video und seinen Einbettungscode.
  2. Kopiere die Player-Adresse: https://{player}.tv.pandavideo.com.br/embed/?v={id}.
  3. Füge den Link in die Lektion oder den Beitrag ein. Panda braucht in Memberfy keinen Schlüssel: Den Schutz des Videos (erlaubte Domains und Ähnliches) richtest du in Panda selbst ein.

Eigenes HLS

  1. Kopiere die Adresse des Video-Manifests, die auf .m3u8 endet und mit https:// beginnt.
  2. Füge sie in die Lektion oder den Beitrag ein. Das Video läuft im Player von Memberfy, mit Steuerung, Vollbild und, in der Lektion, dem Fortsetzen an der Stelle, an der die Person aufgehört hat.
  3. Der Server muss öffentlich sein und das Abspielen von einer anderen Seite erlauben (CORS); Memberfy leitet das Video nicht über die eigenen Server. Antwortet er nicht oder erlaubt es nicht, zeigt der Player "Dieses Video konnte hier nicht abgespielt werden. Der Ursprungsserver hat nicht geantwortet oder erlaubt die Wiedergabe auf dieser Seite nicht." mit der Schaltfläche Videoadresse öffnen.

Geschütztes Video (Bunny und Cloudflare)

Rolle: Eigentümer oder Administrator. Verlangt die Bunny-Bibliothek oder das Cloudflare-Konto einen Token zum Abspielen, hinterlege den Signaturschlüssel der Community unter Einstellungen › Video-Integrationen (in der Gruppe Verbindungen):

AnbieterWas einfügen
Bunny StreamUnter Token authentication key den Schlüssel der Bibliothek, kopiert im Bunny-Dashboard unter Security (Embed view token authentication)
Cloudflare StreamUnter Schlüssel-ID (keyId) die ID des Schlüssels; unter Privater Schlüssel (pem oder jwk) das pem (in base64, wie Cloudflare es zurückgibt, oder als Text) oder das jwk. Mit dem jwk ist die ID optional: Es gilt dessen kid
  1. Ausfüllen und auf Schlüssel speichern klicken. Die Seite bestätigt "Schlüssel gespeichert. Prüfe ihn mit einem deiner Videos."
  2. Unter Mit einem deiner Videos prüfen den Link eines Videos desselben Anbieters einfügen und auf Prüfen klicken: Memberfy signiert den Link dieses Videos und fragt den Anbieter, ob er ihn annimmt. Angenommen, ist der Schlüssel Gültig; abgelehnt, Ungültig.
  3. Fertig: Das Video der Lektion oder des Beitrags wird jetzt signiert ausgeliefert, 6 Stunden gültig, nur an Personen, die es schon sehen durften. Wer die Player-Adresse kopiert, kann sie danach nicht abspielen.

Jeder Anbieter zeigt den Status des Schlüssels (Kein Schlüssel, Nicht geprüft, Gültig oder Ungültig) und die Letzte Prüfung.

  • Der Schlüssel ist nur schreibbar. Nach dem Speichern wird er nicht mehr angezeigt: nur die letzten 4 Zeichen (bei Cloudflare die der Schlüssel-ID). Zum Ändern Schlüssel ersetzen verwenden.
  • Schlüssel entfernen fragt "Schlüssel von Bunny Stream entfernen?" (oder von Cloudflare Stream) und löscht den Schlüssel sofort: Die Videos dieses Anbieters werden wieder unsigniert ausgeliefert und spielen nicht, wenn die Bibliothek einen Token verlangt. Lektionen und Beiträge bleiben, wie sie sind.
  • Hinterlegen, Ersetzen, Prüfen und Entfernen stehen in den Logs, ohne den Wert des Schlüssels.
  • Nur Eigentümer und Administrator sehen die Seite und die Schlüssel.

Wenn der Anbieter den Schlüssel ablehnt

Lehnt der Anbieter den Schlüssel ab (beim Prüfen oder später, weil er dort geändert wurde), sind die Videos dieses Anbieters nicht verfügbar, bis du den richtigen Schlüssel hinterlegst: Zuschauer sehen "Video nicht verfügbar" und "Sag dem Team der Community Bescheid, damit es das behebt." Eigentümer und Administrator bekommen einen Hinweis in der Glocke, höchstens einmal am Tag, der Video-Integrationen öffnet; für sie hat das nicht verfügbare Video die Schaltfläche Video-Integrationen öffnen. Videos der anderen Anbieter laufen weiter.

Mit der API und dem Assistenten

  • API: Die Videolektion nimmt diese Links in contentUrl an und liefert den fertigen Player in videoEmbed (provider, kind, src), nur an Personen, die die Lektion sehen dürfen; die Schlüssel liegen unter /api/video-integrations. Siehe Kurse › Mit der API.
  • MCP: create_lesson und update_lesson nehmen die Links an; list_video_keys, update_video_key, verify_video_key und delete_video_key (mit Bestätigung) verwalten die Schlüssel, die nie in der Antwort zurückkommen. Siehe Kurs-Tools.

Häufige Fragen

Muss ich das Video neu hochladen? Nein. Verwende den Link deines Anbieters.

Kann jemand den Link kopieren? Wer Zugang hat, sieht die Player-Adresse. Ohne Schlüssel ist es die Adresse des Anbieters; mit Schlüssel (Bunny und Cloudflare) läuft sie nach 6 Stunden ab.

Belegt das den Speicher der Community? Nein. Das Video bleibt bei deinem Anbieter. Nur ein bei Memberfy gehostetes Video zählt zum Speicher.

Und das Willkommensvideo? Bleibt bei YouTube und Vimeo. Siehe Willkommen.

Verwandte Artikel