621 lines
20 KiB
TypeScript
621 lines
20 KiB
TypeScript
import { MEDIA_TYPE } from '../media/constants';
|
|
import ReducerRegistry from '../redux/ReducerRegistry';
|
|
import { set } from '../redux/functions';
|
|
|
|
import {
|
|
DOMINANT_SPEAKER_CHANGED,
|
|
OVERWRITE_PARTICIPANT_NAME,
|
|
PARTICIPANT_ID_CHANGED,
|
|
PARTICIPANT_JOINED,
|
|
PARTICIPANT_LEFT,
|
|
PARTICIPANT_SOURCES_UPDATED,
|
|
PARTICIPANT_UPDATED,
|
|
PIN_PARTICIPANT,
|
|
RAISE_HAND_UPDATED,
|
|
SCREENSHARE_PARTICIPANT_NAME_CHANGED,
|
|
SET_LOADABLE_AVATAR_URL
|
|
} from './actionTypes';
|
|
import { LOCAL_PARTICIPANT_DEFAULT_ID, PARTICIPANT_ROLE } from './constants';
|
|
import {
|
|
isLocalScreenshareParticipant,
|
|
isParticipantModerator,
|
|
isRemoteScreenshareParticipant,
|
|
isScreenShareParticipant
|
|
} from './functions';
|
|
import { FakeParticipant, ILocalParticipant, IParticipant, ISourceInfo } from './types';
|
|
|
|
/**
|
|
* Participant object.
|
|
*
|
|
* @typedef {Object} Participant
|
|
* @property {string} id - Participant ID.
|
|
* @property {string} name - Participant name.
|
|
* @property {string} avatar - Path to participant avatar if any.
|
|
* @property {string} role - Participant role.
|
|
* @property {boolean} local - If true, participant is local.
|
|
* @property {boolean} pinned - If true, participant is currently a
|
|
* "PINNED_ENDPOINT".
|
|
* @property {boolean} dominantSpeaker - If this participant is the dominant
|
|
* speaker in the (associated) conference, {@code true}; otherwise,
|
|
* {@code false}.
|
|
* @property {string} email - Participant email.
|
|
*/
|
|
|
|
/**
|
|
* The participant properties which cannot be updated through
|
|
* {@link PARTICIPANT_UPDATED}. They either identify the participant or can only
|
|
* be modified through property-dedicated actions.
|
|
*
|
|
* @type {string[]}
|
|
*/
|
|
const PARTICIPANT_PROPS_TO_OMIT_WHEN_UPDATE = [
|
|
|
|
// The following properties identify the participant:
|
|
'conference',
|
|
'id',
|
|
'local',
|
|
|
|
// The following properties can only be modified through property-dedicated
|
|
// actions:
|
|
'dominantSpeaker',
|
|
'pinned'
|
|
];
|
|
|
|
const DEFAULT_STATE = {
|
|
dominantSpeaker: undefined,
|
|
everyoneIsModerator: false,
|
|
fakeParticipants: new Map(),
|
|
local: undefined,
|
|
localScreenShare: undefined,
|
|
overwrittenNameList: {},
|
|
pinnedParticipant: undefined,
|
|
raisedHandsQueue: [],
|
|
remote: new Map(),
|
|
remoteVideoSources: new Set<string>(),
|
|
sortedRemoteVirtualScreenshareParticipants: new Map(),
|
|
sortedRemoteParticipants: new Map(),
|
|
speakersList: new Map()
|
|
};
|
|
|
|
export interface IParticipantsState {
|
|
dominantSpeaker?: string;
|
|
everyoneIsModerator: boolean;
|
|
fakeParticipants: Map<string, IParticipant>;
|
|
local?: ILocalParticipant;
|
|
localScreenShare?: IParticipant;
|
|
overwrittenNameList: { [id: string]: string; };
|
|
pinnedParticipant?: string;
|
|
raisedHandsQueue: Array<{ id: string; raisedHandTimestamp: number; }>;
|
|
remote: Map<string, IParticipant>;
|
|
remoteVideoSources: Set<string>;
|
|
sortedRemoteParticipants: Map<string, string>;
|
|
sortedRemoteVirtualScreenshareParticipants: Map<string, string>;
|
|
speakersList: Map<string, string>;
|
|
}
|
|
|
|
/**
|
|
* Listen for actions which add, remove, or update the set of participants in
|
|
* the conference.
|
|
*
|
|
* @param {IParticipant[]} state - List of participants to be modified.
|
|
* @param {Object} action - Action object.
|
|
* @param {string} action.type - Type of action.
|
|
* @param {IParticipant} action.participant - Information about participant to be
|
|
* added/removed/modified.
|
|
* @returns {IParticipant[]}
|
|
*/
|
|
ReducerRegistry.register<IParticipantsState>('features/base/participants',
|
|
(state = DEFAULT_STATE, action): IParticipantsState => {
|
|
switch (action.type) {
|
|
case PARTICIPANT_ID_CHANGED: {
|
|
const { local } = state;
|
|
|
|
if (local) {
|
|
if (action.newValue === 'local' && state.raisedHandsQueue.find(pid => pid.id === local.id)) {
|
|
state.raisedHandsQueue = state.raisedHandsQueue.filter(pid => pid.id !== local.id);
|
|
}
|
|
state.local = {
|
|
...local,
|
|
id: action.newValue
|
|
};
|
|
|
|
return {
|
|
...state
|
|
};
|
|
}
|
|
|
|
return state;
|
|
}
|
|
case DOMINANT_SPEAKER_CHANGED: {
|
|
const { participant } = action;
|
|
const { id, previousSpeakers = [] } = participant;
|
|
const { dominantSpeaker, local } = state;
|
|
const newSpeakers = [ id, ...previousSpeakers ];
|
|
const sortedSpeakersList: Array<Array<string>> = [];
|
|
|
|
for (const speaker of newSpeakers) {
|
|
if (speaker !== local?.id) {
|
|
const remoteParticipant = state.remote.get(speaker);
|
|
|
|
remoteParticipant
|
|
&& sortedSpeakersList.push(
|
|
[ speaker, _getDisplayName(state, remoteParticipant?.name) ]
|
|
);
|
|
}
|
|
}
|
|
|
|
// Keep the remote speaker list sorted alphabetically.
|
|
sortedSpeakersList.sort((a, b) => a[1].localeCompare(b[1]));
|
|
|
|
// Only one dominant speaker is allowed.
|
|
if (dominantSpeaker) {
|
|
_updateParticipantProperty(state, dominantSpeaker, 'dominantSpeaker', false);
|
|
}
|
|
|
|
if (_updateParticipantProperty(state, id, 'dominantSpeaker', true)) {
|
|
return {
|
|
...state,
|
|
dominantSpeaker: id, // @ts-ignore
|
|
speakersList: new Map(sortedSpeakersList)
|
|
};
|
|
}
|
|
|
|
delete state.dominantSpeaker;
|
|
|
|
return {
|
|
...state
|
|
};
|
|
}
|
|
case PIN_PARTICIPANT: {
|
|
const { participant } = action;
|
|
const { id } = participant;
|
|
const { pinnedParticipant } = state;
|
|
|
|
// Only one pinned participant is allowed.
|
|
if (pinnedParticipant) {
|
|
_updateParticipantProperty(state, pinnedParticipant, 'pinned', false);
|
|
}
|
|
|
|
if (id && _updateParticipantProperty(state, id, 'pinned', true)) {
|
|
return {
|
|
...state,
|
|
pinnedParticipant: id
|
|
};
|
|
}
|
|
|
|
delete state.pinnedParticipant;
|
|
|
|
return {
|
|
...state
|
|
};
|
|
}
|
|
case SET_LOADABLE_AVATAR_URL:
|
|
case PARTICIPANT_UPDATED: {
|
|
const { participant } = action;
|
|
let { id } = participant;
|
|
const { local } = participant;
|
|
|
|
if (!id && local) {
|
|
id = LOCAL_PARTICIPANT_DEFAULT_ID;
|
|
}
|
|
|
|
let newParticipant: IParticipant | null = null;
|
|
|
|
if (state.remote.has(id)) {
|
|
newParticipant = _participant(state.remote.get(id), action);
|
|
state.remote.set(id, newParticipant);
|
|
} else if (id === state.local?.id) {
|
|
newParticipant = state.local = _participant(state.local, action);
|
|
}
|
|
|
|
if (newParticipant) {
|
|
|
|
// everyoneIsModerator calculation:
|
|
const isModerator = isParticipantModerator(newParticipant);
|
|
|
|
if (state.everyoneIsModerator && !isModerator) {
|
|
state.everyoneIsModerator = false;
|
|
} else if (!state.everyoneIsModerator && isModerator) {
|
|
state.everyoneIsModerator = _isEveryoneModerator(state);
|
|
}
|
|
}
|
|
|
|
return {
|
|
...state
|
|
};
|
|
}
|
|
case SCREENSHARE_PARTICIPANT_NAME_CHANGED: {
|
|
const { id, name } = action;
|
|
|
|
if (state.sortedRemoteVirtualScreenshareParticipants.has(id)) {
|
|
state.sortedRemoteVirtualScreenshareParticipants.delete(id);
|
|
|
|
const sortedRemoteVirtualScreenshareParticipants = [ ...state.sortedRemoteVirtualScreenshareParticipants ];
|
|
|
|
sortedRemoteVirtualScreenshareParticipants.push([ id, name ]);
|
|
sortedRemoteVirtualScreenshareParticipants.sort((a, b) => a[1].localeCompare(b[1]));
|
|
|
|
state.sortedRemoteVirtualScreenshareParticipants = new Map(sortedRemoteVirtualScreenshareParticipants);
|
|
}
|
|
|
|
return { ...state };
|
|
}
|
|
|
|
case PARTICIPANT_JOINED: {
|
|
const participant = _participantJoined(action);
|
|
const {
|
|
fakeParticipant,
|
|
id,
|
|
name,
|
|
pinned,
|
|
sources
|
|
} = participant;
|
|
const { pinnedParticipant, dominantSpeaker } = state;
|
|
|
|
if (pinned) {
|
|
if (pinnedParticipant) {
|
|
_updateParticipantProperty(state, pinnedParticipant, 'pinned', false);
|
|
}
|
|
|
|
state.pinnedParticipant = id;
|
|
}
|
|
|
|
if (participant.dominantSpeaker) {
|
|
if (dominantSpeaker) {
|
|
_updateParticipantProperty(state, dominantSpeaker, 'dominantSpeaker', false);
|
|
}
|
|
state.dominantSpeaker = id;
|
|
}
|
|
|
|
const isModerator = isParticipantModerator(participant);
|
|
const { local, remote } = state;
|
|
|
|
if (state.everyoneIsModerator && !isModerator) {
|
|
state.everyoneIsModerator = false;
|
|
} else if (!local && remote.size === 0 && isModerator) {
|
|
state.everyoneIsModerator = true;
|
|
}
|
|
|
|
if (participant.local) {
|
|
return {
|
|
...state,
|
|
local: participant
|
|
};
|
|
}
|
|
|
|
if (isLocalScreenshareParticipant(participant)) {
|
|
return {
|
|
...state,
|
|
localScreenShare: participant
|
|
};
|
|
}
|
|
|
|
state.remote.set(id, participant);
|
|
|
|
if (sources?.size) {
|
|
const videoSources: Map<string, ISourceInfo> | undefined = sources.get(MEDIA_TYPE.VIDEO);
|
|
|
|
if (videoSources?.size) {
|
|
const newRemoteVideoSources = new Set(state.remoteVideoSources);
|
|
|
|
for (const source of videoSources.keys()) {
|
|
newRemoteVideoSources.add(source);
|
|
}
|
|
state.remoteVideoSources = newRemoteVideoSources;
|
|
}
|
|
}
|
|
|
|
// Insert the new participant.
|
|
const displayName = _getDisplayName(state, name);
|
|
const sortedRemoteParticipants = Array.from(state.sortedRemoteParticipants);
|
|
|
|
sortedRemoteParticipants.push([ id, displayName ]);
|
|
sortedRemoteParticipants.sort((a, b) => a[1].localeCompare(b[1]));
|
|
|
|
// The sort order of participants is preserved since Map remembers the original insertion order of the keys.
|
|
state.sortedRemoteParticipants = new Map(sortedRemoteParticipants);
|
|
|
|
if (isRemoteScreenshareParticipant(participant)) {
|
|
const sortedRemoteVirtualScreenshareParticipants = [ ...state.sortedRemoteVirtualScreenshareParticipants ];
|
|
|
|
sortedRemoteVirtualScreenshareParticipants.push([ id, name ?? '' ]);
|
|
sortedRemoteVirtualScreenshareParticipants.sort((a, b) => a[1].localeCompare(b[1]));
|
|
|
|
state.sortedRemoteVirtualScreenshareParticipants = new Map(sortedRemoteVirtualScreenshareParticipants);
|
|
}
|
|
|
|
// Exclude the screenshare participant from the fake participant count to avoid duplicates.
|
|
if (fakeParticipant && !isScreenShareParticipant(participant)) {
|
|
state.fakeParticipants.set(id, participant);
|
|
}
|
|
|
|
return { ...state };
|
|
|
|
}
|
|
case PARTICIPANT_LEFT: {
|
|
// XXX A remote participant is uniquely identified by their id in a
|
|
// specific JitsiConference instance. The local participant is uniquely
|
|
// identified by the very fact that there is only one local participant
|
|
// (and the fact that the local participant "joins" at the beginning of
|
|
// the app and "leaves" at the end of the app).
|
|
const { conference, id } = action.participant;
|
|
const {
|
|
fakeParticipants,
|
|
sortedRemoteVirtualScreenshareParticipants,
|
|
remote,
|
|
local,
|
|
localScreenShare,
|
|
dominantSpeaker,
|
|
pinnedParticipant
|
|
} = state;
|
|
let oldParticipant = remote.get(id);
|
|
|
|
if (oldParticipant?.sources?.size) {
|
|
const videoSources: Map<string, ISourceInfo> | undefined = oldParticipant.sources.get(MEDIA_TYPE.VIDEO);
|
|
const newRemoteVideoSources = new Set(state.remoteVideoSources);
|
|
|
|
if (videoSources?.size) {
|
|
for (const source of videoSources.keys()) {
|
|
newRemoteVideoSources.delete(source);
|
|
}
|
|
}
|
|
state.remoteVideoSources = newRemoteVideoSources;
|
|
} else if (oldParticipant?.fakeParticipant === FakeParticipant.RemoteScreenShare) {
|
|
const newRemoteVideoSources = new Set(state.remoteVideoSources);
|
|
|
|
newRemoteVideoSources.delete(id);
|
|
state.remoteVideoSources = newRemoteVideoSources;
|
|
}
|
|
|
|
if (oldParticipant && oldParticipant.conference === conference) {
|
|
remote.delete(id);
|
|
} else if (local?.id === id) {
|
|
oldParticipant = state.local;
|
|
delete state.local;
|
|
} else if (localScreenShare?.id === id) {
|
|
oldParticipant = state.local;
|
|
delete state.localScreenShare;
|
|
} else {
|
|
// no participant found
|
|
return state;
|
|
}
|
|
|
|
state.sortedRemoteParticipants.delete(id);
|
|
state.raisedHandsQueue = state.raisedHandsQueue.filter(pid => pid.id !== id);
|
|
|
|
if (!state.everyoneIsModerator && !isParticipantModerator(oldParticipant)) {
|
|
state.everyoneIsModerator = _isEveryoneModerator(state);
|
|
}
|
|
|
|
if (dominantSpeaker === id) {
|
|
state.dominantSpeaker = undefined;
|
|
}
|
|
|
|
// Remove the participant from the list of speakers.
|
|
state.speakersList.has(id) && state.speakersList.delete(id);
|
|
|
|
if (pinnedParticipant === id) {
|
|
state.pinnedParticipant = undefined;
|
|
}
|
|
|
|
if (fakeParticipants.has(id)) {
|
|
fakeParticipants.delete(id);
|
|
}
|
|
|
|
if (sortedRemoteVirtualScreenshareParticipants.has(id)) {
|
|
sortedRemoteVirtualScreenshareParticipants.delete(id);
|
|
state.sortedRemoteVirtualScreenshareParticipants = new Map(sortedRemoteVirtualScreenshareParticipants);
|
|
}
|
|
|
|
return { ...state };
|
|
}
|
|
case PARTICIPANT_SOURCES_UPDATED: {
|
|
const { id, sources } = action.participant;
|
|
const participant = state.remote.get(id);
|
|
|
|
if (participant) {
|
|
participant.sources = sources;
|
|
const videoSources: Map<string, ISourceInfo> = sources.get(MEDIA_TYPE.VIDEO);
|
|
|
|
if (videoSources?.size) {
|
|
const newRemoteVideoSources = new Set(state.remoteVideoSources);
|
|
|
|
for (const source of videoSources.keys()) {
|
|
newRemoteVideoSources.add(source);
|
|
}
|
|
state.remoteVideoSources = newRemoteVideoSources;
|
|
}
|
|
}
|
|
|
|
return { ...state };
|
|
}
|
|
case RAISE_HAND_UPDATED: {
|
|
return {
|
|
...state,
|
|
raisedHandsQueue: action.queue
|
|
};
|
|
}
|
|
case OVERWRITE_PARTICIPANT_NAME: {
|
|
const { id, name } = action;
|
|
|
|
return {
|
|
...state,
|
|
overwrittenNameList: {
|
|
...state.overwrittenNameList,
|
|
[id]: name
|
|
}
|
|
};
|
|
}
|
|
}
|
|
|
|
return state;
|
|
});
|
|
|
|
/**
|
|
* Returns the participant's display name, default string if display name is not set on the participant.
|
|
*
|
|
* @param {Object} state - The local participant redux state.
|
|
* @param {string} name - The display name of the participant.
|
|
* @returns {string}
|
|
*/
|
|
function _getDisplayName(state: Object, name?: string): string {
|
|
// @ts-ignore
|
|
const config = state['features/base/config'];
|
|
|
|
return name ?? (config?.defaultRemoteDisplayName || 'Fellow Jitster');
|
|
}
|
|
|
|
/**
|
|
* Loops through the participants in the state in order to check if all participants are moderators.
|
|
*
|
|
* @param {Object} state - The local participant redux state.
|
|
* @returns {boolean}
|
|
*/
|
|
function _isEveryoneModerator(state: IParticipantsState) {
|
|
if (isParticipantModerator(state.local)) {
|
|
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
|
for (const [ k, p ] of state.remote) {
|
|
if (!isParticipantModerator(p)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Reducer function for a single participant.
|
|
*
|
|
* @param {IParticipant|undefined} state - Participant to be modified.
|
|
* @param {Object} action - Action object.
|
|
* @param {string} action.type - Type of action.
|
|
* @param {IParticipant} action.participant - Information about participant to be
|
|
* added/modified.
|
|
* @param {JitsiConference} action.conference - Conference instance.
|
|
* @private
|
|
* @returns {IParticipant}
|
|
*/
|
|
function _participant(state: IParticipant | ILocalParticipant = { id: '' },
|
|
action: any): IParticipant | ILocalParticipant {
|
|
switch (action.type) {
|
|
case SET_LOADABLE_AVATAR_URL:
|
|
case PARTICIPANT_UPDATED: {
|
|
const { participant } = action; // eslint-disable-line no-shadow
|
|
|
|
const newState = { ...state };
|
|
|
|
for (const key in participant) {
|
|
if (participant.hasOwnProperty(key)
|
|
&& PARTICIPANT_PROPS_TO_OMIT_WHEN_UPDATE.indexOf(key)
|
|
=== -1) {
|
|
// @ts-ignore
|
|
newState[key] = participant[key];
|
|
}
|
|
}
|
|
|
|
return newState;
|
|
}
|
|
}
|
|
|
|
return state;
|
|
}
|
|
|
|
/**
|
|
* Reduces a specific redux action of type {@link PARTICIPANT_JOINED} in the
|
|
* feature base/participants.
|
|
*
|
|
* @param {Action} action - The redux action of type {@code PARTICIPANT_JOINED}
|
|
* to reduce.
|
|
* @private
|
|
* @returns {Object} The new participant derived from the payload of the
|
|
* specified {@code action} to be added into the redux state of the feature
|
|
* base/participants after the reduction of the specified
|
|
* {@code action}.
|
|
*/
|
|
function _participantJoined({ participant }: { participant: IParticipant; }) {
|
|
const {
|
|
avatarURL,
|
|
botType,
|
|
dominantSpeaker,
|
|
email,
|
|
fakeParticipant,
|
|
isReplacing,
|
|
loadableAvatarUrl,
|
|
local,
|
|
name,
|
|
pinned,
|
|
presence,
|
|
role,
|
|
sources
|
|
} = participant;
|
|
let { conference, id } = participant;
|
|
|
|
if (local) {
|
|
// conference
|
|
//
|
|
// XXX The local participant is not identified in association with a
|
|
// JitsiConference because it is identified by the very fact that it is
|
|
// the local participant.
|
|
conference = undefined;
|
|
|
|
// id
|
|
id || (id = LOCAL_PARTICIPANT_DEFAULT_ID);
|
|
}
|
|
|
|
return {
|
|
avatarURL,
|
|
botType,
|
|
conference,
|
|
dominantSpeaker: dominantSpeaker || false,
|
|
email,
|
|
fakeParticipant,
|
|
id,
|
|
isReplacing,
|
|
loadableAvatarUrl,
|
|
local: local || false,
|
|
name,
|
|
pinned: pinned || false,
|
|
presence,
|
|
role: role || PARTICIPANT_ROLE.NONE,
|
|
sources
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Updates a specific property for a participant.
|
|
*
|
|
* @param {State} state - The redux state.
|
|
* @param {string} id - The ID of the participant.
|
|
* @param {string} property - The property to update.
|
|
* @param {*} value - The new value.
|
|
* @returns {boolean} - True if a participant was updated and false otherwise.
|
|
*/
|
|
function _updateParticipantProperty(state: IParticipantsState, id: string, property: string, value: boolean) {
|
|
const { remote, local, localScreenShare } = state;
|
|
|
|
if (remote.has(id)) {
|
|
remote.set(id, set(remote.get(id) ?? {
|
|
id: '',
|
|
name: ''
|
|
}, property as keyof IParticipant, value));
|
|
|
|
return true;
|
|
} else if (local?.id === id || local?.id === 'local') {
|
|
// The local participant's ID can chance from something to "local" when
|
|
// not in a conference.
|
|
state.local = set(local, property as keyof ILocalParticipant, value);
|
|
|
|
return true;
|
|
|
|
} else if (localScreenShare?.id === id) {
|
|
state.localScreenShare = set(localScreenShare, property as keyof IParticipant, value);
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|