BigBlueButton 3.x için API dokümantasyonunu görüntülüyorsunuz. Güncel sürüm: BigBlueButton 4.x. Yükseltme mi planlıyorsunuz? Geçiş kılavuzu, API çağrılarınızda yapmanız gereken tüm değişiklikleri listeler.
userdata – İstemci Ayarları
Userdata parametreleri, userdata- API çağrısına join önekli parametreler ekleyerek istemci tarafı ayarlarını kullanıcı bazında geçersiz kılmanıza olanak tanır. Bu, sunucu yapılandırmasını değiştirmeden tek tek katılımcılar için BigBlueButton deneyimini özelleştirmenizi sağlar.
BigBlueButton 3.0 sürümünde userdata parametreleri API başvuru dokümanında değil, yönetim kılavuzunda listelenmiştir (Customize, "Passing user metadata to the client on join" bölümü). Parametreler sürümler arasında önceden haber verilmeksizin değişebilir.
Userdata Parametreleri Nasıl Çalışır
Userdata parametreleri, join isteğinde URL sorgu parametreleri olarak geçirilir. Yalnızca o tek kullanıcı oturumu için settings.yml içindeki varsayılan değerleri geçersiz kılarlar. Parametre adları her zaman ayar anahtarını izleyen userdata- önekiyle başlar.
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 Userdata parametreleri sorgu dizesinin parçası olduğundan, checksum hesaplamasına dahil edilirler. Bu nedenle checksum değerini hesaplamadan önce eklediğinizden emin olun; sonra değil.
userdata- sonrasındaki bölüm başka bir kısa çizgi içermemelidir; aksi takdirde parametre yok sayılır. userdata-bbb_ öneki, BigBlueButton için ayrılmıştır; kendi kullanıcı bazlı verilerini ekleyen entegrasyonlar, örneğin userdata-myapp_cohort=2026A gibi kendi öneklerini kullanmalıdır. Bu tür parametreler kullanıcıyla birlikte saklanır ve kayıt olaylarına yazılır, ancak istemci tarafından yok sayılır.
Ses ve Medya Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_auto_join_audio | Boolean | — | Kullanıcı toplantıya girdiğinde ses köprüsüne otomatik olarak katıl. |
userdata-bbb_listen_only_mode | Boolean | — | Kullanıcı için listen-only modunu etkinleştirin veya devre dışı bırakın. |
userdata-bbb_force_listen_only | Boolean | — | Kullanıcıyı zorunlu olarak listen-only moduna alın. Bu moderatörler için geçerli değildir. |
userdata-bbb_skip_check_audio | Boolean | — | Katılırken ses testi iletişim kutusunu atlayın. |
userdata-bbb_skip_echotest_if_previous_device | Boolean | — | Önceki oturumla aynı ses aygıtı algılanırsa yankı testini atlayın. |
Webcam Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_auto_share_webcam | Boolean | — | Kullanıcı katıldığında web kamerası paylaşımını otomatik olarak başlatın. |
userdata-bbb_mirror_own_webcam | Boolean | — | Kullanıcının kendi web kamerası önizlemesini yatay olarak aynalayın. |
Yerleşim ve Görüntüleme Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_default_layout | String | — | İstemcinin başlangıç düzeni. enforceLayout, join üzerinde ayarlandığında önceliklidir; ikisi de belirtilmemişse toplantı düzeni kullanılır. meetingLayout için create üzerinde kabul edilen değerlerin aynısını kabul eder. BBB 3.0+ |
userdata-bbb_change_layout Removed in 4.0 | String | — | Eski düzen değiştirme ayarı. meetingLayout için create üzerinde kabul edilen değerlerin aynısını kabul eder (örneğin SMART_LAYOUT) ve userdata-bbb_default_layout ayarından önceliklidir. Bunun yerine userdata-bbb_default_layout kullanın. |
userdata-bbb_hide_presentation_on_join | Boolean | false | Sunum alanı simge durumuna küçültülmüş olarak başlatılır; kullanıcı alanı geri yükleyebilir. BBB 2.6+ |
userdata-bbb_prefer_dark_theme | Boolean | — | Kullanıcı arayüzü için koyu temayı etkinleştirin. |
Özelleştirme ve Markalama Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_custom_style | String | — | Bu kullanıcı için CSS istemcisine uygulanan satır içi BigBlueButton kuralları (URL-encoded). |
userdata-bbb_custom_style_url | URL | — | Özel stil için istemci tarafından yüklenen harici bir CSS dosyasının URL'si. HTTPS üzerinden sunulmalıdır. |
userdata-bbb_custom_style parametresi, CSS injection URL'leri istemci tarafında oluşturulursa join için istismar edilebilir. Parametre değerlerini kontrol ettiğiniz sunucu tarafında her zaman join URL'leri oluşturun.
Kullanıcı Arayüzü Öğesi Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_hide_notifications | Boolean | — | İstemci arayüzündeki bildirim açılır pencerelerini gizleyin. |
userdata-bbb_hide_controls | Boolean | — | Kullanıcıdan UI kontrol öğelerini (araç çubuğu düğmeleri) gizleyin. |
userdata-bbb_shortcuts | String | — | Etkin kalacak klavye kısayollarını içeren JSON dizisi (ör. ["toggleMute","raiseHand"]); boş bir dizi tüm kısayolları devre dışı bırakır. |
userdata-enable-user-reaction Removed in 4.0 | Boolean | — | İstemci tarafından okunur, ancak bbb-web, anahtarında kısa çizgi bulunan tüm userdata- parametrelerini kaldırır; bu nedenle bu parametre istemciye hiç ulaşmaz ve hiçbir etkisi olmaz. Bunun yerine userReactions değerini disabledFeatures için kullanın. |
Beyaz Tahta Parametreleri
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
userdata-bbb_initial_selected_tool | String | — | Kullanıcı beyaz tahtayı açtığında başlangıçta seçili olacak beyaz tahta aracını ayarlayın. Kabul edilen değerler istemci yapılandırmasına göre belirlenir. |
Pratik Örnekler
Aşağıda tipik kullanım senaryoları için userdata parametrelerinin yaygın kombinasyonları yer almaktadır.
Kiosk Modu
Kullanıcı etkileşiminin gerekmediği konferans odası ekranları veya dijital tabelalar için idealdir:
userdata-bbb_auto_join_audio=true&userdata-bbb_force_listen_only=true&userdata-bbb_hide_controls=true Kiracıya Özel Markalama
Kiracı veya müşteri başına özel bir CSS stil sayfası uygulayın:
userdata-bbb_custom_style_url=https://api-guide.bbbserver.com/tenant-a/bbb-style.css Erişilebilir Hızlı Katılım
Basitleştirilmiş ve erişilebilir bir deneyime ihtiyaç duyan kullanıcılar için katılım sürecini kolaylaştırın:
userdata-bbb_skip_check_audio=true&userdata-bbb_auto_join_audio=true&userdata-bbb_prefer_dark_theme=true Önemli Notlar
- Userdata parametreleri yalnızca ilgili kullanıcının mevcut oturumunu etkiler. Sunucunun varsayılanlarını değiştirmezler.
- Tüm parametreler her BigBlueButton sürümünde mevcut değildir. Yayınlamadan önce hedef sürümünüzde test edin.
- CSS
userdata-bbb_custom_style_url aracılığıyla yüklenen, HTTPS üzerinden sunulmalıdır.
getJoinUrl uç noktası kullanıldığında, belirli userdata parametreleri güvenlik önlemi olarak izleyiciler (rol VIEWER) için engellenir. Engelleme listesi, getJoinUrlUserdataBlocklist içindeki bigbluebutton.properties özelliği aracılığıyla sunucu tarafında yapılandırılır. Bu, izleyicilerin önceden imzalanmış join URL'leri üzerinden güvenlik açısından kritik istemci ayarlarını geçersiz kılmasını önler. Grup odalarında engelleme listesi moderatörler için de geçerlidir. undocumented
Sıkça Sorulan Sorular
userdata-bbb_force_listen_only parametresi yalnızca izleyiciler için geçerlidir. Moderatörler bu ayardan bağımsız olarak listen-only moduna zorlanmaz.getFromUserSettings çağrıları) esas alınması gereken kaynaktır.