Du ser API-dokumentationen til BigBlueButton 3.x. Den aktuelle version er BigBlueButton 4.x. Planlægger du en opgradering? Migreringsvejledningen viser alle de ændringer, dine API-kald kræver.
userdata – Klientindstillinger
Userdata-parametre giver dig mulighed for at tilsidesætte klient-side-indstillinger pr. bruger ved at tilføje parametre med præfikset userdata- til API-kaldet join. Dette gør det muligt at tilpasse BigBlueButton-oplevelsen for individuelle deltagere uden at ændre serverkonfigurationen.
I BigBlueButton 3.0 er userdata-parametrene ikke angivet i API-referencen, men i administrationsvejledningen (Customize, afsnittet "Passing user metadata to the client on join"). Parametre kan ændres mellem versioner uden varsel.
Sådan fungerer userdata-parametre
Userdata-parametre sendes som URL-query-parametre i requesten join. De tilsidesætter standardværdierne fra settings.yml kun for denne ene brugersession. Parameternavnene starter altid med præfikset userdata- efterfulgt af indstillingsnøglen.
GET https://api-guide.bbbserver.com/bigbluebutton/api/join?meetingID=replace-with-meeting-id&fullName=Max&role=VIEWER&userdata-bbb_auto_join_audio=true&userdata-bbb_skip_check_audio=true&checksum=replace-with-checksum Fordi userdata-parametre er en del af query-strengen, indgår de i beregningen af checksum. Sørg for at tilføje dem før du beregner checksum, ikke bagefter.
Delen efter userdata- må ikke indeholde endnu en bindestreg – ellers udelades parameteren. Præfikset userdata-bbb_ er reserveret til BigBlueButton; integrationer, der tilføjer deres egne data for den enkelte bruger, bør bruge deres eget præfiks, for eksempel userdata-myapp_cohort=2026A. Sådanne parametre gemmes sammen med brugeren og skrives til optagelseshændelserne, men ignoreres af klienten.
Lyd- og medieparametre
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_auto_join_audio | Boolean | — | Deltag automatisk i lydbroen, når brugeren går ind i mødet. |
userdata-bbb_listen_only_mode | Boolean | — | Aktivér eller deaktiver listen-only-tilstand for brugeren. |
userdata-bbb_force_listen_only | Boolean | — | Tving brugeren ind i listen-only-tilstand. Dette gælder ikke for moderatorer. |
userdata-bbb_skip_check_audio | Boolean | — | Spring lyddialogen over ved tilslutning. |
userdata-bbb_skip_echotest_if_previous_device | Boolean | — | Spring ekkotesten over, hvis den samme lydenhed som i den forrige session registreres. |
Webcam-parametre
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_auto_share_webcam | Boolean | — | Start automatisk deling af webcam, når brugeren deltager. |
userdata-bbb_mirror_own_webcam | Boolean | — | Spejlvend brugerens eget webcam-preview vandret. |
Layout- og visningsparametre
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_default_layout | String | — | Det layout, klienten starter med. enforceLayout på join har forrang; hvis ingen af dem er angivet, bruges mødets layout. Accepterer de samme værdier som meetingLayout på create. BBB 3.0+ |
userdata-bbb_change_layout Removed in 4.0 | String | — | Ældre layoutindstilling. Accepterer de samme værdier som meetingLayout på create (for eksempel SMART_LAYOUT) og har forrang frem for userdata-bbb_default_layout. Brug userdata-bbb_default_layout i stedet. |
userdata-bbb_hide_presentation_on_join | Boolean | false | Start med præsentationsområdet minimeret; brugeren kan gendanne det. BBB 2.6+ |
userdata-bbb_prefer_dark_theme | Boolean | — | Aktivér det mørke tema for brugergrænsefladen. |
Tilpasnings- og brandingparametre
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_custom_style | String | — | Inline-CSS-regler (URL-encoded) anvendt på BigBlueButton-klienten for denne bruger. |
userdata-bbb_custom_style_url | URL | — | URL til en ekstern CSS-fil, som indlæses af klienten til brugerdefineret styling. Skal serveres over HTTPS. |
Parameteren userdata-bbb_custom_style kan udnyttes til CSS injection, hvis join-URL'er konstrueres på klientsiden. Generér altid join-URL'er på serversiden, hvor du kontrollerer parameterværdierne.
Parametre for UI-elementer
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_hide_notifications | Boolean | — | Skjul notifikations-pop op-vinduer i klientgrænsefladen. |
userdata-bbb_hide_controls | Boolean | — | Skjul UI-kontrolelementerne (værktøjslinjeknapperne) for brugeren. |
userdata-bbb_shortcuts | String | — | JSON-array med de tastaturgenveje, der forbliver aktiveret (f.eks. ["toggleMute","raiseHand"]); et tomt array deaktiverer alle genveje. |
userdata-enable-user-reaction Removed in 4.0 | Boolean | — | Læses af klienten, men bbb-web udelader alle userdata--parametre, hvis nøgle indeholder en bindestreg, så denne parameter når aldrig frem til klienten og har ingen effekt. Brug i stedet værdien userReactions for disabledFeatures. |
Whiteboard-parametre
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
userdata-bbb_initial_selected_tool | String | — | Angiv det oprindeligt valgte whiteboard-værktøj, når brugeren åbner whiteboardet. De accepterede værdier bestemmes af klientkonfigurationen. |
Praktiske eksempler
Nedenfor er almindelige kombinationer af userdata-parametre til typiske anvendelsestilfælde.
Kiosktilstand
Ideel til konferencerumsskærme eller digital skiltning, hvor der ikke kræves brugerinteraktion:
userdata-bbb_auto_join_audio=true&userdata-bbb_force_listen_only=true&userdata-bbb_hide_controls=true Lejer-specifik branding
Anvend et brugerdefineret CSS-stylesheet pr. tenant eller kunde:
userdata-bbb_custom_style_url=https://api-guide.bbbserver.com/tenant-a/bbb-style.css Tilgængelig hurtig tilslutning
Forenkl tilslutningsprocessen for brugere, der har brug for en forenklet og tilgængelig oplevelse:
userdata-bbb_skip_check_audio=true&userdata-bbb_auto_join_audio=true&userdata-bbb_prefer_dark_theme=true Vigtige bemærkninger
- Userdata-parametre påvirker kun den aktuelle session for den enkelte bruger. De ændrer ikke serverens standardindstillinger.
- Ikke alle parametre er tilgængelige i alle BigBlueButton-versioner. Test mod din målversion før deployment.
- CSS indlæst via
userdata-bbb_custom_style_urlskal serveres over HTTPS.
Når du bruger endpointet getJoinUrl, blokeres visse userdata-parametre for viewers (rolle VIEWER) som en sikkerhedsforanstaltning. Bloklisten konfigureres på serversiden via egenskaben getJoinUrlUserdataBlocklist i bigbluebutton.properties. Dette forhindrer viewers i at tilsidesætte sikkerhedskritiske klientindstillinger gennem præsignerede join-URL'er. I grupperum gælder blokeringslisten også for moderatorer. undocumented
Ofte stillede spørgsmål
userdata-bbb_force_listen_only gælder kun for viewers. Moderatorer tvinges ikke ind i listen-only-tilstand uanset denne indstilling.getFromUserSettings i HTML5-klienten) er den autoritative reference.