ComusThumbz Documentation
Admin Login

Live video streaming setup

Wat deze pagina doet

Deze gids helpt u bij het opzetten van de live video streaming functie op uw ComusThumbz site. Eenmaal geconfigureerd, kunnen uw makers live video rechtstreeks uitzenden van hun browsers naar hun fans, met real-time chat, fooien en privé shows. Denk eraan als het opzetten van uw eigen persoonlijke Twitch of OnlyFans live streaming platform.

[Screenshot: live-streaming-overview]


Waarom heb je dit nodig?

De live streaming functie laat makers op uw site toe om:

  • Ga rechtstreeks vanuit hun browser live (geen speciale software nodig)
  • Stream video met zeer lage vertraging (onder 1 seconde)
  • Chat met kijkers in real-time
  • Tips ontvangen tijdens hun stream
  • Aanbieden prive een-op-een shows
  • Controle die kan kijken (gratis, abonnees alleen, pay-per-view, enz.)

Voor kijkers kunnen zij:

  • Bekijk makers live uitgezonden
  • Berichten versturen in chat
  • Stuur tips naar makers
  • Vraag privé shows aan


Voordat u begint

Waarschuwing:
Live streaming vereist een dedicated server of VPS (Virtual Private Server). Het zal NIET werken op gedeelde hosting zoals GoDaddy of Bluehost's basisplannen. Je hebt root toegang nodig om software op de server te installeren.

Wat je nodig hebt.

  1. Een aparte server of VPS - Dit kan dezelfde server zijn waar ComusThumbz is geïnstalleerd, of een andere. Minimum 2GB RAM, 2 CPU cores aanbevolen.
  2. Een domein of subdomein - Iets als streaming.yoursite.com
  3. Ongeveer 30-60 minuten - Voor het installatieproces
  4. Basiscomfort met een opdrachtregel - U moet enkele commando's uitvoeren op uw server

Controleren of je er klaar voor bent

Log in op uw server via SSH en voer deze commando's uit:

# Check if Docker is installed
docker --version

Controleer het publieke IP van uw server


curl -s ifconfig.me

Als Docker niet is geïnstalleerd, maak je geen zorgen - het setup script kan het voor u installeren.


Inzicht in de opstelling

Hoe Live Streaming werkt

Creator's Browser -> Streaming Server -> Viewers' Browsers
  1. Een maker opent de "Go Live" pagina op uw site
  2. Hun webcam en microfoon verbinden met uw streaming server
  3. De streamingserver stuurt de video naar alle kijkers die kijken
  4. Iedereen kan chatten en tips sturen in real-time

Wat wordt geïnstalleerd

Het installatieproces installeert LiveKit, dat is de streaming server software. Het draait in een Docker container (denk aan het als een zelfstandige mini-computer) op uw server en behandelt alle video routing.


Installatiestappen

Stap 1: Kies uw installatiemethode

Er zijn twee manieren om de streaming server op te zetten:

Optie A: Geautomatiseerde installatie (aanbevolen) Een script doet alles voor je.
Optie B: handmatig instellen - U voert elk commando zelf uit (voor geavanceerde gebruikers)

Voor de meeste mensen raden wij optie A aan.


Optie A: Automatisch instellen (Gemakkelijkste)

1. Upload het instellingenscript

  1. Download het setupscript van uw installatiemap ComusThumbz: tools/setuplivekitserver.sh
  2. Upload het naar uw streaming server (u kunt het in uw home directory zetten)

2. Maak het Script uitvoerbaar

Log in op uw server via SSH en voer uit:

chmod +x setuplivekitserver.sh

3. Voer het instellingenscript uit

sudo ./setuplivekitserver.sh

Het script zal je een paar vragen stellen en dan:

  • Installeer Docker indien nodig
  • Uw firewall instellen
  • De streamingserver instellen
  • Beveiligingssleutels genereren

4. Bewaar uw geloofsbrieven

Aan het eind zal het script je iets laten zien als:

API Credentials:
  API Key: APIxxxxxxxxxxxxxxxx
  API Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Waarschuwing:
Kopieer deze referenties en bewaar ze ergens veilig! Je hebt ze nodig in de volgende sectie.

5. Test de installatie

Het script zal je vertellen of alles werkt. Je zou een bericht moeten zien waarin staat: "LiveKit draait succesvol."


Optie B: handmatige installatie (geavanceerd)

Als u de installatie handmatig wilt doen of het geautomatiseerde script niet werkt voor uw server, volg dan de gedetailleerde handmatige installatiestappen in de technische handleiding.

