You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

UI.js 34KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214
  1. /* global APP, $, config, interfaceConfig */
  2. const logger = require('jitsi-meet-logger').getLogger(__filename);
  3. const UI = {};
  4. import Chat from './side_pannels/chat/Chat';
  5. import SidePanels from './side_pannels/SidePanels';
  6. import SideContainerToggler from './side_pannels/SideContainerToggler';
  7. import messageHandler from './util/MessageHandler';
  8. import UIUtil from './util/UIUtil';
  9. import UIEvents from '../../service/UI/UIEvents';
  10. import EtherpadManager from './etherpad/Etherpad';
  11. import SharedVideoManager from './shared_video/SharedVideo';
  12. import Recording from './recording/Recording';
  13. import VideoLayout from './videolayout/VideoLayout';
  14. import Filmstrip from './videolayout/Filmstrip';
  15. import Profile from './side_pannels/profile/Profile';
  16. import {
  17. openDeviceSelectionDialog
  18. } from '../../react/features/device-selection';
  19. import { updateDeviceList } from '../../react/features/base/devices';
  20. import { JitsiTrackErrors } from '../../react/features/base/lib-jitsi-meet';
  21. import {
  22. getLocalParticipant,
  23. participantPresenceChanged,
  24. showParticipantJoinedNotification
  25. } from '../../react/features/base/participants';
  26. import { destroyLocalTracks } from '../../react/features/base/tracks';
  27. import { openDisplayNamePrompt } from '../../react/features/display-name';
  28. import { setEtherpadHasInitialzied } from '../../react/features/etherpad';
  29. import {
  30. setNotificationsEnabled,
  31. showWarningNotification
  32. } from '../../react/features/notifications';
  33. import { shouldShowOnlyDeviceSelection } from '../../react/features/settings';
  34. import {
  35. dockToolbox,
  36. showToolbox
  37. } from '../../react/features/toolbox';
  38. const EventEmitter = require('events');
  39. UI.messageHandler = messageHandler;
  40. import FollowMe from '../FollowMe';
  41. const eventEmitter = new EventEmitter();
  42. UI.eventEmitter = eventEmitter;
  43. let etherpadManager;
  44. let sharedVideoManager;
  45. let followMeHandler;
  46. const JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP = {
  47. microphone: {},
  48. camera: {}
  49. };
  50. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  51. .camera[JitsiTrackErrors.UNSUPPORTED_RESOLUTION]
  52. = 'dialog.cameraUnsupportedResolutionError';
  53. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.camera[JitsiTrackErrors.GENERAL]
  54. = 'dialog.cameraUnknownError';
  55. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.camera[JitsiTrackErrors.PERMISSION_DENIED]
  56. = 'dialog.cameraPermissionDeniedError';
  57. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.camera[JitsiTrackErrors.NOT_FOUND]
  58. = 'dialog.cameraNotFoundError';
  59. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.camera[JitsiTrackErrors.CONSTRAINT_FAILED]
  60. = 'dialog.cameraConstraintFailedError';
  61. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  62. .camera[JitsiTrackErrors.NO_DATA_FROM_SOURCE]
  63. = 'dialog.cameraNotSendingData';
  64. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.microphone[JitsiTrackErrors.GENERAL]
  65. = 'dialog.micUnknownError';
  66. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  67. .microphone[JitsiTrackErrors.PERMISSION_DENIED]
  68. = 'dialog.micPermissionDeniedError';
  69. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.microphone[JitsiTrackErrors.NOT_FOUND]
  70. = 'dialog.micNotFoundError';
  71. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  72. .microphone[JitsiTrackErrors.CONSTRAINT_FAILED]
  73. = 'dialog.micConstraintFailedError';
  74. JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  75. .microphone[JitsiTrackErrors.NO_DATA_FROM_SOURCE]
  76. = 'dialog.micNotSendingData';
  77. const UIListeners = new Map([
  78. [
  79. UIEvents.ETHERPAD_CLICKED,
  80. () => etherpadManager && etherpadManager.toggleEtherpad()
  81. ], [
  82. UIEvents.SHARED_VIDEO_CLICKED,
  83. () => sharedVideoManager && sharedVideoManager.toggleSharedVideo()
  84. ], [
  85. UIEvents.TOGGLE_CHAT,
  86. () => UI.toggleChat()
  87. ], [
  88. UIEvents.TOGGLE_SETTINGS,
  89. () => {
  90. // Opening of device selection is special-cased as it is a dialog
  91. // opened through a button in settings and not directly displayed in
  92. // settings itself. As it is not useful to only have a settings menu
  93. // with a button to open a dialog, open the dialog directly instead.
  94. if (shouldShowOnlyDeviceSelection()) {
  95. APP.store.dispatch(openDeviceSelectionDialog());
  96. } else {
  97. UI.toggleSidePanel('settings_container');
  98. }
  99. }
  100. ], [
  101. UIEvents.TOGGLE_PROFILE,
  102. () => UI.toggleSidePanel('profile_container')
  103. ], [
  104. UIEvents.TOGGLE_FILMSTRIP,
  105. () => UI.handleToggleFilmstrip()
  106. ], [
  107. UIEvents.FOLLOW_ME_ENABLED,
  108. enabled => followMeHandler && followMeHandler.enableFollowMe(enabled)
  109. ]
  110. ]);
  111. /**
  112. * Indicates if we're currently in full screen mode.
  113. *
  114. * @return {boolean} {true} to indicate that we're currently in full screen
  115. * mode, {false} otherwise
  116. */
  117. UI.isFullScreen = function() {
  118. return UIUtil.isFullScreen();
  119. };
  120. /**
  121. * Returns true if the etherpad window is currently visible.
  122. * @returns {Boolean} - true if the etherpad window is currently visible.
  123. */
  124. UI.isEtherpadVisible = function() {
  125. return Boolean(etherpadManager && etherpadManager.isVisible());
  126. };
  127. /**
  128. * Returns true if there is a shared video which is being shown (?).
  129. * @returns {boolean} - true if there is a shared video which is being shown.
  130. */
  131. UI.isSharedVideoShown = function() {
  132. return Boolean(sharedVideoManager && sharedVideoManager.isSharedVideoShown);
  133. };
  134. /**
  135. * Notify user that server has shut down.
  136. */
  137. UI.notifyGracefulShutdown = function() {
  138. messageHandler.showError({
  139. descriptionKey: 'dialog.gracefulShutdown',
  140. titleKey: 'dialog.serviceUnavailable'
  141. });
  142. };
  143. /**
  144. * Notify user that reservation error happened.
  145. */
  146. UI.notifyReservationError = function(code, msg) {
  147. messageHandler.showError({
  148. descriptionArguments: {
  149. code,
  150. msg
  151. },
  152. descriptionKey: 'dialog.reservationErrorMsg',
  153. titleKey: 'dialog.reservationError'
  154. });
  155. };
  156. /**
  157. * Notify user that he has been kicked from the server.
  158. */
  159. UI.notifyKicked = function() {
  160. messageHandler.showError({
  161. hideErrorSupportLink: true,
  162. descriptionKey: 'dialog.kickMessage',
  163. titleKey: 'dialog.sessTerminated'
  164. });
  165. };
  166. /**
  167. * Notify user that conference was destroyed.
  168. * @param reason {string} the reason text
  169. */
  170. UI.notifyConferenceDestroyed = function(reason) {
  171. // FIXME: use Session Terminated from translation, but
  172. // 'reason' text comes from XMPP packet and is not translated
  173. messageHandler.showError({
  174. description: reason,
  175. titleKey: 'dialog.sessTerminated'
  176. });
  177. };
  178. /**
  179. * Show chat error.
  180. * @param err the Error
  181. * @param msg
  182. */
  183. UI.showChatError = function(err, msg) {
  184. if (!interfaceConfig.filmStripOnly) {
  185. Chat.chatAddError(err, msg);
  186. }
  187. };
  188. /**
  189. * Change nickname for the user.
  190. * @param {string} id user id
  191. * @param {string} displayName new nickname
  192. */
  193. UI.changeDisplayName = function(id, displayName) {
  194. VideoLayout.onDisplayNameChanged(id, displayName);
  195. if (APP.conference.isLocalId(id) || id === 'localVideoContainer') {
  196. Profile.changeDisplayName(displayName);
  197. Chat.setChatConversationMode(Boolean(displayName));
  198. }
  199. };
  200. /**
  201. * Shows/hides the indication about local connection being interrupted.
  202. *
  203. * @param {boolean} isInterrupted <tt>true</tt> if local connection is
  204. * currently in the interrupted state or <tt>false</tt> if the connection
  205. * is fine.
  206. */
  207. UI.showLocalConnectionInterrupted = function(isInterrupted) {
  208. VideoLayout.showLocalConnectionInterrupted(isInterrupted);
  209. };
  210. /**
  211. * Sets the "raised hand" status for a participant.
  212. *
  213. * @param {string} id - The id of the participant whose raised hand UI should
  214. * be updated.
  215. * @param {string} name - The name of the participant with the raised hand
  216. * update.
  217. * @param {boolean} raisedHandStatus - Whether the participant's hand is raised
  218. * or not.
  219. * @returns {void}
  220. */
  221. UI.setRaisedHandStatus = (id, name, raisedHandStatus) => {
  222. VideoLayout.setRaisedHandStatus(id, raisedHandStatus);
  223. if (raisedHandStatus) {
  224. messageHandler.participantNotification(
  225. name,
  226. 'notify.somebody',
  227. 'connected',
  228. 'notify.raisedHand');
  229. }
  230. };
  231. /**
  232. * Sets the local "raised hand" status.
  233. */
  234. UI.setLocalRaisedHandStatus
  235. = raisedHandStatus =>
  236. VideoLayout.setRaisedHandStatus(
  237. APP.conference.getMyUserId(),
  238. raisedHandStatus);
  239. /**
  240. * Initialize conference UI.
  241. */
  242. UI.initConference = function() {
  243. const { getState } = APP.store;
  244. const { email, id, name } = getLocalParticipant(getState);
  245. // Update default button states before showing the toolbar
  246. // if local role changes buttons state will be again updated.
  247. UI.updateLocalRole(APP.conference.isModerator);
  248. UI.showToolbar();
  249. const displayName = config.displayJids ? id : name;
  250. if (displayName) {
  251. UI.changeDisplayName('localVideoContainer', displayName);
  252. }
  253. // Make sure we configure our avatar id, before creating avatar for us
  254. if (email) {
  255. UI.setUserEmail(id, email);
  256. }
  257. // FollowMe attempts to copy certain aspects of the moderator's UI into the
  258. // other participants' UI. Consequently, it needs (1) read and write access
  259. // to the UI (depending on the moderator role of the local participant) and
  260. // (2) APP.conference as means of communication between the participants.
  261. followMeHandler = new FollowMe(APP.conference, UI);
  262. };
  263. UI.mucJoined = function() {
  264. VideoLayout.mucJoined();
  265. // Update local video now that a conference is joined a user ID should be
  266. // set.
  267. UI.changeDisplayName(
  268. 'localVideoContainer',
  269. APP.conference.getLocalDisplayName());
  270. };
  271. /** *
  272. * Handler for toggling filmstrip
  273. */
  274. UI.handleToggleFilmstrip = () => UI.toggleFilmstrip();
  275. /**
  276. * Returns the shared document manager object.
  277. * @return {EtherpadManager} the shared document manager object
  278. */
  279. UI.getSharedVideoManager = function() {
  280. return sharedVideoManager;
  281. };
  282. /**
  283. * Starts the UI module and initializes all related components.
  284. *
  285. * @returns {boolean} true if the UI is ready and the conference should be
  286. * established, false - otherwise (for example in the case of welcome page)
  287. */
  288. UI.start = function() {
  289. document.title = interfaceConfig.APP_NAME;
  290. // Set the defaults for prompt dialogs.
  291. $.prompt.setDefaults({ persistent: false });
  292. SideContainerToggler.init(eventEmitter);
  293. Filmstrip.init(eventEmitter);
  294. VideoLayout.init(eventEmitter);
  295. if (!interfaceConfig.filmStripOnly) {
  296. VideoLayout.initLargeVideo();
  297. }
  298. VideoLayout.resizeVideoArea(true, true);
  299. sharedVideoManager = new SharedVideoManager(eventEmitter);
  300. if (interfaceConfig.filmStripOnly) {
  301. $('body').addClass('filmstrip-only');
  302. Filmstrip.setFilmstripOnly();
  303. APP.store.dispatch(setNotificationsEnabled(false));
  304. } else {
  305. // Initialise the recording module.
  306. config.enableRecording
  307. && Recording.init(eventEmitter, config.recordingType);
  308. // Initialize side panels
  309. SidePanels.init(eventEmitter);
  310. // TODO: remove this class once the old toolbar has been removed. This
  311. // class is set so that any CSS changes needed to adjust elements
  312. // outside of the new toolbar can be scoped to just the app with the new
  313. // toolbar enabled.
  314. $('body').addClass('use-new-toolbox');
  315. }
  316. interfaceConfig.VERTICAL_FILMSTRIP
  317. && $('body').addClass('vertical-filmstrip');
  318. document.title = interfaceConfig.APP_NAME;
  319. };
  320. /**
  321. * Setup some UI event listeners.
  322. */
  323. UI.registerListeners
  324. = () => UIListeners.forEach((value, key) => UI.addListener(key, value));
  325. /**
  326. * Unregister some UI event listeners.
  327. */
  328. UI.unregisterListeners
  329. = () => UIListeners.forEach((value, key) => UI.removeListener(key, value));
  330. /**
  331. * Setup some DOM event listeners.
  332. */
  333. UI.bindEvents = () => {
  334. /**
  335. *
  336. */
  337. function onResize() {
  338. SideContainerToggler.resize();
  339. VideoLayout.resizeVideoArea();
  340. }
  341. // Resize and reposition videos in full screen mode.
  342. $(document).on(
  343. 'webkitfullscreenchange mozfullscreenchange fullscreenchange',
  344. onResize);
  345. $(window).resize(onResize);
  346. };
  347. /**
  348. * Unbind some DOM event listeners.
  349. */
  350. UI.unbindEvents = () => {
  351. $(document).off(
  352. 'webkitfullscreenchange mozfullscreenchange fullscreenchange');
  353. $(window).off('resize');
  354. };
  355. /**
  356. * Show local stream on UI.
  357. * @param {JitsiTrack} track stream to show
  358. */
  359. UI.addLocalStream = track => {
  360. switch (track.getType()) {
  361. case 'audio':
  362. // Local audio is not rendered so no further action is needed at this
  363. // point.
  364. break;
  365. case 'video':
  366. VideoLayout.changeLocalVideo(track);
  367. break;
  368. default:
  369. logger.error(`Unknown stream type: ${track.getType()}`);
  370. break;
  371. }
  372. };
  373. /**
  374. * Show remote stream on UI.
  375. * @param {JitsiTrack} track stream to show
  376. */
  377. UI.addRemoteStream = track => VideoLayout.onRemoteStreamAdded(track);
  378. /**
  379. * Removed remote stream from UI.
  380. * @param {JitsiTrack} track stream to remove
  381. */
  382. UI.removeRemoteStream = track => VideoLayout.onRemoteStreamRemoved(track);
  383. /**
  384. * Setup and show Etherpad.
  385. * @param {string} name etherpad id
  386. */
  387. UI.initEtherpad = name => {
  388. if (etherpadManager || !config.etherpad_base || !name) {
  389. return;
  390. }
  391. logger.log('Etherpad is enabled');
  392. etherpadManager
  393. = new EtherpadManager(config.etherpad_base, name, eventEmitter);
  394. APP.store.dispatch(setEtherpadHasInitialzied());
  395. };
  396. /**
  397. * Returns the shared document manager object.
  398. * @return {EtherpadManager} the shared document manager object
  399. */
  400. UI.getSharedDocumentManager = () => etherpadManager;
  401. /**
  402. * Show user on UI.
  403. * @param {JitsiParticipant} user
  404. */
  405. UI.addUser = function(user) {
  406. const id = user.getId();
  407. const displayName = user.getDisplayName();
  408. const status = user.getStatus();
  409. if (status) {
  410. // if user has initial status dispatch it
  411. // and skip 'connected' notifications
  412. APP.store.dispatch(participantPresenceChanged(id, status));
  413. // FIXME: move updateUserStatus in participantPresenceChanged action
  414. UI.updateUserStatus(user, status);
  415. } else {
  416. APP.store.dispatch(showParticipantJoinedNotification(displayName));
  417. }
  418. // Add Peer's container
  419. VideoLayout.addParticipantContainer(user);
  420. // Configure avatar
  421. UI.setUserEmail(id);
  422. // set initial display name
  423. if (displayName) {
  424. UI.changeDisplayName(id, displayName);
  425. }
  426. };
  427. /**
  428. * Remove user from UI.
  429. * @param {string} id user id
  430. * @param {string} displayName user nickname
  431. */
  432. UI.removeUser = function(id, displayName) {
  433. messageHandler.participantNotification(
  434. displayName, 'notify.somebody', 'disconnected', 'notify.disconnected');
  435. VideoLayout.removeParticipantContainer(id);
  436. };
  437. /**
  438. * Update videotype for specified user.
  439. * @param {string} id user id
  440. * @param {string} newVideoType new videotype
  441. */
  442. UI.onPeerVideoTypeChanged
  443. = (id, newVideoType) => VideoLayout.onVideoTypeChanged(id, newVideoType);
  444. /**
  445. * Update local user role and show notification if user is moderator.
  446. * @param {boolean} isModerator if local user is moderator or not
  447. */
  448. UI.updateLocalRole = isModerator => {
  449. VideoLayout.showModeratorIndicator();
  450. if (isModerator) {
  451. if (!interfaceConfig.DISABLE_FOCUS_INDICATOR) {
  452. messageHandler.participantNotification(
  453. null, 'notify.me', 'connected', 'notify.moderator');
  454. }
  455. Recording.checkAutoRecord();
  456. }
  457. };
  458. /**
  459. * Check the role for the user and reflect it in the UI, moderator ui indication
  460. * and notifies user who is the moderator
  461. * @param user to check for moderator
  462. */
  463. UI.updateUserRole = user => {
  464. VideoLayout.showModeratorIndicator();
  465. // We don't need to show moderator notifications when the focus (moderator)
  466. // indicator is disabled.
  467. if (!user.isModerator() || interfaceConfig.DISABLE_FOCUS_INDICATOR) {
  468. return;
  469. }
  470. const displayName = user.getDisplayName();
  471. if (displayName) {
  472. messageHandler.participantNotification(
  473. displayName,
  474. 'notify.somebody',
  475. 'connected',
  476. 'notify.grantedTo',
  477. { to: UIUtil.escapeHtml(displayName) });
  478. } else {
  479. messageHandler.participantNotification(
  480. '',
  481. 'notify.somebody',
  482. 'connected',
  483. 'notify.grantedToUnknown');
  484. }
  485. };
  486. /**
  487. * Updates the user status.
  488. *
  489. * @param {JitsiParticipant} user - The user which status we need to update.
  490. * @param {string} status - The new status.
  491. */
  492. UI.updateUserStatus = (user, status) => {
  493. if (!status) {
  494. return;
  495. }
  496. const displayName = user.getDisplayName();
  497. messageHandler.participantNotification(
  498. displayName,
  499. '',
  500. 'connected',
  501. 'dialOut.statusMessage',
  502. { status: UIUtil.escapeHtml(status) });
  503. };
  504. /**
  505. * Toggles smileys in the chat.
  506. */
  507. UI.toggleSmileys = () => Chat.toggleSmileys();
  508. /**
  509. * Toggles filmstrip.
  510. */
  511. UI.toggleFilmstrip = function() {
  512. // eslint-disable-next-line prefer-rest-params
  513. Filmstrip.toggleFilmstrip(...arguments);
  514. VideoLayout.resizeVideoArea(true, false);
  515. };
  516. /**
  517. * Checks if the filmstrip is currently visible or not.
  518. * @returns {true} if the filmstrip is currently visible, and false otherwise.
  519. */
  520. UI.isFilmstripVisible = () => Filmstrip.isFilmstripVisible();
  521. /**
  522. * @returns {true} if the chat panel is currently visible, and false otherwise.
  523. */
  524. UI.isChatVisible = () => Chat.isVisible();
  525. /**
  526. * Toggles chat panel.
  527. */
  528. UI.toggleChat = () => UI.toggleSidePanel('chat_container');
  529. /**
  530. * Toggles the given side panel.
  531. *
  532. * @param {String} sidePanelId the identifier of the side panel to toggle
  533. */
  534. UI.toggleSidePanel = sidePanelId => SideContainerToggler.toggle(sidePanelId);
  535. /**
  536. * Handle new user display name.
  537. */
  538. UI.inputDisplayNameHandler = function(newDisplayName) {
  539. eventEmitter.emit(UIEvents.NICKNAME_CHANGED, newDisplayName);
  540. };
  541. /**
  542. * Return the type of the remote video.
  543. * @param jid the jid for the remote video
  544. * @returns the video type video or screen.
  545. */
  546. UI.getRemoteVideoType = function(jid) {
  547. return VideoLayout.getRemoteVideoType(jid);
  548. };
  549. // FIXME check if someone user this
  550. UI.showLoginPopup = function(callback) {
  551. logger.log('password is required');
  552. const message
  553. = `<input name="username" type="text"
  554. placeholder="user@domain.net"
  555. class="input-control" autofocus>
  556. <input name="password" type="password"
  557. data-i18n="[placeholder]dialog.userPassword"
  558. class="input-control"
  559. placeholder="user password">`
  560. ;
  561. // eslint-disable-next-line max-params
  562. const submitFunction = (e, v, m, f) => {
  563. if (v && f.username && f.password) {
  564. callback(f.username, f.password);
  565. }
  566. };
  567. messageHandler.openTwoButtonDialog({
  568. titleKey: 'dialog.passwordRequired',
  569. msgString: message,
  570. leftButtonKey: 'dialog.Ok',
  571. submitFunction,
  572. focus: ':input:first'
  573. });
  574. };
  575. UI.askForNickname = function() {
  576. // eslint-disable-next-line no-alert
  577. return window.prompt('Your nickname (optional)');
  578. };
  579. /**
  580. * Sets muted audio state for participant
  581. */
  582. UI.setAudioMuted = function(id, muted) {
  583. VideoLayout.onAudioMute(id, muted);
  584. if (APP.conference.isLocalId(id)) {
  585. APP.conference.updateAudioIconEnabled();
  586. }
  587. };
  588. /**
  589. * Sets muted video state for participant
  590. */
  591. UI.setVideoMuted = function(id, muted) {
  592. VideoLayout.onVideoMute(id, muted);
  593. if (APP.conference.isLocalId(id)) {
  594. APP.conference.updateVideoIconEnabled();
  595. }
  596. };
  597. /**
  598. * Triggers an update of remote video and large video displays so they may pick
  599. * up any state changes that have occurred elsewhere.
  600. *
  601. * @returns {void}
  602. */
  603. UI.updateAllVideos = () => VideoLayout.updateAllVideos();
  604. /**
  605. * Adds a listener that would be notified on the given type of event.
  606. *
  607. * @param type the type of the event we're listening for
  608. * @param listener a function that would be called when notified
  609. */
  610. UI.addListener = function(type, listener) {
  611. eventEmitter.on(type, listener);
  612. };
  613. /**
  614. * Removes the given listener for the given type of event.
  615. *
  616. * @param type the type of the event we're listening for
  617. * @param listener the listener we want to remove
  618. */
  619. UI.removeListener = function(type, listener) {
  620. eventEmitter.removeListener(type, listener);
  621. };
  622. /**
  623. * Emits the event of given type by specifying the parameters in options.
  624. *
  625. * @param type the type of the event we're emitting
  626. * @param options the parameters for the event
  627. */
  628. UI.emitEvent = (type, ...options) => eventEmitter.emit(type, ...options);
  629. UI.clickOnVideo = function(videoNumber) {
  630. const videos = $('#remoteVideos .videocontainer:not(#mixedstream)');
  631. const videosLength = videos.length;
  632. if (videosLength <= videoNumber) {
  633. return;
  634. }
  635. const videoIndex = videoNumber === 0 ? 0 : videosLength - videoNumber;
  636. videos[videoIndex].click();
  637. };
  638. // Used by torture.
  639. UI.showToolbar = timeout => APP.store.dispatch(showToolbox(timeout));
  640. // Used by torture.
  641. UI.dockToolbar = dock => APP.store.dispatch(dockToolbox(dock));
  642. /**
  643. * Update user email.
  644. * @param {string} id user id
  645. * @param {string} email user email
  646. */
  647. UI.setUserEmail = function(id, email) {
  648. if (APP.conference.isLocalId(id)) {
  649. Profile.changeEmail(email);
  650. }
  651. };
  652. /**
  653. * Updates the displayed avatar for participant.
  654. *
  655. * @param {string} id - User id whose avatar should be updated.
  656. * @param {string} avatarURL - The URL to avatar image to display.
  657. * @returns {void}
  658. */
  659. UI.refreshAvatarDisplay = function(id, avatarURL) {
  660. VideoLayout.changeUserAvatar(id, avatarURL);
  661. };
  662. /**
  663. * Notify user that connection failed.
  664. * @param {string} stropheErrorMsg raw Strophe error message
  665. */
  666. UI.notifyConnectionFailed = function(stropheErrorMsg) {
  667. let descriptionKey;
  668. let descriptionArguments;
  669. if (stropheErrorMsg) {
  670. descriptionKey = 'dialog.connectErrorWithMsg';
  671. descriptionArguments = { msg: stropheErrorMsg };
  672. } else {
  673. descriptionKey = 'dialog.connectError';
  674. }
  675. messageHandler.showError({
  676. descriptionArguments,
  677. descriptionKey,
  678. titleKey: 'connection.CONNFAIL'
  679. });
  680. };
  681. /**
  682. * Notify user that maximum users limit has been reached.
  683. */
  684. UI.notifyMaxUsersLimitReached = function() {
  685. messageHandler.showError({
  686. hideErrorSupportLink: true,
  687. descriptionKey: 'dialog.maxUsersLimitReached',
  688. titleKey: 'dialog.maxUsersLimitReachedTitle'
  689. });
  690. };
  691. /**
  692. * Notify user that he was automatically muted when joned the conference.
  693. */
  694. UI.notifyInitiallyMuted = function() {
  695. messageHandler.participantNotification(
  696. null,
  697. 'notify.mutedTitle',
  698. 'connected',
  699. 'notify.muted',
  700. null);
  701. };
  702. /**
  703. * Mark user as dominant speaker.
  704. * @param {string} id user id
  705. */
  706. UI.markDominantSpeaker = function(id) {
  707. VideoLayout.onDominantSpeakerChanged(id);
  708. };
  709. UI.handleLastNEndpoints = function(leavingIds, enteringIds) {
  710. VideoLayout.onLastNEndpointsChanged(leavingIds, enteringIds);
  711. };
  712. /**
  713. * Will handle notification about participant's connectivity status change.
  714. *
  715. * @param {string} id the id of remote participant(MUC jid)
  716. */
  717. UI.participantConnectionStatusChanged = function(id) {
  718. VideoLayout.onParticipantConnectionStatusChanged(id);
  719. };
  720. /**
  721. * Prompt user for nickname.
  722. */
  723. UI.promptDisplayName = () => {
  724. APP.store.dispatch(openDisplayNamePrompt());
  725. };
  726. /**
  727. * Update audio level visualization for specified user.
  728. * @param {string} id user id
  729. * @param {number} lvl audio level
  730. */
  731. UI.setAudioLevel = (id, lvl) => VideoLayout.setAudioLevel(id, lvl);
  732. /**
  733. * Hide connection quality statistics from UI.
  734. */
  735. UI.hideStats = function() {
  736. VideoLayout.hideStats();
  737. };
  738. /**
  739. * Mark video as interrupted or not.
  740. * @param {boolean} interrupted if video is interrupted
  741. */
  742. UI.markVideoInterrupted = function(interrupted) {
  743. if (interrupted) {
  744. VideoLayout.onVideoInterrupted();
  745. } else {
  746. VideoLayout.onVideoRestored();
  747. }
  748. };
  749. /**
  750. * Add chat message.
  751. * @param {string} from user id
  752. * @param {string} displayName user nickname
  753. * @param {string} message message text
  754. * @param {number} stamp timestamp when message was created
  755. */
  756. // eslint-disable-next-line max-params
  757. UI.addMessage = function(from, displayName, message, stamp) {
  758. Chat.updateChatConversation(from, displayName, message, stamp);
  759. };
  760. UI.updateRecordingState = function(state) {
  761. Recording.updateRecordingState(state);
  762. };
  763. UI.notifyTokenAuthFailed = function() {
  764. messageHandler.showError({
  765. descriptionKey: 'dialog.tokenAuthFailed',
  766. titleKey: 'dialog.tokenAuthFailedTitle'
  767. });
  768. };
  769. UI.notifyInternalError = function(error) {
  770. messageHandler.showError({
  771. descriptionArguments: { error },
  772. descriptionKey: 'dialog.internalError',
  773. titleKey: 'dialog.internalErrorTitle'
  774. });
  775. };
  776. UI.notifyFocusDisconnected = function(focus, retrySec) {
  777. messageHandler.participantNotification(
  778. null, 'notify.focus',
  779. 'disconnected', 'notify.focusFail',
  780. { component: focus,
  781. ms: retrySec }
  782. );
  783. };
  784. /**
  785. * Updates auth info on the UI.
  786. * @param {boolean} isAuthEnabled if authentication is enabled
  787. * @param {string} [login] current login
  788. */
  789. UI.updateAuthInfo = function(isAuthEnabled, login) {
  790. const showAuth = isAuthEnabled && UIUtil.isAuthenticationEnabled();
  791. const loggedIn = Boolean(login);
  792. Profile.showAuthenticationButtons(showAuth);
  793. if (showAuth) {
  794. Profile.setAuthenticatedIdentity(login);
  795. Profile.showLoginButton(!loggedIn);
  796. Profile.showLogoutButton(loggedIn);
  797. }
  798. };
  799. /**
  800. * Notifies interested listeners that the raise hand property has changed.
  801. *
  802. * @param {boolean} isRaisedHand indicates the current state of the
  803. * "raised hand"
  804. */
  805. UI.onLocalRaiseHandChanged = function(isRaisedHand) {
  806. eventEmitter.emit(UIEvents.LOCAL_RAISE_HAND_CHANGED, isRaisedHand);
  807. };
  808. /**
  809. * Update list of available physical devices.
  810. * @param {object[]} devices new list of available devices
  811. */
  812. UI.onAvailableDevicesChanged = function(devices) {
  813. APP.store.dispatch(updateDeviceList(devices));
  814. APP.conference.updateAudioIconEnabled();
  815. APP.conference.updateVideoIconEnabled();
  816. };
  817. /**
  818. * Returns the id of the current video shown on large.
  819. * Currently used by tests (torture).
  820. */
  821. UI.getLargeVideoID = function() {
  822. return VideoLayout.getLargeVideoID();
  823. };
  824. /**
  825. * Returns the current video shown on large.
  826. * Currently used by tests (torture).
  827. */
  828. UI.getLargeVideo = function() {
  829. return VideoLayout.getLargeVideo();
  830. };
  831. /**
  832. * Returns whether or not the passed in user id is currently pinned to the large
  833. * video.
  834. *
  835. * @param {string} userId - The id of the user to check is pinned or not.
  836. * @returns {boolean} True if the user is currently pinned to the large video.
  837. */
  838. UI.isPinned = userId => VideoLayout.getPinnedId() === userId;
  839. /**
  840. * Shows "Please go to chrome webstore to install the desktop sharing extension"
  841. * 2 button dialog with buttons - cancel and go to web store.
  842. * @param url {string} the url of the extension.
  843. */
  844. UI.showExtensionExternalInstallationDialog = function(url) {
  845. let openedWindow = null;
  846. const submitFunction = function(e, v) {
  847. if (v) {
  848. e.preventDefault();
  849. if (openedWindow === null || openedWindow.closed) {
  850. openedWindow
  851. = window.open(
  852. url,
  853. 'extension_store_window',
  854. 'resizable,scrollbars=yes,status=1');
  855. } else {
  856. openedWindow.focus();
  857. }
  858. }
  859. };
  860. const closeFunction = function(e, v) {
  861. if (openedWindow) {
  862. // Ideally we would close the popup, but this does not seem to work
  863. // on Chrome. Leaving it uncommented in case it could work
  864. // in some version.
  865. openedWindow.close();
  866. openedWindow = null;
  867. }
  868. if (!v) {
  869. eventEmitter.emit(UIEvents.EXTERNAL_INSTALLATION_CANCELED);
  870. }
  871. };
  872. messageHandler.openTwoButtonDialog({
  873. titleKey: 'dialog.externalInstallationTitle',
  874. msgKey: 'dialog.externalInstallationMsg',
  875. leftButtonKey: 'dialog.goToStore',
  876. submitFunction,
  877. loadedFunction: $.noop,
  878. closeFunction
  879. });
  880. };
  881. /**
  882. * Shows a dialog which asks user to install the extension. This one is
  883. * displayed after installation is triggered from the script, but fails because
  884. * it must be initiated by user gesture.
  885. * @param callback {function} function to be executed after user clicks
  886. * the install button - it should make another attempt to install the extension.
  887. */
  888. UI.showExtensionInlineInstallationDialog = function(callback) {
  889. const submitFunction = function(e, v) {
  890. if (v) {
  891. callback();
  892. }
  893. };
  894. const closeFunction = function(e, v) {
  895. if (!v) {
  896. eventEmitter.emit(UIEvents.EXTERNAL_INSTALLATION_CANCELED);
  897. }
  898. };
  899. messageHandler.openTwoButtonDialog({
  900. titleKey: 'dialog.externalInstallationTitle',
  901. msgKey: 'dialog.inlineInstallationMsg',
  902. leftButtonKey: 'dialog.inlineInstallExtension',
  903. submitFunction,
  904. loadedFunction: $.noop,
  905. closeFunction
  906. });
  907. };
  908. /**
  909. * Shows a notifications about the passed in microphone error.
  910. *
  911. * @param {JitsiTrackError} micError - An error object related to using or
  912. * acquiring an audio stream.
  913. * @returns {void}
  914. */
  915. UI.showMicErrorNotification = function(micError) {
  916. if (!micError) {
  917. return;
  918. }
  919. const { message, name } = micError;
  920. const micJitsiTrackErrorMsg
  921. = JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.microphone[name];
  922. const micErrorMsg = micJitsiTrackErrorMsg
  923. || JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  924. .microphone[JitsiTrackErrors.GENERAL];
  925. const additionalMicErrorMsg = micJitsiTrackErrorMsg ? null : message;
  926. APP.store.dispatch(showWarningNotification({
  927. description: additionalMicErrorMsg,
  928. descriptionKey: micErrorMsg,
  929. titleKey: name === JitsiTrackErrors.PERMISSION_DENIED
  930. ? 'deviceError.microphonePermission'
  931. : 'deviceError.microphoneError'
  932. }));
  933. };
  934. /**
  935. * Shows a notifications about the passed in camera error.
  936. *
  937. * @param {JitsiTrackError} cameraError - An error object related to using or
  938. * acquiring a video stream.
  939. * @returns {void}
  940. */
  941. UI.showCameraErrorNotification = function(cameraError) {
  942. if (!cameraError) {
  943. return;
  944. }
  945. const { message, name } = cameraError;
  946. const cameraJitsiTrackErrorMsg
  947. = JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP.camera[name];
  948. const cameraErrorMsg = cameraJitsiTrackErrorMsg
  949. || JITSI_TRACK_ERROR_TO_MESSAGE_KEY_MAP
  950. .camera[JitsiTrackErrors.GENERAL];
  951. const additionalCameraErrorMsg = cameraJitsiTrackErrorMsg ? null : message;
  952. APP.store.dispatch(showWarningNotification({
  953. description: additionalCameraErrorMsg,
  954. descriptionKey: cameraErrorMsg,
  955. titleKey: name === JitsiTrackErrors.PERMISSION_DENIED
  956. ? 'deviceError.cameraPermission' : 'deviceError.cameraError'
  957. }));
  958. };
  959. /**
  960. * Shows error dialog that informs the user that no data is received from the
  961. * device.
  962. *
  963. * @param {boolean} isAudioTrack - Whether or not the dialog is for an audio
  964. * track error.
  965. * @returns {void}
  966. */
  967. UI.showTrackNotWorkingDialog = function(isAudioTrack) {
  968. messageHandler.showError({
  969. descriptionKey: isAudioTrack
  970. ? 'dialog.micNotSendingData' : 'dialog.cameraNotSendingData',
  971. titleKey: isAudioTrack
  972. ? 'dialog.micNotSendingDataTitle'
  973. : 'dialog.cameraNotSendingDataTitle'
  974. });
  975. };
  976. UI.updateDevicesAvailability = function(id, devices) {
  977. VideoLayout.setDeviceAvailabilityIcons(id, devices);
  978. };
  979. /**
  980. * Show shared video.
  981. * @param {string} id the id of the sender of the command
  982. * @param {string} url video url
  983. * @param {string} attributes
  984. */
  985. UI.onSharedVideoStart = function(id, url, attributes) {
  986. if (sharedVideoManager) {
  987. sharedVideoManager.onSharedVideoStart(id, url, attributes);
  988. }
  989. };
  990. /**
  991. * Update shared video.
  992. * @param {string} id the id of the sender of the command
  993. * @param {string} url video url
  994. * @param {string} attributes
  995. */
  996. UI.onSharedVideoUpdate = function(id, url, attributes) {
  997. if (sharedVideoManager) {
  998. sharedVideoManager.onSharedVideoUpdate(id, url, attributes);
  999. }
  1000. };
  1001. /**
  1002. * Stop showing shared video.
  1003. * @param {string} id the id of the sender of the command
  1004. * @param {string} attributes
  1005. */
  1006. UI.onSharedVideoStop = function(id, attributes) {
  1007. if (sharedVideoManager) {
  1008. sharedVideoManager.onSharedVideoStop(id, attributes);
  1009. }
  1010. };
  1011. /**
  1012. * Handles user's features changes.
  1013. */
  1014. UI.onUserFeaturesChanged = user => VideoLayout.onUserFeaturesChanged(user);
  1015. /**
  1016. * Returns the number of known remote videos.
  1017. *
  1018. * @returns {number} The number of remote videos.
  1019. */
  1020. UI.getRemoteVideosCount = () => VideoLayout.getRemoteVideosCount();
  1021. /**
  1022. * Sets the remote control active status for a remote participant.
  1023. *
  1024. * @param {string} participantID - The id of the remote participant.
  1025. * @param {boolean} isActive - The new remote control active status.
  1026. * @returns {void}
  1027. */
  1028. UI.setRemoteControlActiveStatus = function(participantID, isActive) {
  1029. VideoLayout.setRemoteControlActiveStatus(participantID, isActive);
  1030. };
  1031. /**
  1032. * Sets the remote control active status for the local participant.
  1033. *
  1034. * @returns {void}
  1035. */
  1036. UI.setLocalRemoteControlActiveChanged = function() {
  1037. VideoLayout.setLocalRemoteControlActiveChanged();
  1038. };
  1039. /**
  1040. * Remove media tracks and UI elements so the user no longer sees media in the
  1041. * UI. The intent is to provide a feeling that the meeting has ended.
  1042. *
  1043. * @returns {void}
  1044. */
  1045. UI.removeLocalMedia = function() {
  1046. APP.store.dispatch(destroyLocalTracks());
  1047. VideoLayout.resetLargeVideo();
  1048. $('#videospace').hide();
  1049. };
  1050. // TODO: Export every function separately. For now there is no point of doing
  1051. // this because we are importing everything.
  1052. export default UI;