/* global APP, JitsiMeetJS, config, interfaceConfig */ import { jitsiLocalStorage } from '@jitsi/js-utils'; import EventEmitter from 'events'; import Logger from 'jitsi-meet-logger'; import { openConnection } from './connection'; import { ENDPOINT_TEXT_MESSAGE_NAME } from './modules/API/constants'; import { AUDIO_ONLY_SCREEN_SHARE_NO_TRACK } from './modules/UI/UIErrors'; import AuthHandler from './modules/UI/authentication/AuthHandler'; import UIUtil from './modules/UI/util/UIUtil'; import mediaDeviceHelper from './modules/devices/mediaDeviceHelper'; import Recorder from './modules/recorder/Recorder'; import { createTaskQueue } from './modules/util/helpers'; import { createDeviceChangedEvent, createStartSilentEvent, createScreenSharingEvent, createTrackMutedEvent, sendAnalytics } from './react/features/analytics'; import { maybeRedirectToWelcomePage, redirectToStaticPage, reloadWithStoredParams } from './react/features/app/actions'; import { AVATAR_URL_COMMAND, EMAIL_COMMAND, authStatusChanged, commonUserJoinedHandling, commonUserLeftHandling, conferenceFailed, conferenceJoined, conferenceLeft, conferenceSubjectChanged, conferenceTimestampChanged, conferenceUniqueIdSet, conferenceWillJoin, conferenceWillLeave, dataChannelOpened, getConferenceOptions, kickedOut, lockStateChanged, onStartMutedPolicyChanged, p2pStatusChanged, sendLocalParticipant } from './react/features/base/conference'; import { getReplaceParticipant } from './react/features/base/config/functions'; import { checkAndNotifyForNewDevice, getAvailableDevices, getDefaultDeviceId, notifyCameraError, notifyMicError, setAudioOutputDeviceId, updateDeviceList } from './react/features/base/devices'; import { isIosMobileBrowser } from './react/features/base/environment/utils'; import { browser, isFatalJitsiConnectionError, JitsiConferenceErrors, JitsiConferenceEvents, JitsiConnectionErrors, JitsiConnectionEvents, JitsiMediaDevicesEvents, JitsiParticipantConnectionStatus, JitsiTrackErrors, JitsiTrackEvents } from './react/features/base/lib-jitsi-meet'; import { getStartWithAudioMuted, getStartWithVideoMuted, isVideoMutedByUser, MEDIA_TYPE, setAudioAvailable, setAudioMuted, setVideoAvailable, setVideoMuted } from './react/features/base/media'; import { dominantSpeakerChanged, getLocalParticipant, getNormalizedDisplayName, getParticipantById, localParticipantConnectionStatusChanged, localParticipantRoleChanged, participantConnectionStatusChanged, participantKicked, participantMutedUs, participantPresenceChanged, participantRoleChanged, participantUpdated, updateRemoteParticipantFeatures } from './react/features/base/participants'; import { getUserSelectedCameraDeviceId, updateSettings } from './react/features/base/settings'; import { createLocalPresenterTrack, createLocalTracksF, destroyLocalTracks, getLocalJitsiAudioTrack, getLocalJitsiVideoTrack, getLocalTracks, isLocalCameraTrackMuted, isLocalTrackMuted, isUserInteractionRequiredForUnmute, replaceLocalTrack, trackAdded, trackRemoved } from './react/features/base/tracks'; import { downloadJSON } from './react/features/base/util/downloadJSON'; import { showDesktopPicker } from './react/features/desktop-picker'; import { appendSuffix } from './react/features/display-name'; import { maybeOpenFeedbackDialog, submitFeedback } from './react/features/feedback'; import { showNotification } from './react/features/notifications'; import { mediaPermissionPromptVisibilityChanged, toggleSlowGUMOverlay } from './react/features/overlay'; import { suspendDetected } from './react/features/power-monitor'; import { initPrejoin, isPrejoinPageEnabled, isPrejoinPageVisible, makePrecallTest } from './react/features/prejoin'; import { disableReceiver, stopReceiver } from './react/features/remote-control'; import { setScreenAudioShareState, isScreenAudioShared } from './react/features/screen-share/'; import { toggleScreenshotCaptureEffect } from './react/features/screenshot-capture'; import { AudioMixerEffect } from './react/features/stream-effects/audio-mixer/AudioMixerEffect'; import { createPresenterEffect } from './react/features/stream-effects/presenter'; import { createRnnoiseProcessor } from './react/features/stream-effects/rnnoise'; import { endpointMessageReceived } from './react/features/subtitles'; import UIEvents from './service/UI/UIEvents'; const logger = Logger.getLogger(__filename); const eventEmitter = new EventEmitter(); let room; let connection; /** * The promise is used when the prejoin screen is shown. * While the user configures the devices the connection can be made. * * @type {Promise} * @private */ let _connectionPromise; /** * This promise is used for chaining mutePresenterVideo calls in order to avoid calling GUM multiple times if it takes * a while to finish. * * @type {Promise} * @private */ let _prevMutePresenterVideo = Promise.resolve(); /* * Logic to open a desktop picker put on the window global for * lib-jitsi-meet to detect and invoke */ window.JitsiMeetScreenObtainer = { openDesktopPicker(options, onSourceChoose) { APP.store.dispatch(showDesktopPicker(options, onSourceChoose)); } }; /** * Known custom conference commands. */ const commands = { AVATAR_URL: AVATAR_URL_COMMAND, CUSTOM_ROLE: 'custom-role', EMAIL: EMAIL_COMMAND, ETHERPAD: 'etherpad' }; /** * Open Connection. When authentication failed it shows auth dialog. * @param roomName the room name to use * @returns Promise */ function connect(roomName) { return openConnection({ retry: true, roomName }) .catch(err => { if (err === JitsiConnectionErrors.PASSWORD_REQUIRED) { APP.UI.notifyTokenAuthFailed(); } else { APP.UI.notifyConnectionFailed(err); } throw err; }); } /** * Share data to other users. * @param command the command * @param {string} value new value */ function sendData(command, value) { if (!room) { return; } room.removeCommand(command); room.sendCommand(command, { value }); } /** * Get user nickname by user id. * @param {string} id user id * @returns {string?} user nickname or undefined if user is unknown. */ function getDisplayName(id) { const participant = getParticipantById(APP.store.getState(), id); return participant && participant.name; } /** * Mute or unmute local audio stream if it exists. * @param {boolean} muted - if audio stream should be muted or unmuted. */ function muteLocalAudio(muted) { APP.store.dispatch(setAudioMuted(muted)); } /** * Mute or unmute local video stream if it exists. * @param {boolean} muted if video stream should be muted or unmuted. * */ function muteLocalVideo(muted) { APP.store.dispatch(setVideoMuted(muted)); } /** * A queue for the async replaceLocalTrack action so that multiple audio * replacements cannot happen simultaneously. This solves the issue where * replaceLocalTrack is called multiple times with an oldTrack of null, causing * multiple local tracks of the same type to be used. * * @private * @type {Object} */ const _replaceLocalAudioTrackQueue = createTaskQueue(); /** * A task queue for replacement local video tracks. This separate queue exists * so video replacement is not blocked by audio replacement tasks in the queue * {@link _replaceLocalAudioTrackQueue}. * * @private * @type {Object} */ const _replaceLocalVideoTrackQueue = createTaskQueue(); /** * */ class ConferenceConnector { /** * */ constructor(resolve, reject) { this._resolve = resolve; this._reject = reject; this.reconnectTimeout = null; room.on(JitsiConferenceEvents.CONFERENCE_JOINED, this._handleConferenceJoined.bind(this)); room.on(JitsiConferenceEvents.CONFERENCE_FAILED, this._onConferenceFailed.bind(this)); } /** * */ _handleConferenceFailed(err) { this._unsubscribe(); this._reject(err); } /** * */ _onConferenceFailed(err, ...params) { APP.store.dispatch(conferenceFailed(room, err, ...params)); logger.error('CONFERENCE FAILED:', err, ...params); switch (err) { case JitsiConferenceErrors.NOT_ALLOWED_ERROR: { // let's show some auth not allowed page APP.store.dispatch(redirectToStaticPage('static/authError.html')); break; } // not enough rights to create conference case JitsiConferenceErrors.AUTHENTICATION_REQUIRED: { const replaceParticipant = getReplaceParticipant(APP.store.getState()); // Schedule reconnect to check if someone else created the room. this.reconnectTimeout = setTimeout(() => { APP.store.dispatch(conferenceWillJoin(room)); room.join(null, replaceParticipant); }, 5000); const { password } = APP.store.getState()['features/base/conference']; AuthHandler.requireAuth(room, password); break; } case JitsiConferenceErrors.RESERVATION_ERROR: { const [ code, msg ] = params; APP.UI.notifyReservationError(code, msg); break; } case JitsiConferenceErrors.GRACEFUL_SHUTDOWN: APP.UI.notifyGracefulShutdown(); break; // FIXME FOCUS_DISCONNECTED is a confusing event name. // What really happens there is that the library is not ready yet, // because Jicofo is not available, but it is going to give it another // try. case JitsiConferenceErrors.FOCUS_DISCONNECTED: { const [ focus, retrySec ] = params; APP.UI.notifyFocusDisconnected(focus, retrySec); break; } case JitsiConferenceErrors.FOCUS_LEFT: case JitsiConferenceErrors.ICE_FAILED: case JitsiConferenceErrors.VIDEOBRIDGE_NOT_AVAILABLE: case JitsiConferenceErrors.OFFER_ANSWER_FAILED: APP.store.dispatch(conferenceWillLeave(room)); // FIXME the conference should be stopped by the library and not by // the app. Both the errors above are unrecoverable from the library // perspective. room.leave().then(() => connection.disconnect()); break; case JitsiConferenceErrors.CONFERENCE_MAX_USERS: connection.disconnect(); APP.UI.notifyMaxUsersLimitReached(); break; case JitsiConferenceErrors.INCOMPATIBLE_SERVER_VERSIONS: APP.store.dispatch(reloadWithStoredParams()); break; default: this._handleConferenceFailed(err, ...params); } } /** * */ _unsubscribe() { room.off( JitsiConferenceEvents.CONFERENCE_JOINED, this._handleConferenceJoined); room.off( JitsiConferenceEvents.CONFERENCE_FAILED, this._onConferenceFailed); if (this.reconnectTimeout !== null) { clearTimeout(this.reconnectTimeout); } } /** * */ _handleConferenceJoined() { this._unsubscribe(); this._resolve(); } /** * */ connect() { const replaceParticipant = getReplaceParticipant(APP.store.getState()); // the local storage overrides here and in connection.js can be used by jibri room.join(jitsiLocalStorage.getItem('xmpp_conference_password_override'), replaceParticipant); } } /** * Disconnects the connection. * @returns resolved Promise. We need this in order to make the Promise.all * call in hangup() to resolve when all operations are finished. */ function disconnect() { const onDisconnected = () => { APP.API.notifyConferenceLeft(APP.conference.roomName); return Promise.resolve(); }; if (!connection) { return onDisconnected(); } return connection.disconnect().then(onDisconnected, onDisconnected); } /** * Handles CONNECTION_FAILED events from lib-jitsi-meet. * * @param {JitsiConnectionError} error - The reported error. * @returns {void} * @private */ function _connectionFailedHandler(error) { if (isFatalJitsiConnectionError(error)) { APP.connection.removeEventListener( JitsiConnectionEvents.CONNECTION_FAILED, _connectionFailedHandler); if (room) { APP.store.dispatch(conferenceWillLeave(room)); room.leave(); } } } export default { /** * Flag used to delay modification of the muted status of local media tracks * until those are created (or not, but at that point it's certain that * the tracks won't exist). */ _localTracksInitialized: false, isSharingScreen: false, /** * The local audio track (if any). * FIXME tracks from redux store should be the single source of truth * @type {JitsiLocalTrack|null} */ localAudio: null, /** * The local presenter video track (if any). * @type {JitsiLocalTrack|null} */ localPresenterVideo: null, /** * The local video track (if any). * FIXME tracks from redux store should be the single source of truth, but * more refactoring is required around screen sharing ('localVideo' usages). * @type {JitsiLocalTrack|null} */ localVideo: null, /** * Returns an object containing a promise which resolves with the created tracks & * the errors resulting from that process. * * @returns {Promise, Object} */ createInitialLocalTracks(options = {}) { const errors = {}; // Always get a handle on the audio input device so that we have statistics (such as "No audio input" or // "Are you trying to speak?" ) even if the user joins the conference muted. const initialDevices = config.disableInitialGUM ? [] : [ 'audio' ]; const requestedAudio = !config.disableInitialGUM; let requestedVideo = false; if (!config.disableInitialGUM && !options.startWithVideoMuted && !options.startAudioOnly && !options.startScreenSharing) { initialDevices.push('video'); requestedVideo = true; } if (!config.disableInitialGUM) { JitsiMeetJS.mediaDevices.addEventListener( JitsiMediaDevicesEvents.PERMISSION_PROMPT_IS_SHOWN, browserName => APP.store.dispatch( mediaPermissionPromptVisibilityChanged(true, browserName)) ); } JitsiMeetJS.mediaDevices.addEventListener( JitsiMediaDevicesEvents.SLOW_GET_USER_MEDIA, () => APP.store.dispatch(toggleSlowGUMOverlay(true)) ); let tryCreateLocalTracks; // On Electron there is no permission prompt for granting permissions. That's why we don't need to // spend much time displaying the overlay screen. If GUM is not resolved within 15 seconds it will // probably never resolve. const timeout = browser.isElectron() ? 15000 : 60000; // FIXME is there any simpler way to rewrite this spaghetti below ? if (options.startScreenSharing) { tryCreateLocalTracks = this._createDesktopTrack() .then(([ desktopStream ]) => { if (!requestedAudio) { return [ desktopStream ]; } return createLocalTracksF({ devices: [ 'audio' ], timeout, firePermissionPromptIsShownEvent: true, fireSlowPromiseEvent: true }) .then(([ audioStream ]) => [ desktopStream, audioStream ]) .catch(error => { errors.audioOnlyError = error; return [ desktopStream ]; }); }) .catch(error => { logger.error('Failed to obtain desktop stream', error); errors.screenSharingError = error; return requestedAudio ? createLocalTracksF({ devices: [ 'audio' ], timeout, firePermissionPromptIsShownEvent: true, fireSlowPromiseEvent: true }) : []; }) .catch(error => { errors.audioOnlyError = error; return []; }); } else if (!requestedAudio && !requestedVideo) { // Resolve with no tracks tryCreateLocalTracks = Promise.resolve([]); } else { tryCreateLocalTracks = createLocalTracksF({ devices: initialDevices, timeout, firePermissionPromptIsShownEvent: true, fireSlowPromiseEvent: true }) .catch(err => { if (requestedAudio && requestedVideo) { // Try audio only... errors.audioAndVideoError = err; if (err.name === JitsiTrackErrors.TIMEOUT && !browser.isElectron()) { // In this case we expect that the permission prompt is still visible. There is no point of // executing GUM with different source. Also at the time of writing the following // inconsistency have been noticed in some browsers - if the permissions prompt is visible // and another GUM is executed the prompt does not change its content but if the user // clicks allow the user action isassociated with the latest GUM call. errors.audioOnlyError = err; errors.videoOnlyError = err; return []; } return ( createLocalTracksF({ devices: [ 'audio' ], timeout, firePermissionPromptIsShownEvent: true, fireSlowPromiseEvent: true })); } else if (requestedAudio && !requestedVideo) { errors.audioOnlyError = err; return []; } else if (requestedVideo && !requestedAudio) { errors.videoOnlyError = err; return []; } logger.error('Should never happen'); }) .catch(err => { // Log this just in case... if (!requestedAudio) { logger.error('The impossible just happened', err); } errors.audioOnlyError = err; // Try video only... return requestedVideo ? createLocalTracksF({ devices: [ 'video' ], firePermissionPromptIsShownEvent: true, fireSlowPromiseEvent: true }) : []; }) .catch(err => { // Log this just in case... if (!requestedVideo) { logger.error('The impossible just happened', err); } errors.videoOnlyError = err; return []; }); } // Hide the permissions prompt/overlay as soon as the tracks are // created. Don't wait for the connection to be made, since in some // cases, when auth is required, for instance, that won't happen until // the user inputs their credentials, but the dialog would be // overshadowed by the overlay. tryCreateLocalTracks.then(tracks => { APP.store.dispatch(toggleSlowGUMOverlay(false)); APP.store.dispatch(mediaPermissionPromptVisibilityChanged(false)); return tracks; }); return { tryCreateLocalTracks, errors }; }, /** * Displays error notifications according to the state carried by {@code errors} object returned * by {@link createInitialLocalTracks}. * @param {Object} errors - the errors (if any) returned by {@link createInitialLocalTracks}. * * @returns {void} * @private */ _displayErrorsForCreateInitialLocalTracks(errors) { const { audioAndVideoError, audioOnlyError, screenSharingError, videoOnlyError } = errors; // FIXME If there will be microphone error it will cover any screensharing dialog, but it's still better than in // the reverse order where the screensharing dialog will sometimes be closing the microphone alert // ($.prompt.close(); is called). Need to figure out dialogs chaining to fix that. if (screenSharingError) { this._handleScreenSharingError(screenSharingError); } if (audioAndVideoError || audioOnlyError) { if (audioOnlyError || videoOnlyError) { // If both requests for 'audio' + 'video' and 'audio' only failed, we assume that there are some // problems with user's microphone and show corresponding dialog. APP.store.dispatch(notifyMicError(audioOnlyError)); APP.store.dispatch(notifyCameraError(videoOnlyError)); } else { // If request for 'audio' + 'video' failed, but request for 'audio' only was OK, we assume that we had // problems with camera and show corresponding dialog. APP.store.dispatch(notifyCameraError(audioAndVideoError)); } } }, /** * Creates local media tracks and connects to a room. Will show error * dialogs in case accessing the local microphone and/or camera failed. Will * show guidance overlay for users on how to give access to camera and/or * microphone. * @param {string} roomName * @param {object} options * @param {boolean} options.startAudioOnly=false - if true then * only audio track will be created and the audio only mode will be turned * on. * @param {boolean} options.startScreenSharing=false - if true * should start with screensharing instead of camera video. * @param {boolean} options.startWithAudioMuted - will start the conference * without any audio tracks. * @param {boolean} options.startWithVideoMuted - will start the conference * without any video tracks. * @returns {Promise.} */ createInitialLocalTracksAndConnect(roomName, options = {}) { const { tryCreateLocalTracks, errors } = this.createInitialLocalTracks(options); return Promise.all([ tryCreateLocalTracks, connect(roomName) ]) .then(([ tracks, con ]) => { this._displayErrorsForCreateInitialLocalTracks(errors); return [ tracks, con ]; }); }, startConference(con, tracks) { tracks.forEach(track => { if ((track.isAudioTrack() && this.isLocalAudioMuted()) || (track.isVideoTrack() && this.isLocalVideoMuted())) { const mediaType = track.getType(); sendAnalytics( createTrackMutedEvent(mediaType, 'initial mute')); logger.log(`${mediaType} mute: initially muted.`); track.mute(); } }); logger.log(`Initialized with ${tracks.length} local tracks`); this._localTracksInitialized = true; con.addEventListener(JitsiConnectionEvents.CONNECTION_FAILED, _connectionFailedHandler); APP.connection = connection = con; this._createRoom(tracks); // if user didn't give access to mic or camera or doesn't have // them at all, we mark corresponding toolbar buttons as muted, // so that the user can try unmute later on and add audio/video // to the conference if (!tracks.find(t => t.isAudioTrack())) { this.setAudioMuteStatus(true); } if (!tracks.find(t => t.isVideoTrack())) { this.setVideoMuteStatus(); } if (config.iAmRecorder) { this.recorder = new Recorder(); } if (config.startSilent) { sendAnalytics(createStartSilentEvent()); APP.store.dispatch(showNotification({ descriptionKey: 'notify.startSilentDescription', titleKey: 'notify.startSilentTitle' })); } // XXX The API will take care of disconnecting from the XMPP // server (and, thus, leaving the room) on unload. return new Promise((resolve, reject) => { (new ConferenceConnector(resolve, reject)).connect(); }); }, /** * Open new connection and join the conference when prejoin page is not enabled. * If prejoin page is enabled open an new connection in the background * and create local tracks. * * @param {{ roomName: string }} options * @returns {Promise} */ async init({ roomName }) { const initialOptions = { startAudioOnly: config.startAudioOnly, startScreenSharing: config.startScreenSharing, startWithAudioMuted: getStartWithAudioMuted(APP.store.getState()) || config.startSilent || isUserInteractionRequiredForUnmute(APP.store.getState()), startWithVideoMuted: getStartWithVideoMuted(APP.store.getState()) || isUserInteractionRequiredForUnmute(APP.store.getState()) }; this.roomName = roomName; try { // Initialize the device list first. This way, when creating tracks // based on preferred devices, loose label matching can be done in // cases where the exact ID match is no longer available, such as // when the camera device has switched USB ports. // when in startSilent mode we want to start with audio muted await this._initDeviceList(); } catch (error) { logger.warn('initial device list initialization failed', error); } if (isPrejoinPageEnabled(APP.store.getState())) { _connectionPromise = connect(roomName).then(c => { // we want to initialize it early, in case of errors to be able // to gather logs APP.connection = c; return c; }); APP.store.dispatch(makePrecallTest(this._getConferenceOptions())); const { tryCreateLocalTracks, errors } = this.createInitialLocalTracks(initialOptions); const tracks = await tryCreateLocalTracks; // Initialize device list a second time to ensure device labels // get populated in case of an initial gUM acceptance; otherwise // they may remain as empty strings. this._initDeviceList(true); if (isPrejoinPageVisible(APP.store.getState())) { return APP.store.dispatch(initPrejoin(tracks, errors)); } logger.debug('Prejoin screen no longer displayed at the time when tracks were created'); this._displayErrorsForCreateInitialLocalTracks(errors); return this._setLocalAudioVideoStreams(tracks); } const [ tracks, con ] = await this.createInitialLocalTracksAndConnect(roomName, initialOptions); let localTracks = tracks; this._initDeviceList(true); if (initialOptions.startWithAudioMuted) { // Always add the audio track to the peer connection and then mute the track on mobile Safari // because of a known issue where audio playout doesn't happen if the user joins audio and video muted. if (isIosMobileBrowser()) { this.muteAudio(true, true); } else { localTracks = localTracks.filter(track => track.getType() !== MEDIA_TYPE.AUDIO); } } return this.startConference(con, localTracks); }, /** * Joins conference after the tracks have been configured in the prejoin screen. * * @param {Object[]} tracks - An array with the configured tracks * @returns {Promise} */ async prejoinStart(tracks) { const con = await _connectionPromise; return this.startConference(con, tracks); }, /** * Check if id is id of the local user. * @param {string} id id to check * @returns {boolean} */ isLocalId(id) { return this.getMyUserId() === id; }, /** * Tells whether the local video is muted or not. * @return {boolean} */ isLocalVideoMuted() { // If the tracks are not ready, read from base/media state return this._localTracksInitialized ? isLocalCameraTrackMuted( APP.store.getState()['features/base/tracks']) : isVideoMutedByUser(APP.store); }, /** * Simulates toolbar button click for audio mute. Used by shortcuts and API. * @param {boolean} mute true for mute and false for unmute. * @param {boolean} [showUI] when set to false will not display any error * dialogs in case of media permissions error. */ muteAudio(mute, showUI = true) { if (!mute && isUserInteractionRequiredForUnmute(APP.store.getState())) { logger.error('Unmuting audio requires user interaction'); return; } // Not ready to modify track's state yet if (!this._localTracksInitialized) { // This will only modify base/media.audio.muted which is then synced // up with the track at the end of local tracks initialization. muteLocalAudio(mute); this.setAudioMuteStatus(mute); return; } else if (this.isLocalAudioMuted() === mute) { // NO-OP return; } if (!this.localAudio && !mute) { const maybeShowErrorDialog = error => { showUI && APP.store.dispatch(notifyMicError(error)); }; createLocalTracksF({ devices: [ 'audio' ] }) .then(([ audioTrack ]) => audioTrack) .catch(error => { maybeShowErrorDialog(error); // Rollback the audio muted status by using null track return null; }) .then(audioTrack => this.useAudioStream(audioTrack)); } else { muteLocalAudio(mute); } }, /** * Returns whether local audio is muted or not. * @returns {boolean} */ isLocalAudioMuted() { // If the tracks are not ready, read from base/media state return this._localTracksInitialized ? isLocalTrackMuted( APP.store.getState()['features/base/tracks'], MEDIA_TYPE.AUDIO) : Boolean( APP.store.getState()['features/base/media'].audio.muted); }, /** * Simulates toolbar button click for audio mute. Used by shortcuts * and API. * @param {boolean} [showUI] when set to false will not display any error * dialogs in case of media permissions error. */ toggleAudioMuted(showUI = true) { this.muteAudio(!this.isLocalAudioMuted(), showUI); }, /** * Simulates toolbar button click for presenter video mute. Used by * shortcuts and API. * @param mute true for mute and false for unmute. * @param {boolean} [showUI] when set to false will not display any error * dialogs in case of media permissions error. */ async mutePresenter(mute, showUI = true) { const maybeShowErrorDialog = error => { showUI && APP.store.dispatch(notifyCameraError(error)); }; if (mute) { try { await this.localVideo.setEffect(undefined); } catch (err) { logger.error('Failed to remove the presenter effect', err); maybeShowErrorDialog(err); } } else { try { await this.localVideo.setEffect(await this._createPresenterStreamEffect()); } catch (err) { logger.error('Failed to apply the presenter effect', err); maybeShowErrorDialog(err); } } }, /** * Simulates toolbar button click for video mute. Used by shortcuts and API. * @param mute true for mute and false for unmute. * @param {boolean} [showUI] when set to false will not display any error * dialogs in case of media permissions error. */ muteVideo(mute, showUI = true) { if (!mute && isUserInteractionRequiredForUnmute(APP.store.getState())) { logger.error('Unmuting video requires user interaction'); return; } if (this.isSharingScreen) { // Chain _mutePresenterVideo calls _prevMutePresenterVideo = _prevMutePresenterVideo.then(() => this._mutePresenterVideo(mute)); return; } // If not ready to modify track's state yet adjust the base/media if (!this._localTracksInitialized) { // This will only modify base/media.video.muted which is then synced // up with the track at the end of local tracks initialization. muteLocalVideo(mute); this.setVideoMuteStatus(); return; } else if (this.isLocalVideoMuted() === mute) { // NO-OP return; } if (!this.localVideo && !mute) { const maybeShowErrorDialog = error => { showUI && APP.store.dispatch(notifyCameraError(error)); }; // Try to create local video if there wasn't any. // This handles the case when user joined with no video // (dismissed screen sharing screen or in audio only mode), but // decided to add it later on by clicking on muted video icon or // turning off the audio only mode. // // FIXME when local track creation is moved to react/redux // it should take care of the use case described above createLocalTracksF({ devices: [ 'video' ] }) .then(([ videoTrack ]) => videoTrack) .catch(error => { // FIXME should send some feedback to the API on error ? maybeShowErrorDialog(error); // Rollback the video muted status by using null track return null; }) .then(videoTrack => { logger.debug(`muteVideo: calling useVideoStream for track: ${videoTrack}`); return this.useVideoStream(videoTrack); }); } else { // FIXME show error dialog if it fails (should be handled by react) muteLocalVideo(mute); } }, /** * Simulates toolbar button click for video mute. Used by shortcuts and API. * @param {boolean} [showUI] when set to false will not display any error * dialogs in case of media permissions error. */ toggleVideoMuted(showUI = true) { this.muteVideo(!this.isLocalVideoMuted(), showUI); }, /** * Retrieve list of ids of conference participants (without local user). * @returns {string[]} */ listMembersIds() { return room.getParticipants().map(p => p.getId()); }, /** * Checks whether the participant identified by id is a moderator. * @id id to search for participant * @return {boolean} whether the participant is moderator */ isParticipantModerator(id) { const user = room.getParticipantById(id); return user && user.isModerator(); }, /** * Retrieve list of conference participants (without local user). * @returns {JitsiParticipant[]} * * NOTE: Used by jitsi-meet-torture! */ listMembers() { return room.getParticipants(); }, get membersCount() { return room.getParticipants().length + 1; }, /** * Returns true if the callstats integration is enabled, otherwise returns * false. * * @returns true if the callstats integration is enabled, otherwise returns * false. */ isCallstatsEnabled() { return room && room.isCallstatsEnabled(); }, /** * Get speaker stats that track total dominant speaker time. * * @returns {object} A hash with keys being user ids and values being the * library's SpeakerStats model used for calculating time as dominant * speaker. */ getSpeakerStats() { return room.getSpeakerStats(); }, /** * Returns the connection times stored in the library. */ getConnectionTimes() { return room.getConnectionTimes(); }, // used by torture currently isJoined() { return room && room.isJoined(); }, getConnectionState() { return room && room.getConnectionState(); }, /** * Obtains current P2P ICE connection state. * @return {string|null} ICE connection state or null if there's no * P2P connection */ getP2PConnectionState() { return room && room.getP2PConnectionState(); }, /** * Starts P2P (for tests only) * @private */ _startP2P() { try { room && room.startP2PSession(); } catch (error) { logger.error('Start P2P failed', error); throw error; } }, /** * Stops P2P (for tests only) * @private */ _stopP2P() { try { room && room.stopP2PSession(); } catch (error) { logger.error('Stop P2P failed', error); throw error; } }, /** * Checks whether or not our connection is currently in interrupted and * reconnect attempts are in progress. * * @returns {boolean} true if the connection is in interrupted state or * false otherwise. */ isConnectionInterrupted() { return room.isConnectionInterrupted(); }, /** * Obtains the local display name. * @returns {string|undefined} */ getLocalDisplayName() { return getDisplayName(this.getMyUserId()); }, /** * Finds JitsiParticipant for given id. * * @param {string} id participant's identifier(MUC nickname). * * @returns {JitsiParticipant|null} participant instance for given id or * null if not found. */ getParticipantById(id) { return room ? room.getParticipantById(id) : null; }, /** * Gets the display name foe the JitsiParticipant identified by * the given id. * * @param id {string} the participant's id(MUC nickname/JVB endpoint id) * * @return {string} the participant's display name or the default string if * absent. */ getParticipantDisplayName(id) { const displayName = getDisplayName(id); if (displayName) { return displayName; } if (APP.conference.isLocalId(id)) { return APP.translation.generateTranslationHTML( interfaceConfig.DEFAULT_LOCAL_DISPLAY_NAME); } return interfaceConfig.DEFAULT_REMOTE_DISPLAY_NAME; }, getMyUserId() { return room && room.myUserId(); }, /** * Will be filled with values only when config.debug is enabled. * Its used by torture to check audio levels. */ audioLevelsMap: {}, /** * Returns the stored audio level (stored only if config.debug is enabled) * @param id the id for the user audio level to return (the id value is * returned for the participant using getMyUserId() method) */ getPeerSSRCAudioLevel(id) { return this.audioLevelsMap[id]; }, /** * @return {number} the number of participants in the conference with at * least one track. */ getNumberOfParticipantsWithTracks() { return room.getParticipants() .filter(p => p.getTracks().length > 0) .length; }, /** * Returns the stats. */ getStats() { return room.connectionQuality.getStats(); }, // end used by torture /** * Download logs, a function that can be called from console while * debugging. * @param filename (optional) specify target filename */ saveLogs(filename = 'meetlog.json') { // this can be called from console and will not have reference to this // that's why we reference the global var const logs = APP.connection.getLogs(); downloadJSON(logs, filename); }, /** * Exposes a Command(s) API on this instance. It is necessitated by (1) the * desire to keep room private to this instance and (2) the need of other * modules to send and receive commands to and from participants. * Eventually, this instance remains in control with respect to the * decision whether the Command(s) API of room (i.e. lib-jitsi-meet's * JitsiConference) is to be used in the implementation of the Command(s) * API of this instance. */ commands: { /** * Known custom conference commands. */ defaults: commands, /** * Receives notifications from other participants about commands aka * custom events (sent by sendCommand or sendCommandOnce methods). * @param command {String} the name of the command * @param handler {Function} handler for the command */ addCommandListener() { // eslint-disable-next-line prefer-rest-params room.addCommandListener(...arguments); }, /** * Removes command. * @param name {String} the name of the command. */ removeCommand() { // eslint-disable-next-line prefer-rest-params room.removeCommand(...arguments); }, /** * Sends command. * @param name {String} the name of the command. * @param values {Object} with keys and values that will be sent. */ sendCommand() { // eslint-disable-next-line prefer-rest-params room.sendCommand(...arguments); }, /** * Sends command one time. * @param name {String} the name of the command. * @param values {Object} with keys and values that will be sent. */ sendCommandOnce() { // eslint-disable-next-line prefer-rest-params room.sendCommandOnce(...arguments); } }, _createRoom(localTracks) { room = connection.initJitsiConference( APP.conference.roomName, this._getConferenceOptions()); APP.store.dispatch(conferenceWillJoin(room)); // Filter out the tracks that are muted (except on mobile Safari). const tracks = isIosMobileBrowser() ? localTracks : localTracks.filter(track => !track.isMuted()); this._setLocalAudioVideoStreams(tracks); this._room = room; // FIXME do not use this sendLocalParticipant(APP.store, room); this._setupListeners(); }, /** * Sets local video and audio streams. * @param {JitsiLocalTrack[]} tracks=[] * @returns {Promise[]} * @private */ _setLocalAudioVideoStreams(tracks = []) { return tracks.map(track => { if (track.isAudioTrack()) { return this.useAudioStream(track); } else if (track.isVideoTrack()) { logger.debug(`_setLocalAudioVideoStreams is calling useVideoStream with track: ${track}`); return this.useVideoStream(track); } logger.error( 'Ignored not an audio nor a video track: ', track); return Promise.resolve(); }); }, _getConferenceOptions() { const options = getConferenceOptions(APP.store.getState()); options.createVADProcessor = createRnnoiseProcessor; return options; }, /** * Start using provided video stream. * Stops previous video stream. * @param {JitsiLocalTrack} newTrack - new track to use or null * @returns {Promise} */ useVideoStream(newTrack) { logger.debug(`useVideoStream: ${newTrack}`); return new Promise((resolve, reject) => { _replaceLocalVideoTrackQueue.enqueue(onFinish => { const state = APP.store.getState(); // When the prejoin page is displayed localVideo is not set // so just replace the video track from the store with the new one. if (isPrejoinPageVisible(state)) { const oldTrack = getLocalJitsiVideoTrack(state); logger.debug(`useVideoStream on the prejoin screen: Replacing ${oldTrack} with ${newTrack}`); return APP.store.dispatch(replaceLocalTrack(oldTrack, newTrack)) .then(resolve) .catch(error => { logger.error(`useVideoStream failed on the prejoin screen: ${error}`); reject(error); }) .then(onFinish); } logger.debug(`useVideoStream: Replacing ${this.localVideo} with ${newTrack}`); APP.store.dispatch( replaceLocalTrack(this.localVideo, newTrack, room)) .then(() => { this.localVideo = newTrack; this._setSharingScreen(newTrack); this.setVideoMuteStatus(); }) .then(resolve) .catch(error => { logger.error(`useVideoStream failed: ${error}`); reject(error); }) .then(onFinish); }); }); }, /** * Sets `this.isSharingScreen` depending on provided video stream. * In case new screen sharing status is not equal previous one * it updates desktop sharing buttons in UI * and notifies external application. * * @param {JitsiLocalTrack} [newStream] new stream to use or null * @private * @returns {void} */ _setSharingScreen(newStream) { const wasSharingScreen = this.isSharingScreen; this.isSharingScreen = newStream && newStream.videoType === 'desktop'; if (wasSharingScreen !== this.isSharingScreen) { const details = {}; if (this.isSharingScreen) { details.sourceType = newStream.sourceType; } APP.API.notifyScreenSharingStatusChanged( this.isSharingScreen, details); } }, /** * Start using provided audio stream. * Stops previous audio stream. * @param {JitsiLocalTrack} newTrack - new track to use or null * @returns {Promise} */ useAudioStream(newTrack) { return new Promise((resolve, reject) => { _replaceLocalAudioTrackQueue.enqueue(onFinish => { const state = APP.store.getState(); // When the prejoin page is displayed localAudio is not set // so just replace the audio track from the store with the new one. if (isPrejoinPageVisible(state)) { const oldTrack = getLocalJitsiAudioTrack(state); return APP.store.dispatch(replaceLocalTrack(oldTrack, newTrack)) .then(resolve) .catch(reject) .then(onFinish); } APP.store.dispatch( replaceLocalTrack(this.localAudio, newTrack, room)) .then(() => { this.localAudio = newTrack; this.setAudioMuteStatus(this.isLocalAudioMuted()); }) .then(resolve) .catch(reject) .then(onFinish); }); }); }, /** * Returns whether or not the conference is currently in audio only mode. * * @returns {boolean} */ isAudioOnly() { return Boolean(APP.store.getState()['features/base/audio-only'].enabled); }, videoSwitchInProgress: false, /** * This fields stores a handler which will create a Promise which turns off * the screen sharing and restores the previous video state (was there * any video, before switching to screen sharing ? was it muted ?). * * Once called this fields is cleared to null. * @type {Function|null} */ _untoggleScreenSharing: null, /** * Creates a Promise which turns off the screen sharing and restores * the previous state described by the arguments. * * This method is bound to the appropriate values, after switching to screen * sharing and stored in {@link _untoggleScreenSharing}. * * @param {boolean} didHaveVideo indicates if there was a camera video being * used, before switching to screen sharing. * @param {boolean} wasVideoMuted indicates if the video was muted, before * switching to screen sharing. * @return {Promise} resolved after the screen sharing is turned off, or * rejected with some error (no idea what kind of error, possible GUM error) * in case it fails. * @private */ async _turnScreenSharingOff(didHaveVideo) { this._untoggleScreenSharing = null; this.videoSwitchInProgress = true; APP.store.dispatch(stopReceiver()); this._stopProxyConnection(); if (config.enableScreenshotCapture) { APP.store.dispatch(toggleScreenshotCaptureEffect(false)); } // It can happen that presenter GUM is in progress while screensharing is being turned off. Here it needs to // wait for that GUM to be resolved in order to prevent leaking the presenter track(this.localPresenterVideo // will be null when SS is being turned off, but it will initialize once GUM resolves). let promise = _prevMutePresenterVideo = _prevMutePresenterVideo.then(() => { // mute the presenter track if it exists. if (this.localPresenterVideo) { APP.store.dispatch(setVideoMuted(true, MEDIA_TYPE.PRESENTER)); return this.localPresenterVideo.dispose().then(() => { APP.store.dispatch(trackRemoved(this.localPresenterVideo)); this.localPresenterVideo = null; }); } }); // If system audio was also shared stop the AudioMixerEffect and dispose of the desktop audio track. if (this._mixerEffect) { await this.localAudio.setEffect(undefined); await this._desktopAudioStream.dispose(); this._mixerEffect = undefined; this._desktopAudioStream = undefined; // In case there was no local audio when screen sharing was started the fact that we set the audio stream to // null will take care of the desktop audio stream cleanup. } else if (this._desktopAudioStream) { await this.useAudioStream(null); this._desktopAudioStream = undefined; } APP.store.dispatch(setScreenAudioShareState(false)); if (didHaveVideo) { promise = promise.then(() => createLocalTracksF({ devices: [ 'video' ] })) .then(([ stream ]) => { logger.debug(`_turnScreenSharingOff using ${stream} for useVideoStream`); return this.useVideoStream(stream); }) .catch(error => { logger.error('failed to switch back to local video', error); return this.useVideoStream(null).then(() => // Still fail with the original err Promise.reject(error) ); }); } else { promise = promise.then(() => { logger.debug('_turnScreenSharingOff using null for useVideoStream'); return this.useVideoStream(null); }); } return promise.then( () => { this.videoSwitchInProgress = false; sendAnalytics(createScreenSharingEvent('stopped')); logger.info('Screen sharing stopped.'); }, error => { this.videoSwitchInProgress = false; logger.error(`_turnScreenSharingOff failed: ${error}`); throw error; }); }, /** * Toggles between screen sharing and camera video if the toggle parameter * is not specified and starts the procedure for obtaining new screen * sharing/video track otherwise. * * @param {boolean} [toggle] - If true - new screen sharing track will be * obtained. If false - new video track will be obtain. If not specified - * toggles between screen sharing and camera video. * @param {Object} [options] - Screen sharing options that will be passed to * createLocalTracks. * @param {Array} [options.desktopSharingSources] - Array with the * sources that have to be displayed in the desktop picker window ('screen', * 'window', etc.). * @return {Promise.} */ async toggleScreenSharing(toggle = !this._untoggleScreenSharing, options = {}) { logger.debug(`toggleScreenSharing: ${toggle}`); if (this.videoSwitchInProgress) { return Promise.reject('Switch in progress.'); } if (!JitsiMeetJS.isDesktopSharingEnabled()) { return Promise.reject('Cannot toggle screen sharing: not supported.'); } if (this.isAudioOnly()) { return Promise.reject('No screensharing in audio only mode'); } if (toggle) { try { await this._switchToScreenSharing(options); return; } catch (err) { logger.error('Failed to switch to screensharing', err); return; } } return this._untoggleScreenSharing ? this._untoggleScreenSharing() : Promise.resolve(); }, /** * Creates desktop (screensharing) {@link JitsiLocalTrack} * * @param {Object} [options] - Screen sharing options that will be passed to * createLocalTracks. * @param {Object} [options.desktopSharing] * @param {Object} [options.desktopStream] - An existing desktop stream to * use instead of creating a new desktop stream. * @return {Promise.} - A Promise resolved with * {@link JitsiLocalTrack} for the screensharing or rejected with * {@link JitsiTrackError}. * * @private */ _createDesktopTrack(options = {}) { const didHaveVideo = !this.isLocalVideoMuted(); const getDesktopStreamPromise = options.desktopStream ? Promise.resolve([ options.desktopStream ]) : createLocalTracksF({ desktopSharingSourceDevice: options.desktopSharingSources ? null : config._desktopSharingSourceDevice, desktopSharingSources: options.desktopSharingSources, devices: [ 'desktop' ] }); return getDesktopStreamPromise.then(desktopStreams => { // Stores the "untoggle" handler which remembers whether was // there any video before and whether was it muted. this._untoggleScreenSharing = this._turnScreenSharingOff.bind(this, didHaveVideo); const desktopVideoStream = desktopStreams.find(stream => stream.getType() === MEDIA_TYPE.VIDEO); const dekstopAudioStream = desktopStreams.find(stream => stream.getType() === MEDIA_TYPE.AUDIO); if (dekstopAudioStream) { dekstopAudioStream.on( JitsiTrackEvents.LOCAL_TRACK_STOPPED, () => { logger.debug(`Local screensharing audio track stopped. ${this.isSharingScreen}`); // Handle case where screen share was stopped from the browsers 'screen share in progress' // window. If audio screen sharing is stopped via the normal UX flow this point shouldn't // be reached. isScreenAudioShared(APP.store.getState()) && this._untoggleScreenSharing && this._untoggleScreenSharing(); } ); } if (desktopVideoStream) { desktopVideoStream.on( JitsiTrackEvents.LOCAL_TRACK_STOPPED, () => { logger.debug(`Local screensharing track stopped. ${this.isSharingScreen}`); // If the stream was stopped during screen sharing // session then we should switch back to video. this.isSharingScreen && this._untoggleScreenSharing && this._untoggleScreenSharing(); } ); } return desktopStreams; }, error => { throw error; }); }, /** * Creates a new instance of presenter effect. A new video track is created * using the new set of constraints that are calculated based on * the height of the desktop that is being currently shared. * * @param {number} height - The height of the desktop stream that is being * currently shared. * @param {string} cameraDeviceId - The device id of the camera to be used. * @return {Promise} - A promise resolved with * {@link JitsiStreamPresenterEffect} if it succeeds. */ async _createPresenterStreamEffect(height = null, cameraDeviceId = null) { if (!this.localPresenterVideo) { const camera = cameraDeviceId ?? getUserSelectedCameraDeviceId(APP.store.getState()); try { this.localPresenterVideo = await createLocalPresenterTrack({ cameraDeviceId: camera }, height); } catch (err) { logger.error('Failed to create a camera track for presenter', err); return; } APP.store.dispatch(trackAdded(this.localPresenterVideo)); } try { const effect = await createPresenterEffect(this.localPresenterVideo.stream); return effect; } catch (err) { logger.error('Failed to create the presenter effect', err); } }, /** * Tries to turn the presenter video track on or off. If a presenter track * doesn't exist, a new video track is created. * * @param mute - true for mute and false for unmute. * * @private */ async _mutePresenterVideo(mute) { const maybeShowErrorDialog = error => { APP.store.dispatch(notifyCameraError(error)); }; // Check for NO-OP if (mute && (!this.localPresenterVideo || this.localPresenterVideo.isMuted())) { return; } else if (!mute && this.localPresenterVideo && !this.localPresenterVideo.isMuted()) { return; } // Create a new presenter track and apply the presenter effect. if (!this.localPresenterVideo && !mute) { const { height, width } = this.localVideo.track.getSettings() ?? this.localVideo.track.getConstraints(); const isPortrait = height >= width; const DESKTOP_STREAM_CAP = 720; const highResolutionTrack = (isPortrait && width > DESKTOP_STREAM_CAP) || (!isPortrait && height > DESKTOP_STREAM_CAP); // Resizing the desktop track for presenter is causing blurriness of the desktop share on chrome. // Disable resizing by default, enable it only when config.js setting is enabled. const resizeDesktopStream = highResolutionTrack && config.videoQuality?.resizeDesktopForPresenter; if (resizeDesktopStream) { let desktopResizeConstraints = {}; if (height && width) { const advancedConstraints = [ { aspectRatio: (width / height).toPrecision(4) } ]; const constraint = isPortrait ? { width: DESKTOP_STREAM_CAP } : { height: DESKTOP_STREAM_CAP }; advancedConstraints.push(constraint); desktopResizeConstraints.advanced = advancedConstraints; } else { desktopResizeConstraints = { width: 1280, height: 720 }; } // Apply the constraints on the desktop track. try { await this.localVideo.track.applyConstraints(desktopResizeConstraints); } catch (err) { logger.error('Failed to apply constraints on the desktop stream for presenter mode', err); return; } } const trackHeight = resizeDesktopStream ? this.localVideo.track.getSettings().height ?? DESKTOP_STREAM_CAP : height; let effect; try { effect = await this._createPresenterStreamEffect(trackHeight); } catch (err) { logger.error('Failed to unmute Presenter Video', err); maybeShowErrorDialog(err); return; } // Replace the desktop track on the peerconnection. try { await this.localVideo.setEffect(effect); APP.store.dispatch(setVideoMuted(mute, MEDIA_TYPE.PRESENTER)); this.setVideoMuteStatus(); } catch (err) { logger.error('Failed to apply the Presenter effect', err); } } else { APP.store.dispatch(setVideoMuted(mute, MEDIA_TYPE.PRESENTER)); } }, /** * Tries to switch to the screensharing mode by disposing camera stream and * replacing it with a desktop one. * * @param {Object} [options] - Screen sharing options that will be passed to * createLocalTracks. * * @return {Promise} - A Promise resolved if the operation succeeds or * rejected with some unknown type of error in case it fails. Promise will * be rejected immediately if {@link videoSwitchInProgress} is true. * * @private */ _switchToScreenSharing(options = {}) { if (this.videoSwitchInProgress) { return Promise.reject('Switch in progress.'); } this.videoSwitchInProgress = true; return this._createDesktopTrack(options) .then(async streams => { let desktopVideoStream = streams.find(stream => stream.getType() === MEDIA_TYPE.VIDEO); this._desktopAudioStream = streams.find(stream => stream.getType() === MEDIA_TYPE.AUDIO); const { audioOnly = false } = options; // If we're in audio only mode dispose of the video track otherwise the screensharing state will be // inconsistent. if (audioOnly) { desktopVideoStream.dispose(); desktopVideoStream = undefined; if (!this._desktopAudioStream) { return Promise.reject(AUDIO_ONLY_SCREEN_SHARE_NO_TRACK); } } if (desktopVideoStream) { logger.debug(`_switchToScreenSharing is using ${desktopVideoStream} for useVideoStream`); await this.useVideoStream(desktopVideoStream); } if (this._desktopAudioStream) { // If there is a localAudio stream, mix in the desktop audio stream captured by the screen sharing // api. if (this.localAudio) { this._mixerEffect = new AudioMixerEffect(this._desktopAudioStream); await this.localAudio.setEffect(this._mixerEffect); } else { // If no local stream is present ( i.e. no input audio devices) we use the screen share audio // stream as we would use a regular stream. await this.useAudioStream(this._desktopAudioStream); } APP.store.dispatch(setScreenAudioShareState(true)); } }) .then(() => { this.videoSwitchInProgress = false; if (config.enableScreenshotCapture) { APP.store.dispatch(toggleScreenshotCaptureEffect(true)); } sendAnalytics(createScreenSharingEvent('started')); logger.log('Screen sharing started'); }) .catch(error => { this.videoSwitchInProgress = false; // Pawel: With this call I'm trying to preserve the original // behaviour although it is not clear why would we "untoggle" // on failure. I suppose it was to restore video in case there // was some problem during "this.useVideoStream(desktopStream)". // It's important to note that the handler will not be available // if we fail early on trying to get desktop media (which makes // sense, because the camera video is still being used, so // nothing to "untoggle"). if (this._untoggleScreenSharing) { this._untoggleScreenSharing(); } // FIXME the code inside of _handleScreenSharingError is // asynchronous, but does not return a Promise and is not part // of the current Promise chain. this._handleScreenSharingError(error); return Promise.reject(error); }); }, /** * Handles {@link JitsiTrackError} returned by the lib-jitsi-meet when * trying to create screensharing track. It will either do nothing if * the dialog was canceled on user's request or display an error if * screensharing couldn't be started. * @param {JitsiTrackError} error - The error returned by * {@link _createDesktopTrack} Promise. * @private */ _handleScreenSharingError(error) { if (error.name === JitsiTrackErrors.SCREENSHARING_USER_CANCELED) { return; } logger.error('failed to share local desktop', error); // Handling: // JitsiTrackErrors.CONSTRAINT_FAILED // JitsiTrackErrors.PERMISSION_DENIED // JitsiTrackErrors.SCREENSHARING_GENERIC_ERROR // and any other let descriptionKey; let titleKey; if (error.name === JitsiTrackErrors.PERMISSION_DENIED) { descriptionKey = 'dialog.screenSharingPermissionDeniedError'; titleKey = 'dialog.screenSharingFailedTitle'; } else if (error.name === JitsiTrackErrors.CONSTRAINT_FAILED) { descriptionKey = 'dialog.cameraConstraintFailedError'; titleKey = 'deviceError.cameraError'; } else if (error.name === JitsiTrackErrors.SCREENSHARING_GENERIC_ERROR) { descriptionKey = 'dialog.screenSharingFailed'; titleKey = 'dialog.screenSharingFailedTitle'; } else if (error === AUDIO_ONLY_SCREEN_SHARE_NO_TRACK) { descriptionKey = 'notify.screenShareNoAudio'; titleKey = 'notify.screenShareNoAudioTitle'; } APP.UI.messageHandler.showError({ descriptionKey, titleKey }); }, /** * Setup interaction between conference and UI. */ _setupListeners() { // add local streams when joined to the conference room.on(JitsiConferenceEvents.CONFERENCE_JOINED, () => { this._onConferenceJoined(); }); room.on( JitsiConferenceEvents.CONFERENCE_LEFT, (...args) => { APP.store.dispatch(conferenceTimestampChanged(0)); APP.store.dispatch(conferenceLeft(room, ...args)); }); room.on( JitsiConferenceEvents.CONFERENCE_UNIQUE_ID_SET, (...args) => { // Preserve the sessionId so that the value is accessible even after room // is disconnected. room.sessionId = room.getMeetingUniqueId(); APP.store.dispatch(conferenceUniqueIdSet(room, ...args)); }); room.on( JitsiConferenceEvents.AUTH_STATUS_CHANGED, (authEnabled, authLogin) => APP.store.dispatch(authStatusChanged(authEnabled, authLogin))); room.on(JitsiConferenceEvents.PARTCIPANT_FEATURES_CHANGED, user => { APP.store.dispatch(updateRemoteParticipantFeatures(user)); }); room.on(JitsiConferenceEvents.USER_JOINED, (id, user) => { // The logic shared between RN and web. commonUserJoinedHandling(APP.store, room, user); if (user.isHidden()) { return; } APP.store.dispatch(updateRemoteParticipantFeatures(user)); logger.log(`USER ${id} connected:`, user); APP.UI.addUser(user); }); room.on(JitsiConferenceEvents.USER_LEFT, (id, user) => { // The logic shared between RN and web. commonUserLeftHandling(APP.store, room, user); if (user.isHidden()) { return; } logger.log(`USER ${id} LEFT:`, user); }); room.on(JitsiConferenceEvents.USER_STATUS_CHANGED, (id, status) => { APP.store.dispatch(participantPresenceChanged(id, status)); const user = room.getParticipantById(id); if (user) { APP.UI.updateUserStatus(user, status); } }); room.on(JitsiConferenceEvents.USER_ROLE_CHANGED, (id, role) => { if (this.isLocalId(id)) { logger.info(`My role changed, new role: ${role}`); APP.store.dispatch(localParticipantRoleChanged(role)); APP.API.notifyUserRoleChanged(id, role); } else { APP.store.dispatch(participantRoleChanged(id, role)); } }); room.on(JitsiConferenceEvents.TRACK_ADDED, track => { if (!track || track.isLocal()) { return; } APP.store.dispatch(trackAdded(track)); }); room.on(JitsiConferenceEvents.TRACK_REMOVED, track => { if (!track || track.isLocal()) { return; } APP.store.dispatch(trackRemoved(track)); }); room.on(JitsiConferenceEvents.TRACK_AUDIO_LEVEL_CHANGED, (id, lvl) => { let newLvl = lvl; if (this.isLocalId(id) && this.localAudio && this.localAudio.isMuted()) { newLvl = 0; } if (config.debug) { this.audioLevelsMap[id] = newLvl; if (config.debugAudioLevels) { logger.log(`AudioLevel:${id}/${newLvl}`); } } APP.UI.setAudioLevel(id, newLvl); }); room.on(JitsiConferenceEvents.TRACK_MUTE_CHANGED, (track, participantThatMutedUs) => { if (participantThatMutedUs) { APP.store.dispatch(participantMutedUs(participantThatMutedUs, track)); if (this.isSharingScreen && track.isVideoTrack()) { logger.debug('TRACK_MUTE_CHANGED while screen sharing'); this._turnScreenSharingOff(false); } } }); room.on(JitsiConferenceEvents.SUBJECT_CHANGED, subject => APP.store.dispatch(conferenceSubjectChanged(subject))); room.on( JitsiConferenceEvents.LAST_N_ENDPOINTS_CHANGED, (leavingIds, enteringIds) => APP.UI.handleLastNEndpoints(leavingIds, enteringIds)); room.on( JitsiConferenceEvents.P2P_STATUS, (jitsiConference, p2p) => APP.store.dispatch(p2pStatusChanged(p2p))); room.on( JitsiConferenceEvents.PARTICIPANT_CONN_STATUS_CHANGED, (id, connectionStatus) => APP.store.dispatch( participantConnectionStatusChanged(id, connectionStatus))); room.on( JitsiConferenceEvents.DOMINANT_SPEAKER_CHANGED, (dominant, previous) => APP.store.dispatch(dominantSpeakerChanged(dominant, previous, room))); room.on( JitsiConferenceEvents.CONFERENCE_CREATED_TIMESTAMP, conferenceTimestamp => APP.store.dispatch(conferenceTimestampChanged(conferenceTimestamp))); room.on(JitsiConferenceEvents.CONNECTION_INTERRUPTED, () => { APP.store.dispatch(localParticipantConnectionStatusChanged( JitsiParticipantConnectionStatus.INTERRUPTED)); }); room.on(JitsiConferenceEvents.CONNECTION_RESTORED, () => { APP.store.dispatch(localParticipantConnectionStatusChanged( JitsiParticipantConnectionStatus.ACTIVE)); }); room.on( JitsiConferenceEvents.DISPLAY_NAME_CHANGED, (id, displayName) => { const formattedDisplayName = getNormalizedDisplayName(displayName); APP.store.dispatch(participantUpdated({ conference: room, id, name: formattedDisplayName })); APP.API.notifyDisplayNameChanged(id, { displayName: formattedDisplayName, formattedDisplayName: appendSuffix( formattedDisplayName || interfaceConfig.DEFAULT_REMOTE_DISPLAY_NAME) }); } ); room.on( JitsiConferenceEvents.BOT_TYPE_CHANGED, (id, botType) => { APP.store.dispatch(participantUpdated({ conference: room, id, botType })); } ); room.on( JitsiConferenceEvents.ENDPOINT_MESSAGE_RECEIVED, (...args) => { APP.store.dispatch(endpointMessageReceived(...args)); if (args && args.length >= 2) { const [ sender, eventData ] = args; if (eventData.name === ENDPOINT_TEXT_MESSAGE_NAME) { APP.API.notifyEndpointTextMessageReceived({ senderInfo: { jid: sender._jid, id: sender._id }, eventData }); } } }); room.on( JitsiConferenceEvents.LOCK_STATE_CHANGED, (...args) => APP.store.dispatch(lockStateChanged(room, ...args))); room.on(JitsiConferenceEvents.KICKED, (participant, reason, isReplaced) => { if (isReplaced) { // this event triggers when the local participant is kicked, `participant` // is the kicker. In replace participant case, kicker is undefined, // as the server initiated it. We mark in store the local participant // as being replaced based on jwt. const localParticipant = getLocalParticipant(APP.store.getState()); APP.store.dispatch(participantUpdated({ conference: room, id: localParticipant.id, isReplaced })); // we send readyToClose when kicked participant is replace so that // embedding app can choose to dispose the iframe API on the handler. APP.API.notifyReadyToClose(); } APP.store.dispatch(kickedOut(room, participant)); }); room.on(JitsiConferenceEvents.PARTICIPANT_KICKED, (kicker, kicked) => { APP.store.dispatch(participantKicked(kicker, kicked)); }); room.on(JitsiConferenceEvents.SUSPEND_DETECTED, () => { APP.store.dispatch(suspendDetected()); }); APP.UI.addListener(UIEvents.AUDIO_MUTED, muted => { this.muteAudio(muted); }); APP.UI.addListener(UIEvents.VIDEO_MUTED, muted => { this.muteVideo(muted); }); room.addCommandListener(this.commands.defaults.ETHERPAD, ({ value }) => { APP.UI.initEtherpad(value); } ); APP.UI.addListener(UIEvents.EMAIL_CHANGED, this.changeLocalEmail.bind(this)); room.addCommandListener(this.commands.defaults.EMAIL, (data, from) => { APP.store.dispatch(participantUpdated({ conference: room, id: from, email: data.value })); }); room.addCommandListener( this.commands.defaults.AVATAR_URL, (data, from) => { APP.store.dispatch( participantUpdated({ conference: room, id: from, avatarURL: data.value })); }); APP.UI.addListener(UIEvents.NICKNAME_CHANGED, this.changeLocalDisplayName.bind(this)); room.on( JitsiConferenceEvents.START_MUTED_POLICY_CHANGED, ({ audio, video }) => { APP.store.dispatch( onStartMutedPolicyChanged(audio, video)); } ); room.on(JitsiConferenceEvents.STARTED_MUTED, () => { const audioMuted = room.isStartAudioMuted(); const videoMuted = room.isStartVideoMuted(); const localTracks = getLocalTracks(APP.store.getState()['features/base/tracks']); const promises = []; APP.store.dispatch(setAudioMuted(audioMuted)); APP.store.dispatch(setVideoMuted(videoMuted)); // Remove the tracks from the peerconnection. for (const track of localTracks) { // Always add the track on mobile Safari because of a known issue where audio playout doesn't happen // if the user joins audio and video muted. if (audioMuted && track.jitsiTrack?.getType() === MEDIA_TYPE.AUDIO && !isIosMobileBrowser()) { promises.push(this.useAudioStream(null)); } if (videoMuted && track.jitsiTrack?.getType() === MEDIA_TYPE.VIDEO) { promises.push(this.useVideoStream(null)); } } Promise.allSettled(promises) .then(() => APP.UI.notifyInitiallyMuted()); }); room.on( JitsiConferenceEvents.DATA_CHANNEL_OPENED, () => { APP.store.dispatch(dataChannelOpened()); } ); // call hangup APP.UI.addListener(UIEvents.HANGUP, () => { this.hangup(true); }); // logout APP.UI.addListener(UIEvents.LOGOUT, () => { AuthHandler.logout(room).then(url => { if (url) { UIUtil.redirect(url); } else { this.hangup(true); } }); }); APP.UI.addListener(UIEvents.AUTH_CLICKED, () => { AuthHandler.authenticate(room); }); APP.UI.addListener( UIEvents.VIDEO_DEVICE_CHANGED, cameraDeviceId => { const videoWasMuted = this.isLocalVideoMuted(); sendAnalytics(createDeviceChangedEvent('video', 'input')); // If both screenshare and video are in progress, restart the // presenter mode with the new camera device. if (this.isSharingScreen && !videoWasMuted) { const { height } = this.localVideo.track.getSettings(); // dispose the existing presenter track and create a new // camera track. // FIXME JitsiLocalTrack.dispose is async and should be waited for this.localPresenterVideo && this.localPresenterVideo.dispose(); this.localPresenterVideo = null; return this._createPresenterStreamEffect(height, cameraDeviceId) .then(effect => this.localVideo.setEffect(effect)) .then(() => { this.setVideoMuteStatus(); logger.log('Switched local video device while screen sharing and the video is unmuted'); this._updateVideoDeviceId(); }) .catch(err => APP.store.dispatch(notifyCameraError(err))); // If screenshare is in progress but video is muted, update the default device // id for video, dispose the existing presenter track and create a new effect // that can be applied on un-mute. } else if (this.isSharingScreen && videoWasMuted) { logger.log('Switched local video device: while screen sharing and the video is muted'); const { height } = this.localVideo.track.getSettings(); this._updateVideoDeviceId(); // FIXME JitsiLocalTrack.dispose is async and should be waited for this.localPresenterVideo && this.localPresenterVideo.dispose(); this.localPresenterVideo = null; this._createPresenterStreamEffect(height, cameraDeviceId); // if there is only video, switch to the new camera stream. } else { createLocalTracksF({ devices: [ 'video' ], cameraDeviceId, micDeviceId: null }) .then(([ stream ]) => { // if we are in audio only mode or video was muted before // changing device, then mute if (this.isAudioOnly() || videoWasMuted) { return stream.mute() .then(() => stream); } return stream; }) .then(stream => { logger.log('Switching the local video device.'); return this.useVideoStream(stream); }) .then(() => { logger.log('Switched local video device.'); this._updateVideoDeviceId(); }) .catch(error => { logger.error(`Switching the local video device failed: ${error}`); return APP.store.dispatch(notifyCameraError(error)); }); } } ); APP.UI.addListener( UIEvents.AUDIO_DEVICE_CHANGED, micDeviceId => { const audioWasMuted = this.isLocalAudioMuted(); // When the 'default' mic needs to be selected, we need to // pass the real device id to gUM instead of 'default' in order // to get the correct MediaStreamTrack from chrome because of the // following bug. // https://bugs.chromium.org/p/chromium/issues/detail?id=997689 const hasDefaultMicChanged = micDeviceId === 'default'; sendAnalytics(createDeviceChangedEvent('audio', 'input')); createLocalTracksF({ devices: [ 'audio' ], cameraDeviceId: null, micDeviceId: hasDefaultMicChanged ? getDefaultDeviceId(APP.store.getState(), 'audioInput') : micDeviceId }) .then(([ stream ]) => { // if audio was muted before changing the device, mute // with the new device if (audioWasMuted) { return stream.mute() .then(() => stream); } return stream; }) .then(async stream => { // In case screen sharing audio is also shared we mix it with new input stream. The old _mixerEffect // will be cleaned up when the existing track is replaced. if (this._mixerEffect) { this._mixerEffect = new AudioMixerEffect(this._desktopAudioStream); await stream.setEffect(this._mixerEffect); } return this.useAudioStream(stream); }) .then(() => { if (this.localAudio && hasDefaultMicChanged) { // workaround for the default device to be shown as selected in the // settings even when the real device id was passed to gUM because of the // above mentioned chrome bug. this.localAudio._realDeviceId = this.localAudio.deviceId = 'default'; } logger.log(`switched local audio device: ${this.localAudio?.getDeviceId()}`); this._updateAudioDeviceId(); }) .catch(err => { APP.store.dispatch(notifyMicError(err)); }); } ); APP.UI.addListener(UIEvents.TOGGLE_AUDIO_ONLY, audioOnly => { // FIXME On web video track is stored both in redux and in // 'localVideo' field, video is attempted to be unmuted twice when // turning off the audio only mode. This will crash the app with // 'unmute operation is already in progress'. // Because there's no logic in redux about creating new track in // case unmute when not track exists the things have to go through // muteVideo logic in such case. const tracks = APP.store.getState()['features/base/tracks']; const isTrackInRedux = Boolean( tracks.find( track => track.jitsiTrack && track.jitsiTrack.getType() === 'video')); if (!isTrackInRedux) { this.muteVideo(audioOnly); } // Immediately update the UI by having remote videos and the large // video update themselves instead of waiting for some other event // to cause the update, usually PARTICIPANT_CONN_STATUS_CHANGED. // There is no guarantee another event will trigger the update // immediately and in all situations, for example because a remote // participant is having connection trouble so no status changes. const displayedUserId = APP.UI.getLargeVideoID(); if (displayedUserId) { APP.UI.updateLargeVideo(displayedUserId, true); } }); APP.UI.addListener( UIEvents.TOGGLE_SCREENSHARING, ({ enabled, audioOnly }) => { this.toggleScreenSharing(enabled, { audioOnly }); } ); }, /** * Cleanups local conference on suspend. */ onSuspendDetected() { // After wake up, we will be in a state where conference is left // there will be dialog shown to user. // We do not want video/audio as we show an overlay and after it // user need to rejoin or close, while waking up we can detect // camera wakeup as a problem with device. // We also do not care about device change, which happens // on resume after suspending PC. if (this.deviceChangeListener) { JitsiMeetJS.mediaDevices.removeEventListener( JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED, this.deviceChangeListener); } this.localVideo = null; this.localAudio = null; }, /** * Callback invoked when the conference has been successfully joined. * Initializes the UI and various other features. * * @private * @returns {void} */ _onConferenceJoined() { APP.UI.initConference(); if (!config.disableShortcuts) { APP.keyboardshortcut.init(); } APP.store.dispatch(conferenceJoined(room)); }, /** * Updates the list of current devices. * @param {boolean} setDeviceListChangeHandler - Whether to add the deviceList change handlers. * @private * @returns {Promise} */ _initDeviceList(setDeviceListChangeHandler = false) { const { mediaDevices } = JitsiMeetJS; if (mediaDevices.isDeviceListAvailable() && mediaDevices.isDeviceChangeAvailable()) { if (setDeviceListChangeHandler) { this.deviceChangeListener = devices => window.setTimeout(() => this._onDeviceListChanged(devices), 0); mediaDevices.addEventListener( JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED, this.deviceChangeListener); } const { dispatch } = APP.store; return dispatch(getAvailableDevices()) .then(devices => { // Ugly way to synchronize real device IDs with local // storage and settings menu. This is a workaround until // getConstraints() method will be implemented in browsers. this._updateAudioDeviceId(); this._updateVideoDeviceId(); APP.UI.onAvailableDevicesChanged(devices); }); } return Promise.resolve(); }, /** * Updates the settings for the currently used video device, extracting * the device id from the used track. * @private */ _updateVideoDeviceId() { if (this.localVideo && this.localVideo.videoType === 'camera') { APP.store.dispatch(updateSettings({ cameraDeviceId: this.localVideo.getDeviceId() })); } // If screenshare is in progress, get the device id from the presenter track. if (this.localPresenterVideo) { APP.store.dispatch(updateSettings({ cameraDeviceId: this.localPresenterVideo.getDeviceId() })); } }, /** * Updates the settings for the currently used audio device, extracting * the device id from the used track. * @private */ _updateAudioDeviceId() { if (this.localAudio) { APP.store.dispatch(updateSettings({ micDeviceId: this.localAudio.getDeviceId() })); } }, /** * Event listener for JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED to * handle change of available media devices. * @private * @param {MediaDeviceInfo[]} devices * @returns {Promise} */ _onDeviceListChanged(devices) { const oldDevices = APP.store.getState()['features/base/devices'].availableDevices; APP.store.dispatch(updateDeviceList(devices)); const newDevices = mediaDeviceHelper.getNewMediaDevicesAfterDeviceListChanged( devices, this.isSharingScreen, this.localVideo, this.localAudio); const promises = []; const audioWasMuted = this.isLocalAudioMuted(); const videoWasMuted = this.isLocalVideoMuted(); const requestedInput = { audio: Boolean(newDevices.audioinput), video: Boolean(newDevices.videoinput) }; if (typeof newDevices.audiooutput !== 'undefined') { const { dispatch } = APP.store; const setAudioOutputPromise = setAudioOutputDeviceId(newDevices.audiooutput, dispatch) .catch(); // Just ignore any errors in catch block. promises.push(setAudioOutputPromise); } // Handles the use case when the default device is changed (we are always stopping the streams because it's // simpler): // If the default device is changed we need to first stop the local streams and then call GUM. Otherwise GUM // will return a stream using the old default device. if (requestedInput.audio && this.localAudio) { this.localAudio.stopStream(); } if (requestedInput.video && this.localVideo) { this.localVideo.stopStream(); } // Let's handle unknown/non-preferred devices const newAvailDevices = APP.store.getState()['features/base/devices'].availableDevices; let newAudioDevices = []; let oldAudioDevices = []; if (typeof newDevices.audiooutput === 'undefined') { newAudioDevices = newAvailDevices.audioOutput; oldAudioDevices = oldDevices.audioOutput; } if (!requestedInput.audio) { newAudioDevices = newAudioDevices.concat(newAvailDevices.audioInput); oldAudioDevices = oldAudioDevices.concat(oldDevices.audioInput); } // check for audio if (newAudioDevices.length > 0) { APP.store.dispatch( checkAndNotifyForNewDevice(newAudioDevices, oldAudioDevices)); } // check for video if (!requestedInput.video) { APP.store.dispatch( checkAndNotifyForNewDevice(newAvailDevices.videoInput, oldDevices.videoInput)); } // When the 'default' mic needs to be selected, we need to // pass the real device id to gUM instead of 'default' in order // to get the correct MediaStreamTrack from chrome because of the // following bug. // https://bugs.chromium.org/p/chromium/issues/detail?id=997689 const hasDefaultMicChanged = newDevices.audioinput === 'default'; // This is the case when the local video is muted and a preferred device is connected. if (requestedInput.video && this.isLocalVideoMuted()) { // We want to avoid creating a new video track in order to prevent turning on the camera. requestedInput.video = false; APP.store.dispatch(updateSettings({ // Update the current selected camera for the device selection dialog. cameraDeviceId: newDevices.videoinput })); delete newDevices.videoinput; // Removing the current video track in order to force the unmute to select the preferred device. logger.debug('_onDeviceListChanged: Removing the current video track.'); this.useVideoStream(null); } promises.push( mediaDeviceHelper.createLocalTracksAfterDeviceListChanged( createLocalTracksF, newDevices.videoinput, hasDefaultMicChanged ? getDefaultDeviceId(APP.store.getState(), 'audioInput') : newDevices.audioinput) .then(tracks => { // If audio or video muted before, or we unplugged current // device and selected new one, then mute new track. const muteSyncPromises = tracks.map(track => { if ((track.isVideoTrack() && videoWasMuted) || (track.isAudioTrack() && audioWasMuted)) { return track.mute(); } return Promise.resolve(); }); return Promise.all(muteSyncPromises) .then(() => Promise.all(Object.keys(requestedInput).map(mediaType => { if (requestedInput[mediaType]) { const useStream = mediaType === 'audio' ? this.useAudioStream.bind(this) : this.useVideoStream.bind(this); // Use the new stream or null if we failed to obtain it. return useStream(tracks.find(track => track.getType() === mediaType) || null) .then(() => { if (this.localAudio && hasDefaultMicChanged) { // workaround for the default device to be shown as selected in the // settings even when the real device id was passed to gUM because of // the above mentioned chrome bug. this.localAudio._realDeviceId = this.localAudio.deviceId = 'default'; } mediaType === 'audio' ? this._updateAudioDeviceId() : this._updateVideoDeviceId(); }); } return Promise.resolve(); }))); }) .then(() => { // Log and sync known mute state. if (audioWasMuted) { sendAnalytics(createTrackMutedEvent( 'audio', 'device list changed')); logger.log('Audio mute: device list changed'); muteLocalAudio(true); } if (!this.isSharingScreen && videoWasMuted) { sendAnalytics(createTrackMutedEvent( 'video', 'device list changed')); logger.log('Video mute: device list changed'); muteLocalVideo(true); } })); return Promise.all(promises) .then(() => { APP.UI.onAvailableDevicesChanged(devices); }); }, /** * Determines whether or not the audio button should be enabled. */ updateAudioIconEnabled() { const audioMediaDevices = APP.store.getState()['features/base/devices'].availableDevices.audioInput; const audioDeviceCount = audioMediaDevices ? audioMediaDevices.length : 0; // The audio functionality is considered available if there are any // audio devices detected or if the local audio stream already exists. const available = audioDeviceCount > 0 || Boolean(this.localAudio); APP.store.dispatch(setAudioAvailable(available)); APP.API.notifyAudioAvailabilityChanged(available); }, /** * Determines whether or not the video button should be enabled. */ updateVideoIconEnabled() { const videoMediaDevices = APP.store.getState()['features/base/devices'].availableDevices.videoInput; const videoDeviceCount = videoMediaDevices ? videoMediaDevices.length : 0; // The video functionality is considered available if there are any // video devices detected or if there is local video stream already // active which could be either screensharing stream or a video track // created before the permissions were rejected (through browser // config). const available = videoDeviceCount > 0 || Boolean(this.localVideo); APP.store.dispatch(setVideoAvailable(available)); APP.API.notifyVideoAvailabilityChanged(available); }, /** * Disconnect from the conference and optionally request user feedback. * @param {boolean} [requestFeedback=false] if user feedback should be * requested */ hangup(requestFeedback = false) { APP.store.dispatch(disableReceiver()); this._stopProxyConnection(); APP.store.dispatch(destroyLocalTracks()); this._localTracksInitialized = false; this.localVideo = null; this.localAudio = null; // Remove unnecessary event listeners from firing callbacks. if (this.deviceChangeListener) { JitsiMeetJS.mediaDevices.removeEventListener( JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED, this.deviceChangeListener); } APP.UI.removeAllListeners(); let requestFeedbackPromise; if (requestFeedback) { requestFeedbackPromise = APP.store.dispatch(maybeOpenFeedbackDialog(room)) // false because the thank you dialog shouldn't be displayed .catch(() => Promise.resolve(false)); } else { requestFeedbackPromise = Promise.resolve(true); } Promise.all([ requestFeedbackPromise, this.leaveRoomAndDisconnect() ]) .then(values => { this._room = undefined; room = undefined; /** * Don't call {@code notifyReadyToClose} if the promotional page flag is set * and let the page take care of sending the message, since there will be * a redirect to the page regardlessly. */ if (!interfaceConfig.SHOW_PROMOTIONAL_CLOSE_PAGE) { APP.API.notifyReadyToClose(); } APP.store.dispatch(maybeRedirectToWelcomePage(values[0])); }); }, /** * Leaves the room and calls JitsiConnection.disconnect. * * @returns {Promise} */ leaveRoomAndDisconnect() { APP.store.dispatch(conferenceWillLeave(room)); if (room && room.isJoined()) { return room.leave().then(disconnect, disconnect); } return disconnect(); }, /** * Changes the email for the local user * @param email {string} the new email */ changeLocalEmail(email = '') { const localParticipant = getLocalParticipant(APP.store.getState()); const formattedEmail = String(email).trim(); if (formattedEmail === localParticipant.email) { return; } const localId = localParticipant.id; APP.store.dispatch(participantUpdated({ // XXX Only the local participant is allowed to update without // stating the JitsiConference instance (i.e. participant property // `conference` for a remote participant) because the local // participant is uniquely identified by the very fact that there is // only one local participant. id: localId, local: true, email: formattedEmail })); APP.store.dispatch(updateSettings({ email: formattedEmail })); APP.API.notifyEmailChanged(localId, { email: formattedEmail }); sendData(commands.EMAIL, formattedEmail); }, /** * Changes the avatar url for the local user * @param url {string} the new url */ changeLocalAvatarUrl(url = '') { const { avatarURL, id } = getLocalParticipant(APP.store.getState()); const formattedUrl = String(url).trim(); if (formattedUrl === avatarURL) { return; } APP.store.dispatch(participantUpdated({ // XXX Only the local participant is allowed to update without // stating the JitsiConference instance (i.e. participant property // `conference` for a remote participant) because the local // participant is uniquely identified by the very fact that there is // only one local participant. id, local: true, avatarURL: formattedUrl })); APP.store.dispatch(updateSettings({ avatarURL: formattedUrl })); sendData(commands.AVATAR_URL, url); }, /** * Sends a message via the data channel. * @param {string} to the id of the endpoint that should receive the * message. If "" - the message will be sent to all participants. * @param {object} payload the payload of the message. * @throws NetworkError or InvalidStateError or Error if the operation * fails. */ sendEndpointMessage(to, payload) { room.sendEndpointMessage(to, payload); }, /** * Adds new listener. * @param {String} eventName the name of the event * @param {Function} listener the listener. */ addListener(eventName, listener) { eventEmitter.addListener(eventName, listener); }, /** * Removes listener. * @param {String} eventName the name of the event that triggers the * listener * @param {Function} listener the listener. */ removeListener(eventName, listener) { eventEmitter.removeListener(eventName, listener); }, /** * Changes the display name for the local user * @param nickname {string} the new display name */ changeLocalDisplayName(nickname = '') { const formattedNickname = getNormalizedDisplayName(nickname); const { id, name } = getLocalParticipant(APP.store.getState()); if (formattedNickname === name) { return; } APP.store.dispatch(participantUpdated({ // XXX Only the local participant is allowed to update without // stating the JitsiConference instance (i.e. participant property // `conference` for a remote participant) because the local // participant is uniquely identified by the very fact that there is // only one local participant. id, local: true, name: formattedNickname })); APP.store.dispatch(updateSettings({ displayName: formattedNickname })); }, /** * Callback invoked by the external api create or update a direct connection * from the local client to an external client. * * @param {Object} event - The object containing information that should be * passed to the {@code ProxyConnectionService}. * @returns {void} */ onProxyConnectionEvent(event) { if (!this._proxyConnection) { this._proxyConnection = new JitsiMeetJS.ProxyConnectionService({ /** * Pass the {@code JitsiConnection} instance which will be used * to fetch TURN credentials. */ jitsiConnection: APP.connection, /** * The proxy connection feature is currently tailored towards * taking a proxied video stream and showing it as a local * desktop screen. */ convertVideoToDesktop: true, /** * Callback invoked when the connection has been closed * automatically. Triggers cleanup of screensharing if active. * * @returns {void} */ onConnectionClosed: () => { if (this._untoggleScreenSharing) { this._untoggleScreenSharing(); } }, /** * Callback invoked to pass messages from the local client back * out to the external client. * * @param {string} peerJid - The jid of the intended recipient * of the message. * @param {Object} data - The message that should be sent. For * screensharing this is an iq. * @returns {void} */ onSendMessage: (peerJid, data) => APP.API.sendProxyConnectionEvent({ data, to: peerJid }), /** * Callback invoked when the remote peer of the proxy connection * has provided a video stream, intended to be used as a local * desktop stream. * * @param {JitsiLocalTrack} remoteProxyStream - The media * stream to use as a local desktop stream. * @returns {void} */ onRemoteStream: desktopStream => { if (desktopStream.videoType !== 'desktop') { logger.warn('Received a non-desktop stream to proxy.'); desktopStream.dispose(); return; } this.toggleScreenSharing(undefined, { desktopStream }); } }); } this._proxyConnection.processMessage(event); }, /** * Sets the video muted status. */ setVideoMuteStatus() { APP.UI.setVideoMuted(this.getMyUserId()); }, /** * Sets the audio muted status. * * @param {boolean} muted - New muted status. */ setAudioMuteStatus(muted) { APP.UI.setAudioMuted(this.getMyUserId(), muted); APP.API.notifyAudioMutedStatusChanged(muted); }, /** * Dispatches the passed in feedback for submission. The submitted score * should be a number inclusively between 1 through 5, or -1 for no score. * * @param {number} score - a number between 1 and 5 (inclusive) or -1 for no * score. * @param {string} message - An optional message to attach to the feedback * in addition to the score. * @returns {void} */ submitFeedback(score = -1, message = '') { if (score === -1 || (score >= 1 && score <= 5)) { APP.store.dispatch(submitFeedback(score, message, room)); } }, /** * Terminates any proxy screensharing connection that is active. * * @private * @returns {void} */ _stopProxyConnection() { if (this._proxyConnection) { this._proxyConnection.stop(); } this._proxyConnection = null; } };