Tip:
De handmatige stappen zijn in wezen dezelfde dingen die het geautomatiseerde script doet, gewoon onderverdeeld in individuele commando's. Gebruik dit alleen als u comfortabel bent met serverbeheer.


ComusThumbz verbinden met de Streaming Server

Nu je streaming server draait, moet je je ComusThumbz installatie vertellen hoe je ermee verbinding moet maken.

Stap 1: Schakel de functie in

  1. Log in op uw beheerderspaneel
  2. Ga naar Beheerpaneel > Instellingen > Aan/uit
  3. Zoeken Live Streaming en zet het aan
  4. Klik Wijzigingen opslaan

Stap 2: Voeg uw streaming serverdetails toe

U moet drie stukjes informatie toevoegen aan uw configuratiebestand.

  1. Log in op uw webserver via SFTP of File Manager
  2. Navigeren naar ct/dat/config.inc.php
  3. Bestand openen om te bewerken
  4. Voeg deze regels toe aan het einde van het bestand (voor de sluiting ?> als er één is:
// LiveKit WebRTC Streaming Configuration
define('LIVEKITHOST', 'wss://streaming.yoursite.com/livekit/');
define('LIVEKITAPIKEY', 'paste-your-api-key-here');
define('LIVEKITAPISECRET', 'paste-your-api-secret-here');
  1. De waarden vervangen:
  • streaming.yoursite.com - Uw streaming server domein
  • paste-your-api-key-here - De API Key van stap 4 van de installatie
  • paste-your-api-secret-here - Het API geheim van stap 4 van de installatie
  1. Bestand opslaan

Tip:
Voor LIVEKIT
HOSTGebruik wss:// (veilig WebSocket) als u SSL/HTTPS op uw site. Als je gewoon test op een lokaal netwerk, kun je ws:// gevolgd door het IP-adres van uw server en :7880.

Stap 3: Controleren Het werkt.

  1. Log in op uw site als gebruiker die toegang heeft tot de maker
  2. Ga naar Mijn account > Ga Live (in uw gebruikersinstellingen)
  3. Je zou de "Go Live" pagina met webcam opties moeten zien
  4. Als u in plaats daarvan een foutmelding ziet, is er iets niet correct geconfigureerd

Uw installatie testen

Volledige streamingtest

Volg deze stappen om te controleren of alles werkt:

1. Maak een Creator-account aan

Je hebt een account nodig met maker privileges om te testen.

  1. Ga naar Beheerpaneel > Gebruikers > Gebruikersbeheer
  2. Zoek de gebruiker waarmee u wilt testen
  3. Klik Bewerken
  4. Zorg ervoor Is Maker is ingesteld op Ja.
  5. Opslaan

2. Start een teststroom

  1. Aanmelden als maker
  2. Ga naar Mijn account > Ga Live
  3. Vul een streamtitel in (zoals "Teststroom")
  4. Toegang instellen op Vrij Zodat iedereen kan kijken.
  5. Klik Streaming starten
  6. Wanneer uw browser vraagt om camera / microfoon toestemming, klik Toestaan
  7. U zou uw webcam preview op het scherm moeten zien

3. Bekijk de stroom als een kijker

  1. Open een andere browser (of incognito/privé venster)
  2. Bezoek uw site en ga naar Levende stroom in het hoofdmenu
  3. Je zou je teststream moeten zien.
  4. Klik erop om te kijken
  5. De video moet binnen 1-2 seconden verschijnen

4. Test het gesprek

  1. Typ in het venster van de kijker een bericht in het dialoogvenster en druk op Enter
  2. Het bericht moet zowel in het venster van de kijker als in het venster van de omroep verschijnen
  3. Dit bevestigt dat real-time communicatie werkt

5. Eindig de stroom

  1. Terug in het omroepvenster, klik Eindstroom
  2. De stroom moet verdwijnen van de Live Streams pagina
  3. De kijker moet een bericht zien dat de stroom is afgelopen

Succes:
Als alle vijf stappen werkten, gefeliciteerd! Je live streaming is volledig operationeel.


Waar makers en kijkers gaan

Voor makers (Broadcasters)

Ga live pagina: Instellingen > Ga Live

Op deze pagina kunnen makers:

  • Selecteer hun camera en microfoon
  • Stel een titel en beschrijving in voor hun stream
  • Kies wie kan kijken (gratis, wachtwoord beveiligd, abonnees alleen, pay-per-view, of tip doel)
  • Zie hun aantal kijkers
  • Lees en reageer op chatberichten
  • Zie tipmeldingen
  • Privé showverzoeken accepteren of weigeren

Voor kijkers

Stroommap: Live Streams (in de hoofdnavigatie)

Deze pagina toont:

  • Alle actieve stromen als een raster van voorbeeldkaarten
  • Aantal kijkers die elke stream bekijken
  • Profielfoto en naam van de maker

Streampagina bekijken: Klik op een stream opent de weergavepagina

Op deze pagina kunnen kijkers:

  • Bekijk de live video
  • Chat met de maker en andere kijkers
  • Tips versturen
  • Verzoek om een privé show (als ze genoeg tokens hebben)


Gemeenschappelijke taken

De streamingserver opnieuw opstarten

Als uw streams niet werken, moet u soms gewoon de server herstarten:

# Log into your streaming server via SSH
docker restart livekit

Wacht 10 seconden, test dan opnieuw.

Controleren of de Streaming Server actief is

# Log into your streaming server via SSH
docker ps | grep livekit

Als er een regel met "livekit" in staat, draait de server. Als je niets ziet, begin dan met:

cd /opt/livekit
docker compose up -d

Serverlogs bekijken

Als er iets niet werkt en je moet zien wat er gebeurt:

# Show the last 50 lines of the log
docker logs --tail 50 livekit

Bekijk de log in realtime (druk op Ctrl+C om te stoppen)


docker logs -f livekit

De Streaming-server bijwerken

Om de paar maanden wilt u misschien updaten naar de nieuwste versie:

# Pull the latest version
docker pull livekit/livekit-server:latest

Herstarten met de nieuwe versie


docker compose down
docker compose up -d

Problemen oplossen

Stroomt niet starten

Wat je ziet: Maker klikt "Start Streaming" maar er gebeurt niets of er verschijnt een fout.

Hoe het te repareren:

  1. Controleer of de functie is ingeschakeld Beheerpaneel > Instellingen > Aan/uit
  2. Controleren of het aanmaakaccount bestaat Is Maker ingesteld op Ja
  3. Controleer uw config.inc.php bestand heeft de drie LIVEKIT instellingen
  4. Controleer of de streamingserver actief is: docker ps | grep livekit

Viewers kunnen geen verbinding maken

Wat je ziet: De Live Streams pagina laadt, maar het klikken op een stroom toont een fout of zwart scherm.

Hoe het te repareren:

  1. Zorg ervoor dat uw firewall het verkeer op deze poorten toelaat:
  • TCP: 7880, 7881
  • UDP: 50000-60000
  1. Controleer of uw LIVEKITHOST maakt gebruik van wss:// (niet ws://) als uw site HTTPS gebruikt
  2. Controleren of uw SSL-certificaat geldig is als u HTTPS gebruikt

Chat werkt maar video is zwart

Wat je ziet: De kijkers kunnen chatberichten versturen maar de video verschijnt nooit.

Hoe het te repareren:

Dit betekent meestal dat de UDP-poorten geblokkeerd zijn. Op uw streaming server:

# Open the UDP port range
sudo ufw allow 50000:60000/udp

Herstart dan de streaming server en probeer het opnieuw.

"Je hebt al een actieve stroom" Fout

Wat je ziet: Schepper probeert live te gaan, maar krijgt een foutmelding dat ze al een stream hebben.

Hoe het te repareren:

Dit gebeurt als een vorige stream niet goed eindigde (browser crash, etc.). Je kunt het handmatig beëindigen:

  1. Ga naar Beheerpaneel > Levende stroom (als u deze pagina heeft)
  2. Zoek de vastgelopen stroom en klik Eindstroom

Of vraag een ontwikkelaar om dit SQL commando uit te voeren:

UPDATE tblLiveStreams
SET status = 'ended', endedat = NOW()
WHERE creatorid = [USERID] AND status IN ('waiting', 'live');

Vervang [USERID] met het gebruikers-ID-nummer van de maker.

Stroomvoorbeelden worden niet getoond

Wat je ziet: De Live Streams directory pagina toont stromen, maar geen voorbeeldafbeeldingen.

Hoe het te repareren:

  1. Controleer of de uploads/streamsnapshots/ map bestaat al
  2. Zorg ervoor dat de map beschrijfbaar is (toestemming 755 of 777)
  3. Wacht een paar seconden - previews worden elke 30 seconden vastgelegd tijdens een livestream

Tips voor nieuwe gebruikers

Tip:
  • Beginnen met vrije stromen - Maak het je gemakkelijk met de technologie voordat je betaalde streams opzet
  • Test met vrienden - Laat een paar mensen je eerste stream bekijken om alles te controleren
  • Controleer uw internetsnelheid - Makers hebben minimaal 5 Mbps upload snelheid nodig voor een goede kwaliteit streaming
  • Een bekabelde verbinding gebruiken - WiFi kan onbetrouwbaar zijn voor streaming; ethernet kabels werken beter
  • Andere apps sluiten - Streaming maakt gebruik van veel computerbronnen; sluit onnodige programma's
  • Hebben goede verlichting - Kijkers kunnen geen tip geven als ze je niet duidelijk kunnen zien


Toegangscontrole-opties uitgelegd

Wanneer makers een stream starten, kiezen ze wie kan kijken:

ToegangstypeWat het betekentWanneer het te gebruiken
VrijIedereen kan kijken, geen betaling vereistBouwen van een publiek, speciale evenementen, of casual streams
Wachtwoord beveiligdKijkers hebben een wachtwoord nodig om te kijkenPrivéstreams voor een specifieke groep, zoals fanclubleden
Alleen abonneesAlleen gebruikers met een actief abonnement kunnen kijkenExclusieve inhoud voor betalende abonnees
Pay-Per-ViewViewers betalen tokens eenmaal om de stroom te ontgrendelenSpeciale evenementen of premium-inhoud
TipdoelStream ontgrendelt wanneer tip doel is bereiktInteractieve fondsenwerving of maatschappelijke uitdagingen

Makers kunnen deze instellingen voor elke stroom wijzigen.


Privé-shows begrijpen

Privé shows zijn een-op-een stromen tussen een maker en een enkele kijker. Zo werken ze:

  1. Een kijker kijkt naar een publieke stream
  2. Ze klikken Privé-show aanvragen
  3. Ze zetten hoeveel minuten ze willen.
  4. Het verzoek lijkt de schepper
  5. Als de maker accepteert:
  • De publieke stroom eindigt
  • Een nieuwe privéstream start
  • Alleen de gevraagde kijker kan kijken
  • Tokens worden automatisch per minuut afgetrokken
  1. Als de tijd op is (of iemand eindigt), eindigt de privé-show

Scheppers zetten hun snelheid per minuut in hun maker profiel instellingen.


Beveiliging en privacy

Wat beschermd is

  • Alle videostreams zijn versleuteld in transit
  • Tokens (betaling voor toegang) worden gegenereerd door de server, niet door de browser
  • Weergaven kunnen alleen bij kamers komen waar ze toestemming voor hebben
  • Chatberichten worden opgeslagen in uw database

Wat te kijken voor

  • SSL/HTTPS vereisen - Altijd gebruiken wss:// in uw LIVEKIT HOST instelling voor productielocaties
  • Gerapporteerde stromen monitoren - Heb een matigingssysteem voor ongepaste inhoud
  • Stel snelheidsbeperking in - Voorkom chatspam door te beperken hoe snel gebruikers berichten kunnen versturen
  • Bekijk je firewall - Open alleen de in deze gids genoemde poorten

BladzijdeWanneer het te gebruiken
Functie aan/uitZet live streaming op of uit site-breed
MakerbeheerAanvaarders die live kunnen gaan
GebruikersbeheerStel in wie de aanmaakrechten heeft
Token-instellingenConfigureren token prijzen voor pay-per-view en particuliere shows

Hulp halen

Als je vastzit:

  1. Controleer de logs Rennen. docker logs livekit om te zien wat de streaming server rapporteert
  2. De verbinding testen - Zorg ervoor dat u uw streaming server kunt bereiken via een browser
  3. Controleer uw configuratie - Controleer de drie LIVEKIT instellingen in config.inc.php
  4. Het forum controleren - Andere gebruikers kunnen hetzelfde probleem opgelost hebben
  5. Contact ondersteuning - De output van docker ps en docker logs --tail 50 livekit

Wat is het volgende?

Zodra uw live streaming is ingesteld:

  1. Promote the feature - Let your creators know they can now go live
  2. Create a guide for creators - Write simple instructions for your specific audience
  3. Set token prices - Decide pricing for pay-per-view and private shows
  4. Monitor usage - Watch server resources to see if you need to upgrade
  5. Gather feedback - Ask creators and viewers what they like or what needs improvement

 

Success:
Live streaming can significantly increase engagement and revenue on your site. Take time to promote it to your creators and viewers!