464 lines
16 KiB
JavaScript
464 lines
16 KiB
JavaScript
/* 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 = `
|
|
<button id="hideVideoToolbar">
|
|
<i class="icon-menu-${isVisible ? 'down' : 'up'}">
|
|
</i>
|
|
</button>
|
|
`;
|
|
|
|
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;
|