Clientbibliotheken & integratietools

Clientbibliotheken abstraheren de details van checksum-berekening, HTTP-requestconstructie en XML-responseparsing, zodat je met de BigBlueButton-API kunt werken via getypeerde methoden in de programmeertaal van jouw keuze. Dit hoofdstuk biedt een overzicht van beschikbare bibliotheken, integratietools en richtlijnen voor het kiezen van de juiste optie voor je project.

Officiële bibliotheken

De volgende bibliotheken worden onderhouden door het BigBlueButton-project zelf of door nauw verbonden bijdragers. Ze zijn over het algemeen goed onderhouden en volgen nieuwe API-functies zodra die worden uitgebracht.

Communitybibliotheken

Deze bibliotheken worden door de community ontwikkeld en onderhouden. Hun kwaliteit en updatefrequentie variëren — controleer altijd de onderhoudsstatus en de ondersteunde BBB-versie voordat je er een adopteert.

Integratietools

Naast clientbibliotheken kunnen verschillende tools je helpen bij het testen, beheren en opschalen van BigBlueButton-deployments:

Een bibliotheek kiezen

Houd bij het evalueren van een clientbibliotheek voor je project rekening met de volgende criteria:

• Ondersteuning voor BBB-versies: Ondersteunt de bibliotheek BBB 3.0-functies zoals role in plaats van password, sendChatMessage en clientSettingsOverride?
• Checksum-algoritme: Ondersteunt de bibliotheek SHA-256 en SHA-512, of alleen het verouderde SHA-1?
• POST-ondersteuning: Kan de bibliotheek XML-bodies versturen (vereist voor presentatie-uploads en clientSettingsOverride)?
• Onderhoudsstatus: Wanneer was de laatste commit? Zijn er onbeantwoorde problemen zonder enige reactie?
• Webhook-ondersteuning: Biedt de bibliotheek helperfuncties voor webhook-registratie en callback-validatie?

Een maatwerkintegratie bouwen

Als geen van de bestaande bibliotheken aan je eisen voldoet, kun je je eigen integratie bouwen met elke taal die HTTP ondersteunt. De kernlogica bestaat uit drie componenten:

Voor eenvoudige integraties die alleen create en join nodig hebben, kan dit in slechts een paar regels code worden gerealiseerd — een volledige bibliotheek is niet strikt noodzakelijk.

# Minimal example: create + join (pseudocode)

secret = "replace-with-secret"
base   = "https://api-guide.bbbserver.com/bigbluebutton/api"

# 1. Build query string
params = "name=Demo&meetingID=replace-with-meeting-id&attendeePW=replace-with-password&moderatorPW=replace-with-password"

# 2. Compute checksum
checksum = sha256("create" + params + secret)

# 3. Send request
response = http_get(base + "/create?" + params + "&checksum=" + checksum)

# 4. Parse XML response
if parse_xml(response).returncode == "SUCCESS":
    # Build join URL for a moderator
    join_params = "fullName=Admin&meetingID=demo-1&role=MODERATOR"
    join_checksum = sha256("join" + join_params + secret)
    redirect_to(base + "/join?" + join_params + "&checksum=" + join_checksum)