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.
getJoinUrl – Katılım URL'si Oluştur
getJoinUrl uç noktası, bir toplantıya zaten katılmış bir kullanıcı için yeni bir katılma URL'si oluşturur. Bu, aynı kullanıcının ek oturumlar açmasına olanak tanır — örneğin ikinci bir ekranda veya cihaz değiştirdikten sonra — standart join akışı üzerinden yeniden kimlik doğrulaması yapmadan. BBB 3.0+
Uç Nokta
GET/POST https://api-guide.bbbserver.com/bigbluebutton/api/getJoinUrl?<parameters> Bu uç nokta, standart checksum mekanizması yerine session-token authenticationshared-secret kullanır. Kullanıcı daha önce join uç noktası üzerinden katılmış olmalı ve geçerli bir sessionToken sahibi olmalıdır.
Sağlama toplamıyla korunan BigBlueButton API uç noktaları XML döndürürken, bu uç nokta JSON döndürür.
Gerekli Parametreler
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|---|
sessionToken | String | Evet | — | Yeni bir katılma URL'si oluşturulması gereken kullanıcının sessionToken değeri. |
İsteğe Bağlı Parametreler
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|---|
replaceSession | Boolean | Hayır | false | true olarak ayarlandığında, orijinal oturum geçersiz kılınır ve yenisiyle değiştirilir (oturum aktarımı). |
sessionName | String | Hayır | — | Yeni oturum için açıklayıcı bir ad. |
enforceLayout | String | Hayır | — | Yeni oturum için yerleşimi geçersiz kılın. |
userdata-* | String | Hayır | — | Yeni oturum için özel kullanıcı verileri. Anahtarlar userdata- ile başlamalıdır. |
Kullanım Senaryoları
- Hibrit senaryolar — bir moderatör sunum için bir ekranı, katılımcı görünümü için ise ikinci bir ekranı kullanır.
- Cihaz değiştirme — bir kullanıcı toplantı sırasında masaüstünden tablete geçer.
- Çok ekranlı kurulumlar — farklı yerleşimleri gösteren birden fazla ekrana sahip bir konferans odası.
Davranış
Yeni oturum, orijinal oturumla aynı kullanıcı kimliğini paylaşır. Kullanıcı katılımcı listesinde yalnızca bir kez görünür.
replaceSession olmadan, her iki oturum da paralel olarak var olur.
replaceSession=true ile, orijinal oturum geçersiz kılınır ve kullanıcı yeni oturuma sorunsuz şekilde aktarılır.
Örnek İstek
GET https://api-guide.bbbserver.com/bigbluebutton/api/getJoinUrl?sessionToken=replace-with-session-token&sessionName=SecondScreen&enforceLayout=PRESENTATION_FOCUS Örnek Yanıt (Başarılı)
{
"response": {
"returncode": "SUCCESS",
"message": "Join URL provided successfully.",
"url": "https://api-guide.bbbserver.com/bigbluebutton/api/join?...&checksum=replace-with-checksum"
}
} Hata Yanıtları
Bir istek başarısız olduğunda, uç nokta açıklayıcı bir hata mesajı içeren bir JSON nesnesi döndürür:
{
"response": {
"returncode": "FAILED",
"message": "<error message>"
}
} | Mesaj | Anlamı |
|---|---|
You must provide a session token | sessionToken parametresi eksik. |
Invalid session token | sessionToken geçersiz veya süresi dolmuş. |
Invalid Session | İstek, join tarafından oluşturulan HTTP oturum çerezini içermiyor ve toplantı, oturumu olmayan isteklere izin vermiyor (allowRequestsWithoutSession, varsayılan: false). |
Access denied | Kullanıcı bulunamadı veya yetkisi yok. |
Meeting not found | Toplantı mevcut değil veya artık çalışmıyor. |
BigBlueButton 3.0 sürümünde yalnızca Meeting not found, bir JSON hatası olarak döndürülür. Yukarıda listelenen diğer hatalar için uç nokta herhangi bir JSON yanıtı göndermez.
Userdata Engelleme Listesi
userdata-* ile getJoinUrl parametreleri kullanılırken, yapılandırılabilir bir engelleme listesi (getJoinUrlUserdataBlocklist) moderatör olmayan kullanıcılar için belirli userdata anahtarlarını kısıtlar:
- Engelleme listesi
"all"değerini içeriyorsa, görüntüleyiciler için tüm userdata parametreleri engellenir. - Moderatörler, içinde exceptbreakout rooms olmak üzere engelleme listesini aşar.
enforceLayoutparametresi, engelleme listesinden bağımsız olarak her zaman izinlidir.
Bu uç nokta yalnızca kullanıcı zaten geçerli bir sessionToken sahibi olduğunda kullanılabilir — yani önce standart join uç noktası üzerinden toplantıya katılmış olması gerekir. Süresi dolmuş belirteçler reddedilir.
Cihaz değiştirme kullanım senaryolarında, oturumu yeni cihaza sorunsuz şekilde aktarmak için replaceSession=true ayarlayın. Bu, eski cihazda katılımcı listesinde karışıklığa yol açabilecek bayat bir oturum kalmasını önler.