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 7 GET POST

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.
  • enforceLayout parametresi, 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.

Sıkça Sorulan Sorular

Hayır. Çoğu BigBlueButton API uç noktasının aksine, getJoinUrl session-token authentication kullanır. Shared secret ile checksum hesaplamak yerine sessionToken parametresini iletirsiniz.

Hayır. Kullanıcı daha önce standart join uç noktası üzerinden katılmış olmalı ve geçerli, etkin bir sessionToken sahibi olmalıdır. Bu uç nokta ilk katılma URL'lerini oluşturmak için kullanılamaz.

Her iki oturum — orijinal ve yeni olan — paralel olarak var olur. Kullanıcı katılımcı listesinde yalnızca bir kez görünür, ancak her iki tarayıcı penceresi veya cihaz da etkin kalır.

İstemcinin dahili olarak kullandığı diğer oturum belirteci tabanlı uç noktalar (stuns, learningDashboard) gibi, getJoinUrl de JSON döndürür. Sağlama toplamıyla korunan API uç noktaları XML döndürür.

getJoinUrl uç noktası BigBlueButton 3.0'da tanıtıldı. Önceki sürümlerde mevcut değildir.

Şart değil. Yapılandırılabilir bir engelleme listesi, moderatör olmayan kullanıcılar için belirli userdata anahtarlarını kısıtlayabilir. Engelleme listesi "all" olarak ayarlanmışsa, görüntüleyiciler için hiçbir userdata parametresi aktarılmaz. Moderatörler, breakout rooms dışında engelleme listesini aşar.