API sürümü: 4.x en güncel 3.x

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.

Bölüm 19

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.
  • CSSuserdata-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

Hayır. Userdata parametreleri yalnızca join çağrısı tarafından başlatılan tek oturuma uygulanır. Kullanıcı ayrılır ve tekrar katılırsa, parametreler yeni join URL'sine yeniden dahil edilmelidir.

Hayır. Userdata parametreleri yalnızca join uç noktası için tasarlanmıştır. Bir kullanıcı toplantıya katıldığında istemci tarafından işlenirler ve create çağrısı üzerinde hiçbir etkileri yoktur.

Evet. URL sorgu dizesinin parçası oldukları için checksum hesaplamasına dahil edilirler. checksum hesaplanmadan önce tüm userdata parametrelerini sorgu dizesine eklemelisiniz.

Hayır. 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.

BigBlueButton 3.0 için istemci tarafından okunan parametreler yönetim kılavuzunda (Customize, "Passing user metadata to the client on join" bölümü) listelenmiştir. İstemcinin kaynak kodu (HTML5 istemcisindeki getFromUserSettings çağrıları) esas alınması gereken kaynaktır.