Bölüm 8 GET POST

isMeetingRunning – Toplantı Durumunu Kontrol Et

isMeetingRunning uç noktası, belirli bir toplantının BigBlueButton sunucusunda şu anda etkin olup olmadığını kontrol eder. Basit bir boolean değer döndürdüğünden API'deki en hafif izleme çağrısıdır.

Uç Nokta

GET/POST https://api-guide.bbbserver.com/bigbluebutton/api/isMeetingRunning?meetingID=replace-with-meeting-id&checksum=replace-with-checksum

Bu uç nokta, sağlanan toplantı kimliği mevcut olmasa bile her zaman SUCCESS return code döndürür. Bu durumda running değeri yalnızca false olur.

Gerekli Parametreler

Parametre Tür Gerekli Açıklama
meetingID String Evet Kontrol etmek istediğiniz toplantının toplantı kimliği.

Örnek İstek

https://api-guide.bbbserver.com/bigbluebutton/api/isMeetingRunning?meetingID=replace-with-meeting-id&checksum=replace-with-checksum

Örnek Yanıt

<response>
  <returncode>SUCCESS</returncode>
  <running>true</running>
</response>

Yanıt Alanları

Alan Tür Açıklama
returncode String Toplantı mevcut olsun ya da olmasın, bu uç nokta için her zaman SUCCESS.
running Boolean Toplantı şu anda çalışıyorsa true, çalışmıyorsa veya toplantı kimliği bilinmiyorsa false.

Bir Toplantı Ne Zaman Çalışıyor Olarak Kabul Edilir?

Bir toplantı, en az bir katılımcı katıldığında çalışıyor kabul edilir. Katılımcısı olmayan yeni oluşturulmuş bir toplantı, sunucuda mevcut olsa bile running değerini false olarak döndürür.

Sunucuda yeni bir toplantı oluşturmak için create çağrısını yapın.

Bu noktada, isMeetingRunning false döndürür — henüz kimse katılmamıştır.

Bir katılımcı join aracılığıyla katılır. Toplantı artık çalışıyordur.

isMeetingRunning artık true döndürür.

bbbserver.de Kullanıcıları İçin Notlar

bbbserver.de yönetilen örneklerinde, yerleşik API araçlarını kullandığınızda API checksum otomatik olarak hesaplanır. Bunu manuel olarak hesaplamanız gerekmez.

İpuçları ve En İyi Uygulamalar

isMeetingRunning basit durum yoklaması için uygun olsa da, daha verimli gerçek zamanlı izleme için webhooks kullanmayı düşünün. Bu uç noktayı yüksek sıklıkta yoklamak sunucuya gereksiz yük bindirir.

Ayrıntılı toplantı durumu için yalnızca isMeetingRunning değerine güvenmeyin. Katılımcı sayıları, kayıt durumu veya diğer meta veriler gerekiyorsa bunun yerine getMeetingInfo kullanın.

  • Bu uç noktayı, yalnızca bir toplantının aktif olup olmadığını bilmesi gereken hafif sağlık kontrolleri veya basit panolar için kullanın.
  • Aynı anda birden çok toplantıyı izlemek gerekiyorsa bunu getMeetings ile birleştirin — tek bir getMeetings çağrısı, çok sayıda tekil isMeetingRunning çağrısından daha verimlidir.
  • Sunucuya gereksiz yük bindirmemek için yoklama aralığınızı makul tutun (ör. her 30 ila 60 saniyede bir).

Sıkça Sorulan Sorular

Uç nokta yine de running false olarak ayarlanmış şekilde SUCCESS döndürür. Bilinmeyen toplantı kimlikleri için hata üretmez.

Hayır. Bir toplantı yalnızca en az bir katılımcı katıldığında çalışıyor kabul edilir. Oluşturulmuş ancak katılımcısı olmayan bir toplantı running değerini false olarak döndürür.

Basit durum kontrolleri için evet. Ancak gerçek zamanlı, olay güdümlü izleme için webhook’lar daha verimli bir alternatiftir; çünkü güncellemeleri tekrarlanan yoklama gerektirmek yerine uygulamanıza iletirler.

isMeetingRunning yalnızca toplantının etkin olup olmadığını belirten bir boolean döndürür. getMeetingInfo ise katılımcı listeleri, kayıt durumu, meta veriler ve daha fazlasını içeren kapsamlı ayrıntılar döndürür. Yalnızca hızlı bir evet-hayır yanıtına ihtiyacınız varsa isMeetingRunning kullanın.

Evet. BigBlueButton API, isMeetingRunning için hem GET hem de POST isteklerini kabul eder. Kullanılan HTTP yöntemi ne olursa olsun parametreler ve yanıt aynıdır.