Обзор: Добавьте голосовые комнаты в стиле Discord в свое сообщество 🎙

Привет всем! Делюсь Resenha, экспериментальным плагином, который добавляет голосовые и видеочаты прямо в Discourse — без необходимости использования сторонних приложений, просто P2P-соединение через WebRTC в боковой панели.

output

Попробовать вживую

:point_right: https://discourse-on-a-pi5.falco.dev/

(Да, это работает на Raspberry Pi 5 — настолько это легковесное решение.)

Как это работает

Нажмите на комнату в боковой панели, чтобы присоединиться, и снова нажмите, чтобы выйти. По умолчанию весь трафик передается напрямую между пользователями через WebRTC — ваш сервер Discourse обрабатывает только сигналы, но не медиапоток. Сайтам, которым нужны более масштабные звонки, можно опционально маршрутизировать комнаты через медиа-сервер LiveKit — либо через LiveKit Cloud, либо через собственный хостинг. При установке создается комната по умолчанию «Watercooler», чтобы ваше сообщество могло сразу начать общение.

Возможности

  • Интерфейс, ориентированный на боковую панель — комнаты и аватары участников, находящихся в эфире, прямо в боковой панели, в стиле Discord, с анимированными индикаторами речи
  • Видео и демонстрация экрана — опциональное видео с камеры и демонстрация экрана/вкладки с полной страницей комнаты, макетами плитки/презентации и поддержкой полноэкранного режима
  • Виджет постоянного вызова — закрепленный, масштабируемый мини-вызов, который следует за вами при просмотре форума, включая видео
  • Настройки голоса и видео — выбор устройств, тест микрофона в реальном времени, порог чувствительности входа, шумоподавление на базе WebAssembly (DTLN) и размытие фона с помощью MediaPipe — всё обрабатывается локально в браузере
  • Чат комнаты — каждая комната имеет текстовый чат, поддерживаемый реальными каналами и ветками чата Discourse
  • Комнаты со сценой — комнаты для спикеров и аудитории с очередью запросов на выступление, для AMAs и общинных звонков
  • Разрешения комнат — публичные, ограниченные для групп и частные комнаты, с значками блокировки в боковой панели и хэштегами комнат для ссылок на комнаты в постах
  • Управление участниками — контекстное меню с регулировкой громкости, отключением звука, оглушением и удалением для каждого пользователя; плюс автоматическое отключение звука/отключение при бездействии (AFK) и автоматический статус пользователя
  • Управление комнатами — создание комнат пользователями ограничено группами, интерфейс CRUD для персонала и полный REST API для программного управления
  • Нулевая инфраструктура по умолчанию — чистый WebRTC в браузере с шифрованием DTLS-SRTP, без необходимости в SFU/MCU
  • Опциональная интеграция с LiveKit — включайте комнаты индивидуально или маршрутизируйте всё через LiveKit Cloud или свой собственный сервер LiveKit для крупных звонков, с панелью состояния администратора и согласованием на основе веб-хуков

Статус

:warning: Бета — Режим по умолчанию P2P протестирован и хорошо работает с небольшими группами (2–10 участников). Для больших комнат укажите плагин на LiveKit (Cloud или собственный хостинг) — всё остальное продолжает работать идентично.

Установка

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/xfalcox/resenha.git

Включите в Админ > Настройки > Плагины > resenha enabled.

Жду отзывов

Это эксперимент — баги, идеи и вопросы приветствуются в этой теме. PRs тоже!


Примечание: Это не official плагин.

54 лайка

Отзыв, просто супер! Обожаю, спасибо, мой земляк!

12 лайков

Только что установил, и всё заработало примерно за полчаса. Похоже, работает отлично! Хотелось бы увидеть несколько изменений и дополнений в функциях:

Функция Статус
Переименовать комнату :cross_mark: Не реализовано
Удалить комнату :cross_mark: Не реализовано
Изменить имя комнаты по умолчанию :cross_mark: Закодировано в исходном коде
Привязать комнаты к категориям Discourse :cross_mark: Не поддерживается
Настроить права доступа для каждой комнаты :cross_mark: Не поддерживается
Создавать комнаты с автоматическим истечением срока действия :cross_mark: Не поддерживается
Описания/темы комнат :cross_mark: Не поддерживается
10 лайков

