Discourse Video Stream fügt eine nahtlose Cloudflare Stream-Integration hinzu, um hochqualitative, langformatige Videoinhalte und Live-Streaming auf Ihrer Discourse-Seite hochzuladen und einzubetten.
Übersicht
Dieses Plugin bietet einen kompletten Workflow für die Verarbeitung großer Videodateien mit adaptiver Bitraten-Übertragung, sodass Ihre Benutzer Videos direkt aus dem Komponisten hochladen und sie mit automatischer Qualitätsanpassung basierend auf ihren Netzwerkbedingungen wiedergeben können. Es unterstützt auch die Erstellung von Live-Streams mit RTMPS-Übertragung.
Hauptmerkmale
Komponisten-Integration: Optionale Symbolleistenschaltfläche für direkte Video-Uploads aus dem Komponisten
Automatische Upload-Abfangen: Videos, die eine konfigurierbare Größen-Schwelle überschreiten, werden automatisch an Cloudflare Stream hochgeladen, anstatt im lokalen Speicher gespeichert zu werden
Wiederaufnehmbare Uploads: Basiert auf tus-js-clientfür zuverlässige Uploads von Dateien weit über 200 MB mit automatischem Wiederaufnehmen bei Verbindungsproblemen
Sicherer Proxy: Serverseitiger Endpunkt generiert kurzlebige Cloudflare Stream-Upload-URLs, um Ihre API-Anmeldeinformationen sicher aufzubewahren
Live-Streaming: Erstellen Sie Live-Streams mit RTMPS-Übertragung direkt aus dem Komponisten
Benutzerdefiniertes BBCode: Einfache [video-stream id=\"...\"]-Syntax zum Einbetten von Videos
Adaptive Übertragung: Shaka Player-Integration mit DASH-Manifesten für reibungslose Wiedergabe bei unterschiedlichen Netzwerkgeschwindigkeiten
Wiedergabesteuerung: Eingebautes UI zur Auswahl der Auflösung und Steuerung der Wiedergabegeschwindigkeit
Installation
Fügen Sie das Plugin zu Ihrer app.yml hinzu:
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/xfalcox/discourse-video-stream.git
Bauen Sie dann Ihren Container neu:
./launcher rebuild app
Konfiguration
Navigieren Sie zu Admin → Einstellungen → Video-Streaming und konfigurieren Sie:
| Einstellung | Beschreibung | Standard |
|---|---|---|
| video_stream_enabled | Aktiviert das Video-Streaming-Plugin | false |
| video_stream_account_id | Ihre Cloudflare-Kontokennung | - |
| video_stream_api_token | API-Token mit Stream:Edit-Berechtigungen | - |
| video_stream_customer_subdomain | Ihre Cloudflare Stream-Domain (z.B. customer-xxxxx.cloudflarestream.com) | - |
| video_stream_allowed_extensions | Durch Kommas getrennte Liste der erlaubten Videoformate | mp4,webm,mov |
| video_stream_max_file_size | Maximale Dateigröße in MB (1-2000) | 500 |
| video_stream_intercept_native_uploads | Fängt große Video-Uploads automatisch ab | true |
| video_stream_intercept_threshold_mb | Schwellenwert in MB für die automatische Abfangen (1-2000) | 10 |
| video_stream_enable_live_streams | Aktiviert die Live-Streaming-Funktion | false |
Cloudflare Stream-Anmeldeinformationen erhalten
- Melden Sie sich bei Ihrem Cloudflare-Dashboard an
- Navigieren Sie unter Ihrem Konto zu Stream
- Kopieren Sie Ihre Konto-ID aus der Stream-Übersicht
- Erstellen Sie ein API-Token mit Stream:Edit-Berechtigungen
- Notieren Sie Ihre Kunden-Subdomain aus den Stream-Einstellungen
Verwendung
Nach der Konfiguration haben Benutzer zwei Möglichkeiten, Videos hochzuladen:
Automatische Abfangen
Wenn ein Benutzer eine Videodatei per Drag & Drop zieht oder auswählt, die die Einstellung video_stream_intercept_threshold_mb überschreitet, übernimmt das Plugin die Handhabung automatisch über Cloudflare Stream anstelle des lokalen Speichers. Sie müssen Videoerweiterungen in den Einstellungen für erlaubte Erweiterungen zulassen, damit dies funktioniert.
Manueller Upload
Benutzer können auf das Popup-Menü (
) der Komponisten-Symbolleiste klicken und die Option Video-Upload auswählen, um explizit auf Cloudflare Stream hochzuladen.
Beide Methoden fügen ein [video-stream id="video_id"] BBCode-Tag ein, das als adaptiver Player mit Auflösungs- und Geschwindigkeitssteuerung gerendert wird.
Live-Streaming
Wenn video_stream_enable_live_streams aktiviert ist, können Benutzer Live-Streams erstellen:
- Klicken Sie auf das Popup-Menü () der Komponisten-Symbolleiste und wählen Sie „Live-Stream erstellen“
- Ein Modal generiert RTMPS-Anmeldeinformationen über die Cloudflare Stream API
- Kopieren Sie die RTMPS-URL und den Stream-Schlüssel mit den praktischen Kopier-Schaltflächen
- Verwenden Sie die Anmeldeinformationen mit OBS, Streamlabs oder jeder RTMPS-kompatiblen Broadcast-Software
- Klicken Sie auf „Einbetten einfügen“, um den [video-stream id="…"] BBCode in Ihren Beitrag einzufügen
- Beginnen Sie sofort mit der Übertragung
Live-Stream-Funktionen:
- Automatische Aufzeichnung standardmäßig aktiviert (Streams werden zur späteren Wiedergabe gespeichert)
- Derselbe adaptive Player funktioniert sowohl für Live- als auch für aufgezeichnete Inhalte
- Benutzer sehen während des Streamings Live-Inhalte und können sich danach die Aufzeichnung ansehen
- Sichere Anmeldeinformationsverwaltung mit Warnmeldungen
Warum Cloudflare Stream?
Wir unterstützen die gleiche Funktionalität mit AWS im Code und mit Mux in GitHub - discourse/discourse-video, daher klang eine günstigere Alternative nach einer guten Idee.
Anforderungen
- Aktives Cloudflare-Konto mit aktiviertem Stream
Quelle & Support
- Repository: GitHub - xfalcox/discourse-video-stream
Screenshots
Demo
Besuchen Sie meine Testseite und laden Sie einige Videos hoch
https://discourse-on-a-pi5.falco.dev/t/test-video-upload-plugin/20?u=falco
Hinweis: Dies ist kein #offizielles Plugin.