/* global $, APP, JitsiMeetJS, config, interfaceConfig */ import { openConnection } from './connection'; import AuthHandler from './modules/UI/authentication/AuthHandler'; import Recorder from './modules/recorder/Recorder'; import mediaDeviceHelper from './modules/devices/mediaDeviceHelper'; import { reportError } from './modules/util/helpers'; import * as RemoteControlEvents from './service/remotecontrol/RemoteControlEvents'; import UIEvents from './service/UI/UIEvents'; import UIUtil from './modules/UI/util/UIUtil'; import * as JitsiMeetConferenceEvents from './ConferenceEvents'; import { createDeviceChangedEvent, createScreenSharingEvent, createSelectParticipantFailedEvent, createStreamSwitchDelayEvent, createTrackMutedEvent, initAnalytics, sendAnalytics } from './react/features/analytics'; import { redirectWithStoredParams, reloadWithStoredParams } from './react/features/app'; import EventEmitter from 'events'; import { AVATAR_ID_COMMAND, AVATAR_URL_COMMAND, conferenceFailed, conferenceJoined, conferenceLeft, conferenceWillJoin, dataChannelOpened, EMAIL_COMMAND, lockStateChanged, onStartMutedPolicyChanged, p2pStatusChanged, sendLocalParticipant, setDesktopSharingEnabled } from './react/features/base/conference'; import { updateDeviceList } from './react/features/base/devices'; import { isAnalyticsEnabled, isFatalJitsiConnectionError, JitsiConferenceErrors, JitsiConferenceEvents, JitsiConnectionErrors, JitsiConnectionEvents, JitsiMediaDevicesEvents, JitsiParticipantConnectionStatus, JitsiTrackErrors, JitsiTrackEvents } from './react/features/base/lib-jitsi-meet'; import { isVideoMutedByUser, MEDIA_TYPE, setAudioAvailable, setAudioMuted, setVideoAvailable, setVideoMuted } from './react/features/base/media'; import { showNotification } from './react/features/notifications'; import { dominantSpeakerChanged, getAvatarURLByParticipantId, getLocalParticipant, getParticipantById, localParticipantConnectionStatusChanged, localParticipantRoleChanged, MAX_DISPLAY_NAME_LENGTH, participantConnectionStatusChanged, participantJoined, participantLeft, participantPresenceChanged, participantRoleChanged, participantUpdated } from './react/features/base/participants'; import { createLocalTracksF, isLocalTrackMuted, replaceLocalTrack, trackAdded, trackRemoved } from './react/features/base/tracks'; import { getLocationContextRoot, getJitsiMeetGlobalNS } from './react/features/base/util'; import { statsEmitter } from './react/features/connection-indicator'; import { showDesktopPicker } from './react/features/desktop-picker'; import { appendSuffix } from './react/features/display-name'; import { maybeOpenFeedbackDialog, submitFeedback } from './react/features/feedback'; import { mediaPermissionPromptVisibilityChanged, suspendDetected } from './react/features/overlay'; import { setSharedVideoStatus } from './react/features/shared-video'; import { isButtonEnabled, showDesktopSharingButton } from './react/features/toolbox'; const logger = require('jitsi-meet-logger').getLogger(__filename); const eventEmitter = new EventEmitter(); let room; let connection; /* * 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_ID: AVATAR_ID_COMMAND, AVATAR_URL: AVATAR_URL_COMMAND, CUSTOM_ROLE: 'custom-role', EMAIL: EMAIL_COMMAND, ETHERPAD: 'etherpad', SHARED_VIDEO: 'shared-video' }; /** * 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)); } /** * Check if the welcome page is enabled and redirects to it. * If requested show a thank you dialog before that. * If we have a close page enabled, redirect to it without * showing any other dialog. * * @param {object} options used to decide which particular close page to show * or if close page is disabled, whether we should show the thankyou dialog * @param {boolean} options.showThankYou - whether we should * show thank you dialog * @param {boolean} options.feedbackSubmitted - whether feedback was submitted */ function maybeRedirectToWelcomePage(options) { // if close page is enabled redirect to it, without further action if (config.enableClosePage) { const { isGuest } = APP.store.getState()['features/base/jwt']; // save whether current user is guest or not, before navigating // to close page window.sessionStorage.setItem('guest', isGuest); redirectToStaticPage(`static/${ options.feedbackSubmitted ? 'close.html' : 'close2.html'}`); return; } // else: show thankYou dialog only if there is no feedback if (options.showThankYou) { APP.store.dispatch(showNotification({ titleArguments: { appName: interfaceConfig.APP_NAME }, titleKey: 'dialog.thankYou' })); } // if Welcome page is enabled redirect to welcome page after 3 sec, if // there is a thank you message to be shown, 0.5s otherwise. if (config.enableWelcomePage) { setTimeout( () => { APP.store.dispatch(redirectWithStoredParams('/')); }, options.showThankYou ? 3000 : 500); } } /** * Assigns a specific pathname to window.location.pathname taking into account * the context root of the Web app. * * @param {string} pathname - The pathname to assign to * window.location.pathname. If the specified pathname is relative, the context * root of the Web app will be prepended to the specified pathname before * assigning it to window.location.pathname. * @return {void} */ function redirectToStaticPage(pathname) { const windowLocation = window.location; let newPathname = pathname; if (!newPathname.startsWith('/')) { // A pathname equal to ./ specifies the current directory. It will be // fine but pointless to include it because contextRoot is the current // directory. newPathname.startsWith('./') && (newPathname = newPathname.substring(2)); newPathname = getLocationContextRoot(windowLocation) + newPathname; } windowLocation.pathname = newPathname; } /** * */ 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)); room.on(JitsiConferenceEvents.CONFERENCE_ERROR, this._onConferenceError.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.CONNECTION_ERROR: { const [ msg ] = params; APP.UI.notifyConnectionFailed(msg); break; } case JitsiConferenceErrors.NOT_ALLOWED_ERROR: { // let's show some auth not allowed page redirectToStaticPage('static/authError.html'); break; } // not enough rights to create conference case JitsiConferenceErrors.AUTHENTICATION_REQUIRED: { // Schedule reconnect to check if someone else created the room. this.reconnectTimeout = setTimeout(() => room.join(), 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; case JitsiConferenceErrors.JINGLE_FATAL_ERROR: { const [ error ] = params; APP.UI.notifyInternalError(error); break; } case JitsiConferenceErrors.CONFERENCE_DESTROYED: { const [ reason ] = params; APP.UI.hideStats(); APP.UI.notifyConferenceDestroyed(reason); 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.VIDEOBRIDGE_NOT_AVAILABLE: // 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); } } /** * */ _onConferenceError(err, ...params) { logger.error('CONFERENCE Error:', err, params); switch (err) { case JitsiConferenceErrors.CHAT_ERROR: logger.error('Chat error.', err); if (isButtonEnabled('chat')) { const [ code, msg ] = params; APP.UI.showChatError(code, msg); } break; default: logger.error('Unknown error.', err); } } /** * */ _unsubscribe() { room.off( JitsiConferenceEvents.CONFERENCE_JOINED, this._handleConferenceJoined); room.off( JitsiConferenceEvents.CONFERENCE_FAILED, this._onConferenceFailed); if (this.reconnectTimeout !== null) { clearTimeout(this.reconnectTimeout); } AuthHandler.closeAuth(); } /** * */ _handleConferenceJoined() { this._unsubscribe(); this._resolve(); } /** * */ connect() { room.join(); } } /** * 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() { connection.disconnect(); APP.API.notifyConferenceLeft(APP.conference.roomName); return Promise.resolve(); } /** * 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) { 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, isModerator: false, isSharingScreen: false, /** * Indicates if the desktop sharing functionality has been enabled. * It takes into consideration {@link isDesktopSharingDisabledByConfig} * as well as the status returned by * {@link JitsiMeetJS.isDesktopSharingEnabled()}. The latter can be false * either if the desktop sharing is not supported by the current browser * or if it was disabled through lib-jitsi-meet specific options (check * config.js for listed options). */ isDesktopSharingEnabled: false, /** * Set to true if the desktop sharing functionality has been * explicitly disabled in the config. */ isDesktopSharingDisabledByConfig: false, /** * The text displayed when the desktop sharing button is disabled through * the config. The value is set through * {@link interfaceConfig.DESKTOP_SHARING_BUTTON_DISABLED_TOOLTIP}. */ desktopSharingDisabledTooltip: null, /** * 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 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, /** * 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 = {}) { let audioAndVideoError, audioOnlyError, screenSharingError, videoOnlyError; const initialDevices = []; let requestedAudio = false; let requestedVideo = false; if (!options.startWithAudioMuted) { initialDevices.push('audio'); requestedAudio = true; } if (!options.startWithVideoMuted && !options.startAudioOnly && !options.startScreenSharing) { initialDevices.push('video'); requestedVideo = true; } JitsiMeetJS.mediaDevices.addEventListener( JitsiMediaDevicesEvents.PERMISSION_PROMPT_IS_SHOWN, browser => APP.store.dispatch( mediaPermissionPromptVisibilityChanged(true, browser)) ); let tryCreateLocalTracks; // 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' ] }, true) .then(([ audioStream ]) => [ desktopStream, audioStream ]) .catch(error => { audioOnlyError = error; return [ desktopStream ]; }); }) .catch(error => { logger.error('Failed to obtain desktop stream', error); screenSharingError = error; return requestedAudio ? createLocalTracksF({ devices: [ 'audio' ] }, true) : []; }) .catch(error => { audioOnlyError = error; return []; }); } else if (!requestedAudio && !requestedVideo) { // Resolve with no tracks tryCreateLocalTracks = Promise.resolve([]); } else { tryCreateLocalTracks = createLocalTracksF( { devices: initialDevices }, true) .catch(err => { if (requestedAudio && requestedVideo) { // Try audio only... audioAndVideoError = err; return ( createLocalTracksF({ devices: [ 'audio' ] }, true)); } else if (requestedAudio && !requestedVideo) { audioOnlyError = err; return []; } else if (requestedVideo && !requestedAudio) { videoOnlyError = err; return []; } logger.error('Should never happen'); }) .catch(err => { // Log this just in case... if (!requestedAudio) { logger.error('The impossible just happened', err); } audioOnlyError = err; // Try video only... return requestedVideo ? createLocalTracksF({ devices: [ 'video' ] }, true) : []; }) .catch(err => { // Log this just in case... if (!requestedVideo) { logger.error('The impossible just happened', err); } 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 rquired, for instance, that won't happen until // the user inputs their credentials, but the dialog would be // overshadowed by the overlay. tryCreateLocalTracks.then(() => APP.store.dispatch(mediaPermissionPromptVisibilityChanged(false))); return Promise.all([ tryCreateLocalTracks, connect(roomName) ]) .then(([ tracks, con ]) => { // 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.UI.showMicErrorNotification(audioOnlyError); APP.UI.showCameraErrorNotification(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.UI.showCameraErrorNotification(audioAndVideoError); } } return [ tracks, con ]; }); }, /** * Open new connection and join to the conference. * @param {object} options * @param {string} roomName name of the conference * @returns {Promise} */ init(options) { this.roomName = options.roomName; // attaches global error handler, if there is already one, respect it if (JitsiMeetJS.getGlobalOnErrorHandler) { const oldOnErrorHandler = window.onerror; // eslint-disable-next-line max-params window.onerror = (message, source, lineno, colno, error) => { JitsiMeetJS.getGlobalOnErrorHandler( message, source, lineno, colno, error); if (oldOnErrorHandler) { oldOnErrorHandler(message, source, lineno, colno, error); } }; const oldOnUnhandledRejection = window.onunhandledrejection; window.onunhandledrejection = function(event) { JitsiMeetJS.getGlobalOnErrorHandler( null, null, null, null, event.reason); if (oldOnUnhandledRejection) { oldOnUnhandledRejection(event); } }; } return ( JitsiMeetJS.init({ enableAnalyticsLogging: isAnalyticsEnabled(APP.store), ...config }).then(() => { initAnalytics(APP.store); return this.createInitialLocalTracksAndConnect( options.roomName, { startAudioOnly: config.startAudioOnly, startScreenSharing: config.startScreenSharing, startWithAudioMuted: config.startWithAudioMuted, startWithVideoMuted: config.startWithVideoMuted }); }) .then(([ tracks, con ]) => { 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 %s local tracks', tracks.length); this._localTracksInitialized = true; con.addEventListener( JitsiConnectionEvents.CONNECTION_FAILED, _connectionFailedHandler); APP.connection = connection = con; // Desktop sharing related stuff: this.isDesktopSharingDisabledByConfig = config.disableDesktopSharing; this.isDesktopSharingEnabled = !this.isDesktopSharingDisabledByConfig && JitsiMeetJS.isDesktopSharingEnabled(); this.desktopSharingDisabledTooltip = interfaceConfig.DESKTOP_SHARING_BUTTON_DISABLED_TOOLTIP; eventEmitter.emit( JitsiMeetConferenceEvents.DESKTOP_SHARING_ENABLED_CHANGED, this.isDesktopSharingEnabled); APP.store.dispatch( setDesktopSharingEnabled(this.isDesktopSharingEnabled)); APP.store.dispatch(showDesktopSharingButton()); this._createRoom(tracks); APP.remoteControl.init(); // 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(true); } this._initDeviceList(); if (config.iAmRecorder) { this.recorder = new Recorder(); } // 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(); }); }) ); }, /** * 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 ? isLocalTrackMuted( APP.store.getState()['features/base/tracks'], MEDIA_TYPE.VIDEO) : 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) { // 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.UI.showMicErrorNotification(error); }; createLocalTracksF({ devices: [ 'audio' ] }, false) .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 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 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(mute); return; } else if (this.isLocalVideoMuted() === mute) { // NO-OP return; } // FIXME it is possible to queue this task twice, but it's not causing // any issues. Specifically this can happen when the previous // get user media call is blocked on "ask user for permissions" dialog. if (!this.localVideo && !mute) { const maybeShowErrorDialog = error => { showUI && APP.UI.showCameraErrorNotification(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' ] }, false) .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 => 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 conference participants (without local user). * @returns {JitsiParticipant[]} */ listMembers() { return room.getParticipants(); }, /** * 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(); }, 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(); }, /** * Sends the given feedback through CallStats if enabled. * * @param overallFeedback an integer between 1 and 5 indicating the * user feedback * @param detailedFeedback detailed feedback from the user. Not yet used */ sendFeedback(overallFeedback, detailedFeedback) { return room.sendFeedback(overallFeedback, detailedFeedback); }, /** * 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 this._room.getConnectionTimes(); }, // used by torture currently isJoined() { return this._room && this._room.isJoined(); }, getConnectionState() { return this._room && this._room.getConnectionState(); }, /** * Obtains current P2P ICE connection state. * @return {string|null} ICE connection state or null if there's no * P2P connection */ getP2PConnectionState() { return this._room && this._room.getP2PConnectionState(); }, /** * Starts P2P (for tests only) * @private */ _startP2P() { try { this._room && this._room.startP2PSession(); } catch (error) { logger.error('Start P2P failed', error); throw error; } }, /** * Stops P2P (for tests only) * @private */ _stopP2P() { try { this._room && this._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 this._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; }, /** * Get participant connection status for the participant. * * @param {string} id participant's identifier(MUC nickname) * * @returns {ParticipantConnectionStatus|null} the status of the participant * or null if no such participant is found or participant is the local user. */ getParticipantConnectionStatus(id) { const participant = this.getParticipantById(id); return participant ? participant.getConnectionStatus() : 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 this._room && this._room.myUserId(); }, /** * Indicates if recording is supported in this conference. */ isRecordingSupported() { return this._room && this._room.isRecordingSupported(); }, /** * Returns the recording state or undefined if the room is not defined. */ getRecordingState() { return this._room ? this._room.getRecordingState() : undefined; }, /** * 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 this._room.getParticipants() .filter(p => p.getTracks().length > 0) .length; }, /** * Returns the stats. */ getStats() { return room.connectionQuality.getStats(); }, // end used by torture getLogs() { return room.getLogs(); }, /** * 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.conference.getLogs(); const data = encodeURIComponent(JSON.stringify(logs, null, ' ')); const elem = document.createElement('a'); elem.download = filename; elem.href = `data:application/json;charset=utf-8,\n${data}`; elem.dataset.downloadurl = [ 'text/json', elem.download, elem.href ].join(':'); elem.dispatchEvent(new MouseEvent('click', { view: window, bubbles: true, cancelable: false })); }, /** * 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)); this._setLocalAudioVideoStreams(localTracks); 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()) { return this.useVideoStream(track); } logger.error( 'Ignored not an audio nor a video track: ', track); return Promise.resolve(); }); }, _getConferenceOptions() { const options = config; if (config.enableRecording && !config.recordingType) { options.recordingType = config.hosts && (typeof config.hosts.jirecon !== 'undefined') ? 'jirecon' : 'colibri'; } const nick = APP.settings.getDisplayName(); if (nick) { options.displayName = nick; } options.applicationName = interfaceConfig.APP_NAME; options.getWiFiStatsMethod = getJitsiMeetGlobalNS().getWiFiStats; return options; }, /** * Start using provided video stream. * Stops previous video stream. * @param {JitsiLocalTrack} [stream] new stream to use or null * @returns {Promise} */ useVideoStream(newStream) { return APP.store.dispatch( replaceLocalTrack(this.localVideo, newStream, room)) .then(() => { this.localVideo = newStream; this._setSharingScreen(newStream); if (newStream) { APP.UI.addLocalStream(newStream); } this.setVideoMuteStatus(this.isLocalVideoMuted()); }); }, /** * 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) { APP.UI.updateDesktopSharingButtons(); APP.API.notifyScreenSharingStatusChanged(this.isSharingScreen); } }, /** * Start using provided audio stream. * Stops previous audio stream. * @param {JitsiLocalTrack} [stream] new stream to use or null * @returns {Promise} */ useAudioStream(newStream) { return APP.store.dispatch( replaceLocalTrack(this.localAudio, newStream, room)) .then(() => { this.localAudio = newStream; if (newStream) { APP.UI.addLocalStream(newStream); } this.setAudioMuteStatus(this.isLocalAudioMuted()); }); }, /** * Triggers a tooltip to display when a feature was attempted to be used * while in audio only mode. * * @param {string} featureName - The name of the feature that attempted to * toggle. * @private * @returns {void} */ _displayAudioOnlyTooltip(featureName) { let buttonName = null; let tooltipElementId = null; switch (featureName) { case 'screenShare': buttonName = 'desktop'; tooltipElementId = 'screenshareWhileAudioOnly'; break; case 'videoMute': buttonName = 'camera'; tooltipElementId = 'unmuteWhileAudioOnly'; break; } if (tooltipElementId) { APP.UI.showToolbar(6000); APP.UI.showCustomToolbarPopup( buttonName, tooltipElementId, true, 5000); } }, /** * Returns whether or not the conference is currently in audio only mode. * * @returns {boolean} */ isAudioOnly() { return Boolean( APP.store.getState()['features/base/conference'].audioOnly); }, 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 */ _turnScreenSharingOff(didHaveVideo, wasVideoMuted) { this._untoggleScreenSharing = null; this.videoSwitchInProgress = true; const { receiver } = APP.remoteControl; if (receiver) { receiver.stop(); } let promise = null; if (didHaveVideo) { promise = createLocalTracksF({ devices: [ 'video' ] }) .then(([ stream ]) => this.useVideoStream(stream)) .then(() => { sendAnalytics(createScreenSharingEvent('stopped')); logger.log('Screen sharing stopped, switching to video.'); if (!this.localVideo && wasVideoMuted) { return Promise.reject('No local video to be muted!'); } else if (wasVideoMuted && this.localVideo) { return this.localVideo.mute(); } }) .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 = this.useVideoStream(null); } return promise.then( () => { this.videoSwitchInProgress = false; }, error => { this.videoSwitchInProgress = false; 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.} */ toggleScreenSharing(toggle = !this._untoggleScreenSharing, options = {}) { if (this.videoSwitchInProgress) { return Promise.reject('Switch in progress.'); } if (!this.isDesktopSharingEnabled) { return Promise.reject( 'Cannot toggle screen sharing: not supported.'); } if (this.isAudioOnly()) { this._displayAudioOnlyTooltip('screenShare'); return Promise.reject('No screensharing in audio only mode'); } if (toggle) { return this._switchToScreenSharing(options); } return this._untoggleScreenSharing(); }, /** * Creates desktop (screensharing) {@link JitsiLocalTrack} * @param {Object} [options] - Screen sharing options that will be passed to * createLocalTracks. * * @return {Promise.} - A Promise resolved with * {@link JitsiLocalTrack} for the screensharing or rejected with * {@link JitsiTrackError}. * * @private */ _createDesktopTrack(options = {}) { let externalInstallation = false; let DSExternalInstallationInProgress = false; const didHaveVideo = Boolean(this.localVideo); const wasVideoMuted = this.isLocalVideoMuted(); return createLocalTracksF({ desktopSharingSources: options.desktopSharingSources, devices: [ 'desktop' ], desktopSharingExtensionExternalInstallation: { interval: 500, checkAgain: () => DSExternalInstallationInProgress, listener: (status, url) => { switch (status) { case 'waitingForExtension': { DSExternalInstallationInProgress = true; externalInstallation = true; const listener = () => { // Wait a little bit more just to be sure that we // won't miss the extension installation setTimeout( () => { DSExternalInstallationInProgress = false; }, 500); APP.UI.removeListener( UIEvents.EXTERNAL_INSTALLATION_CANCELED, listener); }; APP.UI.addListener( UIEvents.EXTERNAL_INSTALLATION_CANCELED, listener); APP.UI.showExtensionExternalInstallationDialog(url); break; } case 'extensionFound': // Close the dialog. externalInstallation && $.prompt.close(); break; default: // Unknown status } } } }).then(([ desktopStream ]) => { // Stores the "untoggle" handler which remembers whether was // there any video before and whether was it muted. this._untoggleScreenSharing = this._turnScreenSharingOff .bind(this, didHaveVideo, wasVideoMuted); desktopStream.on( JitsiTrackEvents.LOCAL_TRACK_STOPPED, () => { // If the stream was stopped during screen sharing // session then we should switch back to video. this.isSharingScreen && this._untoggleScreenSharing && this._untoggleScreenSharing(); } ); // close external installation dialog on success. externalInstallation && $.prompt.close(); return desktopStream; }, error => { DSExternalInstallationInProgress = false; // close external installation dialog on success. externalInstallation && $.prompt.close(); throw error; }); }, /** * 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(stream => this.useVideoStream(stream)) .then(() => { this.videoSwitchInProgress = false; 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 inline installation * dialog and ask the user to install the extension, once the extension is * installed it will switch the conference to screensharing. The last option * is that an unrecoverable error dialog will be displayed. * @param {JitsiTrackError} error - The error returned by * {@link _createDesktopTrack} Promise. * @private */ _handleScreenSharingError(error) { if (error.name === JitsiTrackErrors.CHROME_EXTENSION_USER_CANCELED) { return; } logger.error('failed to share local desktop', error); if (error.name === JitsiTrackErrors.CHROME_EXTENSION_USER_GESTURE_REQUIRED) { // If start with screen sharing the extension will fail to install // (if not found), because the request has been triggered by the // script. Show a dialog which asks user to click "install" and try // again switching to the screen sharing. APP.UI.showExtensionInlineInstallationDialog( () => { // eslint-disable-next-line no-empty-function this.toggleScreenSharing().catch(() => {}); } ); return; } // Handling: // JitsiTrackErrors.PERMISSION_DENIED // JitsiTrackErrors.CHROME_EXTENSION_INSTALLATION_ERROR // JitsiTrackErrors.GENERAL // and any other let descriptionKey; let titleKey; if (error.name === JitsiTrackErrors.PERMISSION_DENIED) { // in FF the only option for user is to deny access temporary or // permanently and we only receive permission_denied // we always show some info cause in case of permanently, no info // shown will be bad experience // // TODO: detect interval between requesting permissions and received // error, this way we can detect user interaction which will have // longer delay if (JitsiMeetJS.util.browser.isFirefox()) { descriptionKey = 'dialog.screenSharingFirefoxPermissionDeniedError'; titleKey = 'dialog.screenSharingFirefoxPermissionDeniedTitle'; } else { descriptionKey = 'dialog.screenSharingPermissionDeniedError'; titleKey = 'dialog.screenSharingFailedToInstallTitle'; } } else { descriptionKey = 'dialog.screenSharingFailedToInstall'; titleKey = 'dialog.screenSharingFailedToInstallTitle'; } 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(conferenceLeft(room, ...args))); room.on( JitsiConferenceEvents.AUTH_STATUS_CHANGED, (authEnabled, authLogin) => APP.UI.updateAuthInfo(authEnabled, authLogin)); room.on(JitsiConferenceEvents.PARTCIPANT_FEATURES_CHANGED, user => APP.UI.onUserFeaturesChanged(user)); room.on(JitsiConferenceEvents.USER_JOINED, (id, user) => { if (user.isHidden()) { return; } const displayName = user.getDisplayName(); APP.store.dispatch(participantJoined({ id, name: displayName, role: user.getRole() })); logger.log('USER %s connnected', id, user); APP.API.notifyUserJoined(id, { displayName, formattedDisplayName: appendSuffix( displayName || interfaceConfig.DEFAULT_REMOTE_DISPLAY_NAME) }); APP.UI.addUser(user); // check the roles for the new user and reflect them APP.UI.updateUserRole(user); }); room.on(JitsiConferenceEvents.USER_LEFT, (id, user) => { if (user.isHidden()) { return; } APP.store.dispatch(participantLeft(id, user)); logger.log('USER %s LEFT', id, user); APP.API.notifyUserLeft(id); APP.UI.removeUser(id, user.getDisplayName()); APP.UI.onSharedVideoStop(id); }); 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)); if (this.isModerator !== room.isModerator()) { this.isModerator = room.isModerator(); APP.UI.updateLocalRole(room.isModerator()); } } else { APP.store.dispatch(participantRoleChanged(id, role)); const user = room.getParticipantById(id); if (user) { APP.UI.updateUserRole(user); } } }); 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.TALK_WHILE_MUTED, () => { APP.UI.showToolbar(6000); APP.UI.showCustomToolbarPopup( 'microphone', 'talkWhileMutedPopup', true, 5000); }); 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)); APP.UI.participantConnectionStatusChanged(id); }); room.on(JitsiConferenceEvents.DOMINANT_SPEAKER_CHANGED, id => { APP.store.dispatch(dominantSpeakerChanged(id)); }); if (!interfaceConfig.filmStripOnly) { room.on(JitsiConferenceEvents.CONNECTION_INTERRUPTED, () => { APP.UI.markVideoInterrupted(true); }); room.on(JitsiConferenceEvents.CONNECTION_RESTORED, () => { APP.UI.markVideoInterrupted(false); }); if (isButtonEnabled('chat')) { room.on( JitsiConferenceEvents.MESSAGE_RECEIVED, (id, body, ts) => { let nick = getDisplayName(id); if (!nick) { nick = `${ interfaceConfig.DEFAULT_REMOTE_DISPLAY_NAME} (${ id})`; } APP.API.notifyReceivedChatMessage({ id, nick, body, ts }); APP.UI.addMessage(id, nick, body, ts); } ); APP.UI.addListener(UIEvents.MESSAGE_CREATED, message => { APP.API.notifySendingChatMessage(message); room.sendTextMessage(message); }); } APP.UI.addListener(UIEvents.SELECTED_ENDPOINT, id => { APP.API.notifyOnStageParticipantChanged(id); try { // do not try to select participant if there is none (we // are alone in the room), otherwise an error will be // thrown cause reporting mechanism is not available // (datachannels currently) if (room.getParticipants().length === 0) { return; } room.selectParticipant(id); } catch (e) { sendAnalytics(createSelectParticipantFailedEvent(e)); reportError(e); } }); APP.UI.addListener( UIEvents.VIDEO_UNMUTING_WHILE_AUDIO_ONLY, () => this._displayAudioOnlyTooltip('videoMute')); } room.on(JitsiConferenceEvents.CONNECTION_INTERRUPTED, () => { APP.store.dispatch(localParticipantConnectionStatusChanged( JitsiParticipantConnectionStatus.INTERRUPTED)); APP.UI.showLocalConnectionInterrupted(true); }); room.on(JitsiConferenceEvents.CONNECTION_RESTORED, () => { APP.store.dispatch(localParticipantConnectionStatusChanged( JitsiParticipantConnectionStatus.ACTIVE)); APP.UI.showLocalConnectionInterrupted(false); }); room.on( JitsiConferenceEvents.DISPLAY_NAME_CHANGED, (id, displayName) => { const formattedDisplayName = displayName.substr(0, MAX_DISPLAY_NAME_LENGTH); APP.store.dispatch(participantUpdated({ id, name: formattedDisplayName })); APP.API.notifyDisplayNameChanged(id, { displayName: formattedDisplayName, formattedDisplayName: appendSuffix( formattedDisplayName || interfaceConfig.DEFAULT_REMOTE_DISPLAY_NAME) }); APP.UI.changeDisplayName(id, formattedDisplayName); } ); room.on( JitsiConferenceEvents.LOCK_STATE_CHANGED, (...args) => APP.store.dispatch(lockStateChanged(room, ...args))); APP.remoteControl.on(RemoteControlEvents.ACTIVE_CHANGED, isActive => { room.setLocalParticipantProperty( 'remoteControlSessionStatus', isActive ); APP.UI.setLocalRemoteControlActiveChanged(); }); /* eslint-disable max-params */ room.on( JitsiConferenceEvents.PARTICIPANT_PROPERTY_CHANGED, (participant, name, oldValue, newValue) => { switch (name) { case 'raisedHand': APP.store.dispatch(participantUpdated({ id: participant.getId(), raisedHand: newValue === 'true' })); break; case 'remoteControlSessionStatus': APP.UI.setRemoteControlActiveStatus( participant.getId(), newValue); break; default: // ignore } }); /* eslint-enable max-params */ room.on( JitsiConferenceEvents.RECORDER_STATE_CHANGED, (status, error) => { logger.log('Received recorder status change: ', status, error); APP.UI.updateRecordingState(status); } ); room.on(JitsiConferenceEvents.KICKED, () => { APP.UI.hideStats(); APP.UI.notifyKicked(); // FIXME close }); room.on(JitsiConferenceEvents.SUSPEND_DETECTED, () => { APP.store.dispatch(suspendDetected()); // 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); } // stop local video if (this.localVideo) { this.localVideo.dispose(); this.localVideo = null; } // stop local audio if (this.localAudio) { this.localAudio.dispose(); this.localAudio = null; } }); room.on( JitsiConferenceEvents.DTMF_SUPPORT_CHANGED, isDTMFSupported => { APP.UI.updateDTMFSupport(isDTMFSupported); } ); APP.UI.addListener(UIEvents.AUDIO_MUTED, muted => { this.muteAudio(muted); }); APP.UI.addListener(UIEvents.VIDEO_MUTED, muted => { if (this.isAudioOnly() && !muted) { this._displayAudioOnlyTooltip('videoMute'); } else { this.muteVideo(muted); } }); statsEmitter.startListeningForStats(room); room.addCommandListener(this.commands.defaults.ETHERPAD, ({ value }) => { APP.UI.initEtherpad(value); } ); APP.UI.addListener(UIEvents.EMAIL_CHANGED, this.changeLocalEmail); room.addCommandListener(this.commands.defaults.EMAIL, (data, from) => { APP.store.dispatch(participantUpdated({ id: from, email: data.value })); APP.UI.setUserEmail(from, data.value); }); room.addCommandListener( this.commands.defaults.AVATAR_URL, (data, from) => { APP.store.dispatch( participantUpdated({ id: from, avatarURL: data.value })); }); room.addCommandListener(this.commands.defaults.AVATAR_ID, (data, from) => { APP.store.dispatch( participantUpdated({ id: from, avatarID: 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, () => { (room.isStartAudioMuted() || room.isStartVideoMuted()) && APP.UI.notifyInitiallyMuted(); }); room.on( JitsiConferenceEvents.AVAILABLE_DEVICES_CHANGED, (id, devices) => { APP.UI.updateDevicesAvailability(id, devices); } ); 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); } }); }); /* eslint-disable max-params */ APP.UI.addListener( UIEvents.RESOLUTION_CHANGED, (id, oldResolution, newResolution, delay) => { sendAnalytics(createStreamSwitchDelayEvent( { 'old_resolution': oldResolution, 'new_resolution': newResolution, value: delay })); }); /* eslint-enable max-params */ // Starts or stops the recording for the conference. APP.UI.addListener(UIEvents.RECORDING_TOGGLED, options => { room.toggleRecording(options); }); APP.UI.addListener(UIEvents.SUBJECT_CHANGED, topic => { room.setSubject(topic); }); room.on(JitsiConferenceEvents.SUBJECT_CHANGED, subject => { APP.UI.setSubject(subject); }); 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')); 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 => { // if we are screen sharing we do not want to stop it if (this.isSharingScreen) { return Promise.resolve(); } return this.useVideoStream(stream); }) .then(() => { logger.log('switched local video device'); APP.settings.setCameraDeviceId(cameraDeviceId, true); }) .catch(err => { APP.UI.showCameraErrorNotification(err); }); } ); APP.UI.addListener( UIEvents.AUDIO_DEVICE_CHANGED, micDeviceId => { const audioWasMuted = this.isLocalAudioMuted(); sendAnalytics(createDeviceChangedEvent('audio', 'input')); createLocalTracksF({ devices: [ 'audio' ], cameraDeviceId: null, 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(stream => { this.useAudioStream(stream); logger.log('switched local audio device'); APP.settings.setMicDeviceId(micDeviceId, true); }) .catch(err => { APP.UI.showMicErrorNotification(err); }); } ); APP.UI.addListener( UIEvents.AUDIO_OUTPUT_DEVICE_CHANGED, audioOutputDeviceId => { sendAnalytics(createDeviceChangedEvent('audio', 'output')); APP.settings.setAudioOutputDeviceId(audioOutputDeviceId) .then(() => logger.log('changed audio output device')) .catch(err => { logger.warn('Failed to change audio output device. ' + 'Default or previously set audio output device ' + 'will be used instead.', 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. APP.UI.updateAllVideos(); }); APP.UI.addListener( UIEvents.TOGGLE_SCREENSHARING, this.toggleScreenSharing.bind(this) ); /* eslint-disable max-params */ APP.UI.addListener( UIEvents.UPDATE_SHARED_VIDEO, (url, state, time, isMuted, volume) => { /* eslint-enable max-params */ // send start and stop commands once, and remove any updates // that had left if (state === 'stop' || state === 'start' || state === 'playing') { room.removeCommand(this.commands.defaults.SHARED_VIDEO); room.sendCommandOnce(this.commands.defaults.SHARED_VIDEO, { value: url, attributes: { state, time, muted: isMuted, volume } }); } else { // in case of paused, in order to allow late users to join // paused room.removeCommand(this.commands.defaults.SHARED_VIDEO); room.sendCommand(this.commands.defaults.SHARED_VIDEO, { value: url, attributes: { state, time, muted: isMuted, volume } }); } APP.store.dispatch(setSharedVideoStatus(state)); }); room.addCommandListener( this.commands.defaults.SHARED_VIDEO, ({ value, attributes }, id) => { if (attributes.state === 'stop') { APP.UI.onSharedVideoStop(id, attributes); } else if (attributes.state === 'start') { APP.UI.onSharedVideoStart(id, value, attributes); } else if (attributes.state === 'playing' || attributes.state === 'pause') { APP.UI.onSharedVideoUpdate(id, value, attributes); } }); }, /** * Callback invoked when the conference has been successfully joined. * Initializes the UI and various other features. * * @private * @returns {void} */ _onConferenceJoined() { if (APP.logCollector) { // Start the LogCollector's periodic "store logs" task APP.logCollector.start(); APP.logCollectorStarted = true; // Make an attempt to flush in case a lot of logs have been // cached, before the collector was started. APP.logCollector.flush(); // This event listener will flush the logs, before // the statistics module (CallStats) is stopped. // // NOTE The LogCollector is not stopped, because this event can // be triggered multiple times during single conference // (whenever statistics module is stopped). That includes // the case when Jicofo terminates the single person left in the // room. It will then restart the media session when someone // eventually join the room which will start the stats again. APP.conference.addConferenceListener( JitsiConferenceEvents.BEFORE_STATISTICS_DISPOSED, () => { if (APP.logCollector) { APP.logCollector.flush(); } } ); } APP.UI.initConference(); APP.keyboardshortcut.init(); if (config.requireDisplayName && !APP.conference.getLocalDisplayName()) { APP.UI.promptDisplayName(); } APP.store.dispatch(conferenceJoined(room)); APP.UI.mucJoined(); const displayName = APP.settings.getDisplayName(); APP.API.notifyConferenceJoined( this.roomName, this._room.myUserId(), { displayName, formattedDisplayName: appendSuffix( displayName, interfaceConfig.DEFAULT_LOCAL_DISPLAY_NAME), avatarURL: getAvatarURLByParticipantId( APP.store.getState(), this._room.myUserId()) } ); APP.UI.markVideoInterrupted(false); }, /** * Adds any room listener. * @param {string} eventName one of the JitsiConferenceEvents * @param {Function} listener the function to be called when the event * occurs */ addConferenceListener(eventName, listener) { room.on(eventName, listener); }, /** * Removes any room listener. * @param {string} eventName one of the JitsiConferenceEvents * @param {Function} listener the listener to be removed. */ removeConferenceListener(eventName, listener) { room.off(eventName, listener); }, /** * Inits list of current devices and event listener for device change. * @private */ _initDeviceList() { JitsiMeetJS.mediaDevices.isDeviceListAvailable() .then(isDeviceListAvailable => { if (isDeviceListAvailable && JitsiMeetJS.mediaDevices.isDeviceChangeAvailable()) { JitsiMeetJS.mediaDevices.enumerateDevices(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. if (this.localAudio) { APP.settings.setMicDeviceId( this.localAudio.getDeviceId(), false); } if (this.localVideo) { APP.settings.setCameraDeviceId( this.localVideo.getDeviceId(), false); } mediaDeviceHelper.setCurrentMediaDevices(devices); APP.UI.onAvailableDevicesChanged(devices); APP.store.dispatch(updateDeviceList(devices)); }); this.deviceChangeListener = devices => window.setTimeout( () => this._onDeviceListChanged(devices), 0); JitsiMeetJS.mediaDevices.addEventListener( JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED, this.deviceChangeListener); } }) .catch(error => { logger.warn(`Error getting device list: ${error}`); }); }, /** * Event listener for JitsiMediaDevicesEvents.DEVICE_LIST_CHANGED to * handle change of available media devices. * @private * @param {MediaDeviceInfo[]} devices * @returns {Promise} */ _onDeviceListChanged(devices) { let currentDevices = mediaDeviceHelper.getCurrentMediaDevices(); // Event handler can be fired before direct // enumerateDevices() call, so handle this situation here. if (!currentDevices.audioinput && !currentDevices.videoinput && !currentDevices.audiooutput) { mediaDeviceHelper.setCurrentMediaDevices(devices); currentDevices = mediaDeviceHelper.getCurrentMediaDevices(); } const newDevices = mediaDeviceHelper.getNewMediaDevicesAfterDeviceListChanged( devices, this.isSharingScreen, this.localVideo, this.localAudio); const promises = []; const audioWasMuted = this.isLocalAudioMuted(); const videoWasMuted = this.isLocalVideoMuted(); if (typeof newDevices.audiooutput !== 'undefined') { // Just ignore any errors in catch block. promises.push(APP.settings .setAudioOutputDeviceId(newDevices.audiooutput) .catch()); } promises.push( mediaDeviceHelper.createLocalTracksAfterDeviceListChanged( createLocalTracksF, newDevices.videoinput, newDevices.audioinput) .then(tracks => Promise.all(this._setLocalAudioVideoStreams(tracks))) .then(() => { // If audio was muted before, or we unplugged current device // and selected new one, then mute new audio track. if (audioWasMuted) { sendAnalytics(createTrackMutedEvent( 'audio', 'device list changed')); logger.log('Audio mute: device list changed'); muteLocalAudio(true); } // If video was muted before, or we unplugged current device // and selected new one, then mute new video track. if (!this.isSharingScreen && videoWasMuted) { sendAnalytics(createTrackMutedEvent( 'video', 'device list changed')); logger.log('Video mute: device list changed'); muteLocalVideo(true); } })); return Promise.all(promises) .then(() => { mediaDeviceHelper.setCurrentMediaDevices(devices); APP.UI.onAvailableDevicesChanged(devices); }); }, /** * Determines whether or not the audio button should be enabled. */ updateAudioIconEnabled() { const audioMediaDevices = mediaDeviceHelper.getCurrentMediaDevices().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); logger.debug( `Microphone button enabled: ${available}`, `local audio: ${this.localAudio}`, `audio devices: ${audioMediaDevices}`, `device count: ${audioDeviceCount}`); APP.store.dispatch(setAudioAvailable(available)); APP.API.notifyAudioAvailabilityChanged(available); }, /** * Determines whether or not the video button should be enabled. */ updateVideoIconEnabled() { const videoMediaDevices = mediaDeviceHelper.getCurrentMediaDevices().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); logger.debug( `Camera button enabled: ${available}`, `local video: ${this.localVideo}`, `video devices: ${videoMediaDevices}`, `device count: ${videoDeviceCount}`); 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) { eventEmitter.emit(JitsiMeetConferenceEvents.BEFORE_HANGUP); APP.UI.removeLocalMedia(); 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); } // All promises are returning Promise.resolve to make Promise.all to // be resolved when both Promises are finished. Otherwise Promise.all // will reject on first rejected Promise and we can redirect the page // before all operations are done. Promise.all([ requestFeedbackPromise, room.leave().then(disconnect, disconnect) ]).then(values => { APP.API.notifyReadyToClose(); maybeRedirectToWelcomePage(values[0]); }); }, /** * 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({ id: localId, local: true, email: formattedEmail })); APP.settings.setEmail(formattedEmail); APP.UI.setUserEmail(localId, 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({ id, local: true, avatarURL: formattedUrl })); APP.settings.setAvatarUrl(url); 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 = nickname.trim().substr(0, MAX_DISPLAY_NAME_LENGTH); const { id, name } = getLocalParticipant(APP.store.getState()); if (formattedNickname === name) { return; } APP.store.dispatch(participantUpdated({ id, local: true, name: formattedNickname })); APP.settings.setDisplayName(formattedNickname); APP.API.notifyDisplayNameChanged(id, { displayName: formattedNickname, formattedDisplayName: appendSuffix( formattedNickname, interfaceConfig.DEFAULT_LOCAL_DISPLAY_NAME) }); if (room) { room.setDisplayName(formattedNickname); APP.UI.changeDisplayName(id, formattedNickname); } }, /** * Returns the desktop sharing source id or undefined if the desktop sharing * is not active at the moment. * * @returns {string|undefined} - The source id. If the track is not desktop * track or the source id is not available, undefined will be returned. */ getDesktopSharingSourceId() { return this.localVideo.sourceId; }, /** * Returns the desktop sharing source type or undefined if the desktop * sharing is not active at the moment. * * @returns {'screen'|'window'|undefined} - The source type. If the track is * not desktop track or the source type is not available, undefined will be * returned. */ getDesktopSharingSourceType() { return this.localVideo.sourceType; }, /** * Sets the video muted status. * * @param {boolean} muted - New muted status. */ setVideoMuteStatus(muted) { APP.UI.setVideoMuted(this.getMyUserId(), muted); APP.API.notifyVideoMutedStatusChanged(muted); }, /** * 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)); } } };