Een API voor livestreaming kiezen: wat je vergelijkt voordat je bouwt

Kies een API voor livestreaming op hoe ver je kijkers achterlopen op live en op wat de rekening telt: of het beeld ze vele seconden te laat bereikt of ongeveer een seconde na de host, of ze kunnen reageren terwijl dat er nog toe doet, en of je wordt gefactureerd op kijkersminuten, uren video of verstuurde gigabytes. Een speler, een studio en een insluitcode staan op elke functielijst, dus het zijn die antwoorden die diensten van elkaar onderscheiden.
Dit artikel loopt tien vragen door die je aan elke API voor livestreaming, SDK voor livestreams of API voor videostreaming stelt, met waarom elke vraag ertoe doet en hoe je het antwoord zelf controleert. Het noemt geen enkele dienst. Aan het eind beantwoordt het elke vraag voor WordPlus Cloud, met wat het aan jou overlaat.
Een uitzending, of een stream in twee richtingen
Onder deze woorden worden twee soorten diensten verkocht, en ze zijn op verschillende protocollen gebouwd.
Een uitzenddienst knipt de stream in korte bestanden, segmenten van elk een paar seconden, en stuurt die via gewoon HTTP naar kijkers, meestal als HLS. Bestanden reizen door elk netwerk en elke cache, dus zo’n dienst brengt een stream naar een heel groot publiek, een aantal seconden achter op live. Een realtimedienst stuurt de stream via WebRTC, het protocol van videogesprekken, frame voor frame door zijn mediaservers, dus kijkers zien het ongeveer zo snel als een gesprek het zou tonen, en hun chat, reacties en vragen komen aan terwijl de host nog bij het onderwerp is.
| Uitzending via HLS | Realtime via WebRTC | |
|---|---|---|
| Vertraging | Vele seconden | Ongeveer een seconde |
| Verstuurd als | Bestanden via HTTP | Pakketten, zoals in een gesprek |
| Het publiek | Kijkt | Kijkt en doet mee |
Geen van de twee is in het algemeen beter. Een wedstrijd die een heel land bekijkt zonder een woord te schrijven, is een uitzending. Een les, een lancering met vragen of een lezing met een chat ernaast is een stream in twee richtingen. Weet welke van de twee je bouwt voordat je prijzen vergelijkt, want de twee worden ook op verschillende manieren geprijsd.
1. Hoe ver loopt een kijker achter op live?
De vertraging komt voort uit hoe de stream reist. HLS verstuurt een segment pas als het compleet is, en een speler houdt er meerdere achter de hand: de HLS-standaard schrijft een speler voor om minstens drie doelduren vóór het live-einde van de afspeellijst te beginnen, en de richtlijnen van Apple voor HLS raden een doelduur van 6 seconden aan. Daarmee loopt een kijker 18 seconden of meer achter. Low-Latency HLS verstuurt delen van elk segment zodra ze gemaakt zijn, volgens dezelfde richtlijnen elk een seconde, en een speler houdt er nog steeds minstens drie vast, dus er blijven een paar seconden over.
WebRTC heeft geen segmenten. Het verstuurt elk frame zodra het is gecodeerd, zoals in een gesprek.
Twee seconden doen er weinig toe voor iemand die een film kijkt. Ze doen er veel toe voor een docent die vraagt „kan iedereen dit zien?”, of voor een host die de chat voorleest en erop antwoordt.
Vraag na:
- Hoe ver loopt een kijker achter op de host, van de camera tot het scherm, en hoe is dat gemeten?
- Komt de chat gelijk met het beeld aan, of ervoor?
- Groeit de vertraging tijdens een lange stream, en wat brengt die weer terug?
2. Hoe komt het beeld erin?
Een host gaat ergens vandaan live: de camera van een browser of een telefoon, een gedeeld scherm, of een encoder zoals OBS die scènes en camera’s mengt. Voor een browser of een telefoon hoef je niets te installeren. Een encoder stuurt de stream via een eigen protocol, meestal RTMP, een ouder protocol dat video via TCP vervoert, of WHIP, de IETF-standaard om een stream met één HTTP-verzoek en een bearer-token naar een WebRTC-dienst te sturen. OBS heeft het sinds versie 30.
Vraag na:
- Kan een host live gaan vanuit een browser, zonder iets te installeren?
- Welke encoderprotocollen neemt de dienst aan, en met welke encoders is dat getest?
- Als de encoder een minuut wegvalt, wacht de stream er dan op, of eindigt die?
- Kan een uitgelekte streamsleutel worden vervangen, en werkt de oude dan niet meer?
3. Wat krijgt elke kijker?
Mensen kijken tegelijk op een telefoon met één streepje mobiele data en op een groot scherm met glasvezel. Een dienst die iedereen hetzelfde beeld stuurt, laat een van hen in de steek. Er zijn twee manieren om dat te omzeilen. Een uitzenddienst codeert de stream meestal opnieuw in meerdere formaten, een ladder van kwaliteiten, en de speler kiest er een op basis van zijn verbinding. Een realtimedienst laat de host vaak meerdere formaten tegelijk versturen, simulcast, en zijn mediaservers sturen elke kijker het formaat door dat past (hoe mediaservers werken).
Vraag na:
- Hoeveel kwaliteiten, tot welke resolutie, en wie kiest: de speler, de kijker, of allebei?
- Wordt het beeld op een zwakke verbinding kleiner voordat het blijft hangen?
- Kan mijn pagina uitlezen hoe de stream bij een kijker speelt, om iemand te helpen bij wie het beeld bevriest?
4. Hoe dicht staan de servers, en komen ze erdoor?
Een kijker ver van de server wacht tot elk pakket die afstand heeft afgelegd, en verliest er onderweg meer. Vraag waar de mediaservers draaien, en of elke kijker vanzelf een server in de eigen regio bereikt. Hoe je gebruikers in verschillende regio’s verbindt loopt na wat elk antwoord betekent.
Het netwerk ertussen telt net zo zwaar. HLS reist als elke webpagina, door elke firewall die het web naar buiten laat. WebRTC gebruikt het liefst UDP, dat veel kantoren en hotels blokkeren, dus een realtimedienst heeft ook een weg naar binnen nodig via de poorten van het web. Ons artikel over WebRTC-poorten somt op wat een firewall moet toestaan.
Vraag na:
- Waar staan de mediaservers, en maakt elke kijker verbinding met de dichtstbijzijnde?
- Krijgt een kijker op een netwerk dat alleen het web naar buiten laat, nog steeds het beeld?
5. Wat telt de rekening?
De meeste API’s voor livestreaming tellen kijkersminuten, een minuut waarin één persoon kijkt. Een stream van een uur voor 1.000 mensen is er 60.000, dus de omvang van je publiek doet er meer toe dan hoeveel streams je draait. Sommige tellen in plaats daarvan, of daarnaast, uren gecodeerde video of geleverde gigabytes.
Kijk daarna wat er nog meer wordt geteld. Sommige prijzen stijgen met de resolutie, sommige tellen de tijd dat een pagina wacht voordat de stream begint, en opnemen, opslag, de chat en elke encoder kunnen elk een eigen regel op de rekening zijn. Wat videogesprekken per minuut kosten rekent een hele maand door, met een livestream erin.
Vraag na:
- Telt een minuut in 1080p net als een minuut in 360p?
- Wordt een kijker geteld vanaf het openen van de pagina, of vanaf het moment dat de stream live gaat?
- Wat gebeurt er boven het abonnement: worden nieuwe kijkers geweigerd, wordt wie al kijkt afgesloten, of wordt het extra gebruik gefactureerd?
6. Wie mag kijken, en wie mag live gaan?
Een stream voor iedereen heeft alleen een link nodig. Een stream voor de leden van een club, de leerlingen van een cursus of wie een ticket heeft, heeft meer nodig, want een link is snel doorgegeven. Bij de meeste API’s ondertekent je server een token voor elke kijker of voor elke stream, en het verschil zit in hoeveel het token zegt, en of een token dat voor de ene persoon is ondertekend, ook voor een ander werkt.
Vraag na:
- Kan iemand zonder account kijken, en kan ik dat voor één stream uitzetten?
- Opent een doorgegeven link een stream die alleen voor leden is?
- Kan ik een kijker tijdens de stream eruit halen, en buiten houden?
- Wie mag live gaan in een stream, en hoe wordt dat gecontroleerd?
7. Hoort de chat bij de stream?
Een stream in twee richtingen heeft een chat ernaast nodig, en een chat met een publiek moet je bijhouden: een bericht vastzetten, er een verwijderen, iedereen afremmen, iemand een tijdje dempen, iemand verbannen. Sommige API’s leveren een chat bij de stream, andere laten die over aan een tweede dienst met een eigen rekening.
Vraag na:
- Komt de chat met de stream mee, op dezelfde verbinding en met dezelfde login?
- Wie houdt hem bij, en kan mijn server hetzelfde doen zonder dat er een pagina open is?
- Hoeveel berichten bewaart hij, en hoe lang?
8. Kan een kijker op het podium komen?
Een vraag die hardop wordt gesteld, een interview, een panel: voor elk ervan moet een kijker met camera en microfoon in beeld komen, zodat iedereen die kijkt het ziet, zonder een tweede app voor gesprekken. Alleen de realtime soort kan dat, want een kijker die vele seconden achterloopt, kan geen gesprek voeren met de host.
Vraag na:
- Kan een kijker een hand opsteken, en kan de host die op het podium halen en er weer af?
- Hoe verschijnen gasten: naast elkaar, wie spreekt groot, of één persoon in de spotlight?
9. Is er een kant-en-klare speler en studio?
Een speler is meer dan een video-element. Browsers spelen pas geluid af als iemand op de site heeft geklikt of getypt (MDN over autoplay), dus een kijker die een stream via een link opent, ziet die misschien zonder geluid, en de speler heeft een manier nodig om het geluid aan te zetten. Hij zegt wanneer de stream nog niet begonnen is, speelt zodra die begint zonder herladen, en toont de chat en hoeveel mensen kijken. De host heeft een studio nodig: de camera voordat je live gaat, het scherm, de encoder, live gaan en stoppen. Een kant-en-klare studio bespaart weken, en die moet eruitzien als de rest van je app.
Vraag na:
- Welke platforms hebben er een: het web, React, iOS, Android?
- Kan ik de stijl aanpassen, en de speler en de chat los van elkaar plaatsen?
- Is de rest van de SDK er voor een eigen speler?
- Is er een serverbibliotheek in de taal waarin ik schrijf, of een HTTP-API?
10. Wat hoort je server terug, en wat blijft er?
Je app moet weten wat er gebeurd is: wanneer een stream live ging en eindigde, wie keek en hoe lang. Dat is nodig om te tonen wat er nu live is, om het volgers te laten weten, of om je eigen gebruikers per weergave of per minuut te factureren. Webhooks brengen het, en omdat een webhook twee keer kan komen, heeft elk een id nodig.
Lees dan de pagina met limieten: hoe lang een stream mag duren, hoeveel mensen mogen kijken, hoe lang een streamsleutel geldig blijft. En vraag wat er blijft als een stream eindigt: een opname, de herhaling ervan, de chat.
Test het een middag lang
Een functietabel beantwoordt er maar weinig van. Een kleine test beantwoordt de meeste. Bouw op elke dienst die je overweegt de kleinste stream die je kunt maken, en doorloop deze acht stappen:
- Ga live vanuit een browser, en kijk op een telefoon met mobiele data. Zet een klok die seconden toont voor de camera, en fotografeer die naast het scherm van de telefoon: het verschil is de vertraging.
- Stel hardop een vraag, en laat de kijker die in de chat beantwoorden. Kijk hoe lang het antwoord erover doet om je te bereiken.
- Vertraag het netwerk in de ontwikkelaarstools van de browser van de kijker. Kijk of het beeld kleiner wordt of stopt.
- Kijk vanaf een netwerk dat alleen het web naar buiten laat, zoals de strenge wifi van een kantoor of hotel. Onze verbindingstest laat vooraf zien wat dat netwerk doorlaat.
- Open de stream via een link in een nieuw tabblad, en kijk wat de speler met het geluid doet.
- Open een stream die alleen voor leden is in een privévenster, uitgelogd, met de link die een lid heeft.
- Stop de encoder een minuut en start hem opnieuw. Kijk of de kijkers er nog zijn.
- Open de pagina met het gebruik bij de dienst, en lees wat er voor deze middag is geteld.
Hoe WordPlus Cloud ze beantwoordt
WordPlus Cloud is van de tweede soort: een API en SDK voor livestreaming via WebRTC, met een kant-en-klare speler, studio en chat, op mediaservers die we zelf draaien. Dezelfde tien vragen, op volgorde:
- Kijkers lopen ongeveer een seconde achter op de host, via WebRTC zonder segmenten, en de chat en reacties komen over dezelfde verbinding, gelijk met het beeld.
- Een host gaat live met de camera en microfoon van een browser of een telefoon, deelt een scherm, of streamt vanuit OBS of elke andere encoder via WHIP. De studio geeft de host een adres en een sleutel voor de encoder, en een nieuwe sleutel sluit de oude af. We nemen WHIP aan, geen RTMP. Een livestream waarvan de encoder 5 minuten weg blijft, eindigt, tenzij iemand op het podium nog een camera of een scherm verstuurt.
- De host verstuurt tot 1080p, en elke kijker krijgt een laag die past, gekozen op de grootte van de speler en de verbinding, tot Full HD in een grote speler. Een kijker kan ook zelf een laag kiezen, tot 720p. Elke pagina kan eens per seconde uitlezen hoe de stream bij haar kijker speelt: het beeld en het geluid die aankomen, wat er verloren gaat, de tijd heen en terug, hoe lang het beeld nodig had om te starten, haperingen en nieuwe verbindingen.
- Onze mediaservers draaien in meerdere regio’s, en elke kijker maakt vanzelf verbinding met een server in de eigen regio, terwijl onze servers de stream over privéverbindingen tussen regio’s doorgeven. De netwerkpagina toont ze op een kaart. Een kijker op een netwerk dat alleen het web naar buiten laat, krijgt de stream toch, op poort 443.
- De rekening telt gelijktijdige verbindingen, vanaf 1.000: $11.99 per maand, jaarlijks gefactureerd, of $14.99 maandelijks gefactureerd. Elke kijker gebruikt er een. Met 1.000 verbindingen kosten 50 kijkers tegelijk geen credits, en elke 1.000 verbindingen extra voegen er 20 toe. Daarboven kost elke kijker een credit per minuut, alleen geteld terwijl de stream live is, wat neerkomt op $0.20 per 1.000 kijkersminuten, en je abonnement voegt 5.000 credits per maand toe voor elke 1.000 verbindingen. Eén prijs bij elke resolutie, en bandbreedte, relays en chatberichten worden nooit in rekening gebracht. Een stream van een uur voor 1.000 kijkers, 4 keer per maand, komt met het abonnement op ongeveer $56.59. Zijn je credits en een maand lenen op, dan worden nieuwe kijkers boven wat het abonnement bevat niet toegelaten tot je credits toevoegt of de maand eindigt, en wie al kijkt, blijft kijken.
- Je server bepaalt wie wie is, met een regel voor elk soort stream: die weigert iemand, of maakt iemand een kijker, een kijker die de chat alleen leest, een moderator of de host. Een bezoeker die niet is ingelogd, kijkt mee als je regel dat zegt. Anders is de stream alleen voor leden, en opent een doorgegeven link niets. Een stream is voor iedereen die kijkt, dus hij is onderweg versleuteld maar niet end-to-end: onze mediaservers zien hem, zoals een stream dat nodig heeft.
- De chat komt met de stream mee, op dezelfde verbinding, met reacties over het beeld. De host en de moderators die je server aanwijst, zetten berichten vast en verwijderen ze, remmen de chat af tot één bericht per zoveel seconden, tot 300, dempen iemand voor een minuut tot een dag, en halen iemand eruit of verbannen die. Je server doet dat allemaal zonder dat er een pagina open is, en schrijft in de chat onder een eigen naam. De chat bewaart zijn laatste 200 berichten, tot een dag na het laatste.
- Kijkers komen op het podium. Een kijker steekt een hand op, de host nodigt die uit, en iedereen die kijkt, ziet die naast de host met camera en microfoon, tot 720p, in een raster, wie spreekt groot, of één persoon in de spotlight. Een bezoeker die niet is ingelogd, kijkt mee, en komt niet op het podium.
- Een kant-en-klare speler, studio en chat, als één element op elke pagina,
<LiveStream>in React, en native schermen op iOS en Android. Plaats de speler en de chat los van elkaar, pas hun stijl aan, of teken een eigen speler op dezelfde SDK. Ze spreken negen talen, en de speler toont Geluid aan als de browser hem zonder geluid start. Serverbibliotheken voor Node.js, PHP en Python, handleidingen voor Next.js, Express, Laravel, gewoon PHP, Django, FastAPI en Flask, en een HTTP-API voor elke andere taal. - Je server hoort via een webhook wanneer elke stream live gaat en eindigt, en wanneer elke ingelogde kijker begint en stopt met kijken, met de seconden live tijd, geteld op onze servers. Elk event heeft een id, dus een herhaling wordt één keer bewaard, en je server kan de streams opvragen die nu live zijn, met hoeveel mensen elk ervan bekijken. De limieten zijn openbaar: het toegangsbewijs van een kijker voor een stream is 10 minuten geldig en de pagina vernieuwt het, en een streamsleutel blijft bewaard tot er een jaar voorbijgaat waarin niemand hem gebruikt.
De handleiding voor livestreams heeft de code van elk onderdeel in elke stack. Zo implementeer je livestreaming in Next.js bouwt stap voor stap een hele site voor livelessen, en in de live demo ervan ga je live als docent en kijk je als leerling in een ander venster.
Wat het aan jou overlaat
- De regel. Wie host en wie kijkt, is je eigen logica, dus het is code die je zelf schrijft, met de route die ernaar vraagt, en dat geldt ook voor wat je webhook van elke stream vastlegt.
- Mensen laten weten dat een stream begon. Je server hoort dat die live gaat, en de e-mail of het bericht verstuur je zelf.
- Opnames en herhalingen. De SDK’s voor apps nemen vandaag geen streams op.
- RTMP. Een encoder die alleen RTMP verstuurt, heeft een nieuwere versie nodig, of je neemt een andere encoder met WHIP, zoals OBS 30 of later.
- Een stream die alleen uitzendt. Elke kijker gebruikt een verbinding van je abonnement, want iedereen in een realtime stream blijft verbonden. Bij een publiek dat nooit schrijft en een vertraging van vele seconden niet erg vindt, past een uitzenddienst via HLS.
Begin met de handleiding voor livestreams
WordPlus Cloud for Apps is geprijsd op gelijktijdige verbindingen, vanaf 1.000, maandelijks of jaarlijks gefactureerd. Hetzelfde abonnement en dezelfde SDK brengen gesprekken, groepsgesprekken en chat op dezelfde verbinding. Bekijk de API en SDK voor livestreaming met de live demo en elke stack, wat de cloud doet voor apps, of de prijzen voor apps. Zoek je ook iets voor gesprekken en chat? Een API voor videogesprekken kiezen stelt dezelfde vragen over gesprekken, en een chat-API kiezen over berichten. Vragen over je integratie? Schrijf ons.