// @flow import React, { Component } from 'react'; import { ScrollView } from 'react-native'; import { Container, Platform } from '../../../base/react'; import { connect } from '../../../base/redux'; import { isNarrowAspectRatio, makeAspectRatioAware } from '../../../base/responsive-ui'; import { isFilmstripVisible } from '../../functions'; import LocalThumbnail from './LocalThumbnail'; import styles from './styles'; import Thumbnail from './Thumbnail'; /** * Filmstrip component's property types. */ type Props = { /** * The indicator which determines whether the filmstrip is enabled. * * @private */ _enabled: boolean, /** * The participants in the conference. * * @private */ _participants: Array, /** * The indicator which determines whether the filmstrip is visible. * * @private */ _visible: boolean }; /** * Implements a React {@link Component} which represents the filmstrip on * mobile/React Native. * * @extends Component */ class Filmstrip extends Component { /** * Whether the local participant should be rendered separately from the * remote participants i.e. outside of their {@link ScrollView}. */ _separateLocalThumbnail: boolean; /** * Constructor of the component. * * @inheritdoc */ constructor(props) { super(props); // XXX Our current design is to have the local participant separate from // the remote participants. Unfortunately, Android's Video // implementation cannot accommodate that because remote participants' // videos appear on top of the local participant's video at times. // That's because Android's Video utilizes EGL and EGL gives us only two // practical layers in which we can place our participants' videos: // layer #0 sits behind the window, creates a hole in the window, and // there we render the LargeVideo; layer #1 is known as media overlay in // EGL terms, renders on top of layer #0, and, consequently, is for the // Filmstrip. With the separate LocalThumnail, we should have left the // remote participants' Thumbnails in layer #1 and utilized layer #2 for // LocalThumbnail. Unfortunately, layer #2 is not practical (that's why // I said we had two practical layers only) because it renders on top of // everything which in our case means on top of participant-related // indicators such as moderator, audio and video muted, etc. For now we // do not have much of a choice but to continue rendering LocalThumbnail // as any other remote Thumbnail on Android. this._separateLocalThumbnail = Platform.OS !== 'android'; } /** * Implements React's {@link Component#render()}. * * @inheritdoc * @returns {ReactElement} */ render() { if (!this.props._enabled) { return null; } const isNarrowAspectRatio_ = isNarrowAspectRatio(this); const filmstripStyle = isNarrowAspectRatio_ ? styles.filmstripNarrow : styles.filmstripWide; return ( { this._separateLocalThumbnail && !isNarrowAspectRatio_ && } { !this._separateLocalThumbnail && !isNarrowAspectRatio_ && } { this._sort( this.props._participants, isNarrowAspectRatio_) .map(p => ( )) } { !this._separateLocalThumbnail && isNarrowAspectRatio_ && } { this._separateLocalThumbnail && isNarrowAspectRatio_ && } ); } /** * Sorts a specific array of {@code Participant}s in display order. * * @param {Participant[]} participants - The array of {@code Participant}s * to sort in display order. * @param {boolean} isNarrowAspectRatio_ - Indicates if the aspect ratio is * wide or narrow. * @private * @returns {Participant[]} A new array containing the elements of the * specified {@code participants} array sorted in display order. */ _sort(participants, isNarrowAspectRatio_) { // XXX Array.prototype.sort() is not appropriate because (1) it operates // in place and (2) it is not necessarily stable. const sortedParticipants = [ ...participants ]; if (isNarrowAspectRatio_) { // When the narrow aspect ratio is used, we want to have the remote // participants from right to left with the newest added/joined to // the leftmost side. The local participant is the leftmost item. sortedParticipants.reverse(); } return sortedParticipants; } } /** * Maps (parts of) the redux state to the associated {@code Filmstrip}'s props. * * @param {Object} state - The redux state. * @private * @returns {{ * _participants: Participant[], * _visible: boolean * }} */ function _mapStateToProps(state) { const participants = state['features/base/participants']; const { enabled } = state['features/filmstrip']; return { /** * The indicator which determines whether the filmstrip is enabled. * * @private * @type {boolean} */ _enabled: enabled, /** * The remote participants in the conference. * * @private * @type {Participant[]} */ _participants: participants.filter(p => !p.local), /** * The indicator which determines whether the filmstrip is visible. The * mobile/react-native Filmstrip is visible when there are at least 2 * participants in the conference (including the local one). * * @private * @type {boolean} */ _visible: isFilmstripVisible(state) }; } export default connect(_mapStateToProps)(makeAspectRatioAware(Filmstrip));