bigbluebutton-Github/akka-bbb-fsesl
prlanzarin 8feb934169 feat(audio): add experimental transparent listen only mode
This is an initial, experimental implementation of the feature proposed in
https://github.com/bigbluebutton/bigbluebutton/issues/14021.

The intention is to phase out the explicit listen only mode with two
overarching goals:
  - Reduce UX friction and increase familiarity: the existence of a separate
  listen only mode is a source of confusion for the majority of users
  Reduce average server-side CPU usage while also making it possible for
  having full audio-only meetings.

The proof-of-concept works based on the assumption that a "many
concurrent active talkers" scenario is both rare and not useful. With
that in mind, this including two server-side triggers:
 - On microphone inactivity (currently mute action that is sustained for
   4 seconds, configurable): FreeSWITCH channels are held (which translates
   to much lower CPU usage, virtually 0%). Receiving channels are switched,
   server side, to a listening mode (SFU, mediasoup).
   * This required an extension to mediasoup two allow re-assigning producers
     to already established consumers. No re-negotiation is done.
 - On microphone activity (currently unmute action, immediate):
   FreeSWITCH channels are unheld, listening mode is deactivated and the
   mute state is updated accordingly (in this order).

This is *off by default*. It needs to be enabled in two places:
  - `/etc/bigbluebutton/bbb-webrtc-sfu/production.yml` ->
    `transparentListenOnly: true`
  - End users:
    * Server wide: `/etc/bigbluebutton/bbb-html5.yml` ->
      `public.media.transparentListenOnly: true`
    * Per user: `userdata-bbb_transparent_listen_only=true`
2023-08-07 19:43:18 -03:00
..
project chore: upgrade scala 2.13.4 -> 2.13.9 2022-12-20 16:07:08 +00:00
src feat(audio): add experimental transparent listen only mode 2023-08-07 19:43:18 -03:00
.gitignore Make sure we record audio if meeting is recorded 2019-10-17 11:50:12 -07:00
.scalariform.conf - enable scalariforn for fsesl-akka 2019-03-27 13:33:22 -07:00
build.sbt build: use Java17 to build akka projects 2023-06-13 14:26:12 -04:00
run-dev.sh Services run as starting PID 2021-04-05 12:24:29 +02:00
run.sh Services run as starting PID 2021-04-05 12:24:29 +02:00
wait-for-it.sh fsesl wait for freeswitch; change links by depends_on; remove freeswitch ipv6 config files; enable wss-binding element on freeswitch; fix kurento listen only 2018-08-24 17:15:47 -03:00