Files
Testing/html5-chat1/nodeMulti/node_modules/mediasoup/lib/plugins/ActiveSpeakerDetector.js
sean 0e8a8b3028
Some checks are pending
deploy-testing / deploy (push) Waiting to run
Initial testing snapshot
2026-11-17 16:15:01 -05:00

188 lines
3.7 KiB
JavaScript

const Logger = require('../Logger');
const EnhancedEventEmitter = require('../EnhancedEventEmitter');
const REQUIRED_MIN_AUDIO_LEVEL = -80; // dB.
const REQUIRED_MAX_NUM_REPORTS = 4;
const logger = new Logger('ActiveSpeakerDetector');
class ActiveSpeakerDetector extends EnhancedEventEmitter
{
constructor(room)
{
super(logger);
logger.debug('constructor()');
// Closed flag.
// @type {Boolean}
this._closed = false;
// Handled Room.
// @type {Room}
this._room = room;
// Latest max audio level reports.
// @type {Array}
this._reports = [];
// Current active Producer.
// @type {Producer}
this._activeProducer = null;
// Bind the 'audiolevels' listener so we can remove it on closure.
this._onRoomAudioLevels = this._onRoomAudioLevels.bind(this);
this._handleRoom();
}
get closed()
{
return this._closed;
}
/**
* Close the ActiveSpeakerDetector.
*/
close()
{
logger.debug('close()');
if (this._closed)
return;
this._closed = true;
if (!this._room.closed)
this._room.removeListener('audiolevels', this._onRoomAudioLevels);
this.safeEmit('close');
}
_handleRoom()
{
const room = this._room;
room.on('close', () => this.close());
room.on('audiolevels', this._onRoomAudioLevels);
}
_onRoomAudioLevels(levels)
{
if (this._closed)
return;
let previousActiveProducer = this._activeProducer;
let requiredNumReports;
if (
previousActiveProducer &&
!previousActiveProducer.closed &&
!previousActiveProducer.paused
)
{
requiredNumReports = REQUIRED_MAX_NUM_REPORTS;
}
else
{
previousActiveProducer = null;
requiredNumReports = 1;
this._reports = [];
}
const reports = this._reports;
// Insert the loudest audio level report into the reports array.
// NOTE: This may be undefined, meaning that nobody is producing audio.
reports.push(levels[0]);
// No more than REQUIRED_MAX_NUM_REPORTS.
if (reports.length > REQUIRED_MAX_NUM_REPORTS)
{
reports.shift();
}
// No less than requiredNumReports.
else if (reports.length < requiredNumReports)
{
this._mayUpdateActiveSpeaker(previousActiveProducer);
return;
}
// If the same Producer was the loudest speaker in the last N reports, make
// it the active speaker.
let currentActiveProducer;
const numReports = reports.length;
for (let i = numReports - 1; i >= numReports - requiredNumReports; --i)
{
const report = reports[i];
if (!report)
{
currentActiveProducer = null;
break;
}
const { producer, audioLevel } = report;
if (producer.closed || producer.paused || audioLevel < REQUIRED_MIN_AUDIO_LEVEL)
{
currentActiveProducer = null;
break;
}
if (currentActiveProducer && producer !== currentActiveProducer)
{
currentActiveProducer = null;
break;
}
currentActiveProducer = producer;
}
// If there is an effective new audio Producer, make it the active one.
if (currentActiveProducer)
{
this._mayUpdateActiveSpeaker(currentActiveProducer);
}
// Otherwise check the previous active speaker.
else
{
this._mayUpdateActiveSpeaker(previousActiveProducer);
}
}
_mayUpdateActiveSpeaker(activeProducer)
{
if (this._activeProducer === activeProducer)
return;
this._activeProducer = activeProducer;
if (this._activeProducer)
{
const peer = this._activeProducer.peer;
logger.debug(
'emitting "activespeakerchange" [peerName:"%s"]', peer.name);
this.safeEmit(
'activespeakerchange', peer, this._activeProducer);
}
else
{
logger.debug(
'emitting "activespeakerchange" [peerName:null]');
this.safeEmit('activespeakerchange', undefined, undefined);
}
}
}
module.exports = ActiveSpeakerDetector;