Клієнтські бібліотеки та інструменти інтеграції

Клієнтські бібліотеки приховують деталі обчислення контрольної суми, побудови HTTP-запитів і розбору XML-відповідей, дозволяючи вам взаємодіяти з API BigBlueButton через типізовані методи у вибраній вами мові програмування. У цьому розділі подано огляд доступних бібліотек, інструментів інтеграції та рекомендації щодо вибору правильного варіанта для вашого проєкту.

Офіційні бібліотеки

Наведені нижче бібліотеки підтримуються самим проєктом BigBlueButton або тісно пов’язаними учасниками. Зазвичай вони добре підтримуються й відстежують нові можливості API у міру їх випуску.

Бібліотеки спільноти

Ці бібліотеки розробляються та підтримуються спільнотою. Їхня якість і частота оновлень відрізняються — завжди перевіряйте стан підтримки та підтримувану версію BBB, перш ніж обирати одну з них.

Інструменти інтеграції

Окрім клієнтських бібліотек, кілька інструментів можуть допомогти вам тестувати, керувати та масштабувати розгортання BigBlueButton:

Вибір бібліотеки

Оцінюючи клієнтську бібліотеку для вашого проєкту, врахуйте такі критерії:

• Підтримка версій BBB: Чи підтримує бібліотека можливості BBB 3.0, такі як role замість password, sendChatMessage і clientSettingsOverride?
• Алгоритм контрольної суми: Чи підтримує бібліотека SHA-256 і SHA-512, чи лише застарілий SHA-1?
• Підтримка POST: Чи може бібліотека надсилати тіла XML (потрібні для завантаження презентацій і clientSettingsOverride)?
• Стан підтримки: Коли був останній коміт? Чи є невирішені проблеми без жодної відповіді?
• Підтримка webhook: Чи пропонує бібліотека допоміжні функції для реєстрації webhook і перевірки callback?

Створення власної інтеграції

Якщо жодна з наявних бібліотек не відповідає вашим вимогам, ви можете створити власну інтеграцію будь-якою мовою, що підтримує HTTP. Основна логіка складається з трьох компонентів:

Для простих інтеграцій, яким потрібні лише create і join, цього можна досягти лише кількома рядками коду — повна бібліотека не є строго необхідною.

# Minimal example: create + join (pseudocode)

secret = "replace-with-secret"
base   = "https://api-guide.bbbserver.com/bigbluebutton/api"

# 1. Build query string
params = "name=Demo&meetingID=replace-with-meeting-id&attendeePW=replace-with-password&moderatorPW=replace-with-password"

# 2. Compute checksum
checksum = sha256("create" + params + secret)

# 3. Send request
response = http_get(base + "/create?" + params + "&checksum=" + checksum)

# 4. Parse XML response
if parse_xml(response).returncode == "SUCCESS":
    # Build join URL for a moderator
    join_params = "fullName=Admin&meetingID=demo-1&role=MODERATOR"
    join_checksum = sha256("join" + join_params + secret)
    redirect_to(base + "/join?" + join_params + "&checksum=" + join_checksum)