Это потрясающе. Есть ли у команды планы сделать это официальным после выхода из альфы?

7 лайков

На данный момент планов нет, так как это в основном исследование возможностей технологии и того, как она может интегрироваться с Discourse.

Тем не менее, как и во всём остальном, всё зависит от того, чего хотят наши клиенты.

9 лайков

Это действительно круто, Фалько! Я вижу множество применений для этого, учитывая то, что вы перечислили. Плагины с такими функциями, как этот, определенно помогают сделать Discourse Meta ведущей платформой!

4 лайка

Где находится опция создания новой комнаты?

Для этого нет пользовательского интерфейса, так как это экспериментальный проект в области технологии, а не готовое решение для производственных сайтов.

2 лайка

Разве сейчас не должен быть присутствовать experimental?

Крутой плагин

3 лайка

Я несколько дней пробовал это в действии — и это просто великолепно!!!

Это прекрасно решает проблему лёгкого «переноса» обсуждения с форума или чата в голосовой разговор. Я годами мучился с необходимостью переключаться на другие платформы или использовать ресурсоёмкие (попытки) встроенные видеоконференции.

Если вы решите развивать проект дальше, я бы хотел, чтобы он был спроектирован с возможностью интеграции с чатом. Было бы просто восхитительно иметь возможность запускать приватную голосовую комнату для участников чата прямо из самого чата (с последующей уборкой, чтобы всё оставалось в порядке). При этом чат останется идеальным местом для добавления дополнительных комментариев, файлов, ссылок и т.д.

Вишенкой на торте, конечно же, стали бы:

  1. Возможность видеосвязи (вероятно, технически невозможна с такой лёгкой технологией)

  2. AI-транскрипция, достаточно умная для интеграции связанных тем и чата. Это было бы абсолютно потрясающе как инструмент для ведения протоколов встреч.

11 лайков

Спасибо за обратную связь! Это была именно моя цель при создании этого!

Безусловно, это был бы логичный следующий шаг, с поддержкой эфемерных комнат.

Это вполне реализуемо: как без SFU/MCU для пользователей с достаточной скоростью загрузки, так и с опциональной поддержкой таких решений.

7 лайков

Это было отлично. Я не буду обновлять это долгое время, но в феврале я обновлю его в последний раз, когда будет выпущена ESR, чтобы включить этот плагин.

Я так этому рад и надеюсь, что это случится.

2 лайка

Хотите использовать более «кулерный» иконку?

image

Вставьте это в TC:

// Поместите это во вкладку JS или в /javascripts/discourse/api-initializers/...
import { apiInitializer } from "discourse/lib/api";

export default apiInitializer(api => {
  api.replaceIcon("microphone-lines", "bottle-water");
});
/* Переверните иконку bottle-water вверх дном в боковой панели Resenha — поместите в Common */
.sidebar-section.sidebar-section-wrapper [class*="d-icon-microphone-lines"] {
  transform: rotate(180deg);
  /* При необходимости можно также настроить вертикальное выравнивание */
  display: inline-block;
}
3 лайка

Теперь есть интерфейс для управления комнатами.

10 лайков

Спасибо, Falco, за этот плагин :heart:

Отличная работа :+1:

1 лайк

Я тестирую в продакшене, вернусь с отзывами! Vamos Resenhar :brazil:

1 лайк

Может быть, в этом случае лучше использовать спиннер? Когда я захожу в комнату и нажимаю на свой профиль или профиль другого пользователя, DOM обновляется, и меня перекидывает на главную страницу.

Теперь доступен экран с подробностями о комнате, использующий паттерн меню-«кебаб» из Discourse Chat.

2 лайка

В теме по умолчанию наложения нет, возможно, стоит настроить вашу тему так, чтобы она учитывала меньшее пространство для отступов?

image

Это уже исправлено.

3 лайка

В свете последних новостей я добавил в плагин новую функцию: фильтр шума на базе ИИ.

Администраторы могут сделать его доступным через настройку сайта (по умолчанию: выключено), а пользователи смогут включить его, нажав на своё имя в комнате голосового чата.

6 лайков