/* global $, APP, JitsiMeetJS, interfaceConfig */ import UIEvents from "../../../service/UI/UIEvents"; import UIUtil from "../util/UIUtil"; const FilmStrip = { /** * * @param eventEmitter the {EventEmitter} through which {FilmStrip} is to * emit/fire {UIEvents} (such as {UIEvents.TOGGLED_FILM_STRIP}). */ init (eventEmitter) { this.iconMenuDownClassName = 'icon-menu-down'; this.iconMenuUpClassName = 'icon-menu-up'; this.filmStripContainerClassName = 'filmstrip'; this.filmStrip = $('#remoteVideos'); this.eventEmitter = eventEmitter; this._initFilmStripToolbar(); this.registerListeners(); }, /** * Initializes the filmstrip toolbar */ _initFilmStripToolbar() { let toolbar = this._generateFilmStripToolbar(); let className = this.filmStripContainerClassName; let container = document.querySelector(`.${className}`); UIUtil.prependChild(container, toolbar); let iconSelector = '#hideVideoToolbar i'; this.toggleFilmStripIcon = document.querySelector(iconSelector); }, /** * Generates HTML layout for filmstrip toolbar * @returns {HTMLElement} * @private */ _generateFilmStripToolbar() { let container = document.createElement('div'); let isVisible = this.isFilmStripVisible(); container.className = 'filmstrip__toolbar'; container.innerHTML = ` `; return container; }, /** * Attach 'click' listener to "hide filmstrip" button */ registerListeners() { // Important: // Firing the event instead of executing toggleFilmstrip method because // it's important to hide the filmstrip by UI.toggleFilmstrip in order // to correctly resize the video area. $('#hideVideoToolbar').on('click', () => this.eventEmitter.emit(UIEvents.TOGGLE_FILM_STRIP)); this._registerToggleFilmstripShortcut(); }, /** * Registering toggle filmstrip shortcut * @private */ _registerToggleFilmstripShortcut() { let shortcut = 'F'; let shortcutAttr = 'filmstripPopover'; let description = 'keyboardShortcuts.toggleFilmstrip'; // Important: // Firing the event instead of executing toggleFilmstrip method because // it's important to hide the filmstrip by UI.toggleFilmstrip in order // to correctly resize the video area. let handler = () => this.eventEmitter.emit(UIEvents.TOGGLE_FILM_STRIP); APP.keyboardshortcut.registerShortcut( shortcut, shortcutAttr, handler, description ); }, /** * Changes classes of icon for showing down state */ showMenuDownIcon() { let icon = this.toggleFilmStripIcon; icon.classList.add(this.iconMenuDownClassName); icon.classList.remove(this.iconMenuUpClassName); }, /** * Changes classes of icon for showing up state */ showMenuUpIcon() { let icon = this.toggleFilmStripIcon; icon.classList.add(this.iconMenuUpClassName); icon.classList.remove(this.iconMenuDownClassName); }, /** * Toggles the visibility of the film strip. * * @param visible optional {Boolean} which specifies the desired visibility * of the film strip. If not specified, the visibility will be flipped * (i.e. toggled); otherwise, the visibility will be set to the specified * value. * * Note: * This method shouldn't be executed directly to hide the filmstrip. * It's important to hide the filmstrip with UI.toggleFilmstrip in order * to correctly resize the video area. */ toggleFilmStrip(visible) { let isVisibleDefined = typeof visible === 'boolean'; if (!isVisibleDefined) { visible = this.isFilmStripVisible(); } else if (this.isFilmStripVisible() === visible) { return; } JitsiMeetJS.analytics.sendEvent('toolbar.filmstrip.toggled'); this.filmStrip.toggleClass("hidden"); if (!visible) { this.showMenuDownIcon(); } else { this.showMenuUpIcon(); } // Emit/fire UIEvents.TOGGLED_FILM_STRIP. var eventEmitter = this.eventEmitter; if (eventEmitter) { eventEmitter.emit( UIEvents.TOGGLED_FILM_STRIP, this.isFilmStripVisible()); } }, /** * Shows if filmstrip is visible * @returns {boolean} */ isFilmStripVisible() { return !this.filmStrip.hasClass('hidden'); }, setupFilmStripOnly() { this.filmStrip.css({ padding: "0px 0px 18px 0px", right: 0 }); }, /** * Returns the height of filmstrip * @returns {number} height */ getFilmStripHeight() { if (this.isFilmStripVisible()) { return $(`.${this.filmStripContainerClassName}`).outerHeight(); } else { return 0; } }, /** * Returns the width of filmstip * @returns {number} width */ getFilmStripWidth() { return this.filmStrip.innerWidth() - parseInt(this.filmStrip.css('paddingLeft'), 10) - parseInt(this.filmStrip.css('paddingRight'), 10); }, /** * Calculates the size for thumbnails: local and remote one * @returns {*|{localVideo, remoteVideo}} */ calculateThumbnailSize() { let availableSizes = this.calculateAvailableSize(); let width = availableSizes.availableWidth; let height = availableSizes.availableHeight; return this.calculateThumbnailSizeFromAvailable(width, height); }, /** * Calculates available size for one thumbnail according to * the current window size. * * @returns {{availableWidth: number, availableHeight: number}} */ calculateAvailableSize() { let availableHeight = interfaceConfig.FILM_STRIP_MAX_HEIGHT; let thumbs = this.getThumbs(true); let numvids = thumbs.remoteThumbs.length; let localVideoContainer = $("#localVideoContainer"); /** * If the videoAreaAvailableWidth is set we use this one to calculate * the filmStrip width, because we're probably in a state where the * film strip size hasn't been updated yet, but it will be. */ let videoAreaAvailableWidth = UIUtil.getAvailableVideoWidth() - this._getFilmstripExtraPanelsWidth() - UIUtil.parseCssInt(this.filmStrip.css('right'), 10) - UIUtil.parseCssInt(this.filmStrip.css('paddingLeft'), 10) - UIUtil.parseCssInt(this.filmStrip.css('paddingRight'), 10) - UIUtil.parseCssInt(this.filmStrip.css('borderLeftWidth'), 10) - UIUtil.parseCssInt(this.filmStrip.css('borderRightWidth'), 10) - 5; let availableWidth = videoAreaAvailableWidth; // If local thumb is not hidden if(thumbs.localThumb) { availableWidth = Math.floor( (videoAreaAvailableWidth - ( UIUtil.parseCssInt( localVideoContainer.css('borderLeftWidth'), 10) + UIUtil.parseCssInt( localVideoContainer.css('borderRightWidth'), 10) + UIUtil.parseCssInt( localVideoContainer.css('paddingLeft'), 10) + UIUtil.parseCssInt( localVideoContainer.css('paddingRight'), 10) + UIUtil.parseCssInt( localVideoContainer.css('marginLeft'), 10) + UIUtil.parseCssInt( localVideoContainer.css('marginRight'), 10))) ); } // If the number of videos is 0 or undefined we don't need to calculate // further. if (numvids) { let remoteVideoContainer = thumbs.remoteThumbs.eq(0); availableWidth = Math.floor( (videoAreaAvailableWidth - numvids * ( UIUtil.parseCssInt( remoteVideoContainer.css('borderLeftWidth'), 10) + UIUtil.parseCssInt( remoteVideoContainer.css('borderRightWidth'), 10) + UIUtil.parseCssInt( remoteVideoContainer.css('paddingLeft'), 10) + UIUtil.parseCssInt( remoteVideoContainer.css('paddingRight'), 10) + UIUtil.parseCssInt( remoteVideoContainer.css('marginLeft'), 10) + UIUtil.parseCssInt( remoteVideoContainer.css('marginRight'), 10))) ); } let maxHeight // If the MAX_HEIGHT property hasn't been specified // we have the static value. = Math.min(interfaceConfig.FILM_STRIP_MAX_HEIGHT || 120, availableHeight); availableHeight = Math.min(maxHeight, window.innerHeight - 18); return { availableWidth, availableHeight }; }, /** * Traverse all elements inside the filmstrip * and calculates the sum of all of them except * remote videos element. Used for calculation of * available width for video thumbnails. * * @returns {number} calculated width * @private */ _getFilmstripExtraPanelsWidth() { let className = this.filmStripContainerClassName; let width = 0; $(`.${className}`) .children() .each(function () { if (this.id !== 'remoteVideos') { width += $(this).outerWidth(); } }); return width; }, /** Calculate the thumbnail size in order to fit all the thumnails in passed * dimensions. * NOTE: Here we assume that the remote and local thumbnails are with the * same height. * @param {int} availableWidth the maximum width for all thumbnails * @param {int} availableHeight the maximum height for all thumbnails * @returns {{localVideo, remoteVideo}} */ calculateThumbnailSizeFromAvailable(availableWidth, availableHeight) { /** * Let: * lW - width of the local thumbnail * rW - width of the remote thumbnail * h - the height of the thumbnails * remoteRatio - width:height for the remote thumbnail * localRatio - width:height for the local thumbnail * numberRemoteThumbs - number of remote thumbnails (we have only one * local thumbnail) * * Since the height for local thumbnail = height for remote thumbnail * and we know the ratio (width:height) for the local and for the * remote thumbnail we can find rW/lW: * rW / remoteRatio = lW / localRatio then - * remoteLocalWidthRatio = rW / lW = remoteRatio / localRatio * and rW = lW * remoteRatio / localRatio = lW * remoteLocalWidthRatio * And the total width for the thumbnails is: * totalWidth = rW * numberRemoteThumbs + lW * = lW * remoteLocalWidthRatio * numberRemoteThumbs + lW = * lW * (remoteLocalWidthRatio * numberRemoteThumbs + 1) * and the h = lW/localRatio * * In order to fit all the thumbails in the area defined by * availableWidth * availableHeight we should check one of the * following options: * 1) if availableHeight == h - totalWidth should be less than * availableWidth * 2) if availableWidth == totalWidth - h should be less than * availableHeight * * 1) or 2) will be true and we are going to use it to calculate all * sizes. * * if 1) is true that means that * availableHeight/h > availableWidth/totalWidth otherwise 2) is true */ const numberRemoteThumbs = this.getThumbs(true).remoteThumbs.length; const remoteLocalWidthRatio = interfaceConfig.REMOTE_THUMBNAIL_RATIO / interfaceConfig.LOCAL_THUMBNAIL_RATIO; const lW = Math.min(availableWidth / (remoteLocalWidthRatio * numberRemoteThumbs + 1), availableHeight * interfaceConfig.LOCAL_THUMBNAIL_RATIO); const h = lW / interfaceConfig.LOCAL_THUMBNAIL_RATIO; return { localVideo:{ thumbWidth: lW, thumbHeight: h }, remoteVideo: { thumbWidth: lW * remoteLocalWidthRatio, thumbHeight: h } }; }, /** * Resizes thumbnails * @param local * @param remote * @param animate * @param forceUpdate * @returns {Promise} */ resizeThumbnails(local, remote, animate = false, forceUpdate = false) { return new Promise(resolve => { let thumbs = this.getThumbs(!forceUpdate); let promises = []; if(thumbs.localThumb) { promises.push(new Promise((resolve) => { thumbs.localThumb.animate({ height: local.thumbHeight, width: local.thumbWidth }, this._getAnimateOptions(animate, resolve)); })); } if(thumbs.remoteThumbs) { promises.push(new Promise((resolve) => { thumbs.remoteThumbs.animate({ height: remote.thumbHeight, width: remote.thumbWidth }, this._getAnimateOptions(animate, resolve)); })); } promises.push(new Promise((resolve) => { this.filmStrip.animate({ // adds 2 px because of small video 1px border height: remote.thumbHeight + 2 }, this._getAnimateOptions(animate, resolve)); })); promises.push(new Promise(() => { let { localThumb } = this.getThumbs(); let height = localThumb.height(); let fontSize = UIUtil.getIndicatorFontSize(height); this.filmStrip.find('.indicator').animate({ fontSize }, this._getAnimateOptions(animate, resolve)); })); if (!animate) { resolve(); } Promise.all(promises).then(resolve); }); }, /** * Helper method. Returns options for jQuery animation * @param animate {Boolean} - animation flag * @param cb {Function} - complete callback * @returns {Object} - animation options object * @private */ _getAnimateOptions(animate, cb = $.noop) { return { queue: false, duration: animate ? 500 : 0, complete: cb }; }, /** * Returns thumbnails of the filmstrip * @param only_visible * @returns {object} thumbnails */ getThumbs(only_visible = false) { let selector = 'span'; if (only_visible) { selector += ':visible'; } let localThumb = $("#localVideoContainer"); let remoteThumbs = this.filmStrip.children(selector) .not("#localVideoContainer"); // Exclude the local video container if it has been hidden. if (localThumb.hasClass("hidden")) { return { remoteThumbs }; } else { return { remoteThumbs, localThumb }; } } }; export default FilmStrip;