import PropTypes from 'prop-types'; import React, { Component } from 'react'; import { View } from 'react-native'; import { connect as reactReduxConnect } from 'react-redux'; import { connect, disconnect } from '../../base/connection'; import { DialogContainer } from '../../base/dialog'; import { Container, LoadingIndicator } from '../../base/react'; import { createDesiredLocalTracks } from '../../base/tracks'; import { Filmstrip } from '../../filmstrip'; import { LargeVideo } from '../../large-video'; import { OverlayContainer } from '../../overlay'; import { setToolboxVisible, Toolbox } from '../../toolbox'; import styles from './styles'; /** * The timeout in milliseconds after which the Toolbox will be hidden. * * @private * @type {number} */ const _TOOLBOX_TIMEOUT_MS = 5000; /** * The conference page of the mobile (i.e. React Native) application. */ class Conference extends Component { /** * Conference component's property types. * * @static */ static propTypes = { /** * The indicator which determines that we are still connecting to the * conference which includes establishing the XMPP connection and then * joining the room. If truthy, then an activity/loading indicator will * be rendered. * * @private */ _connecting: PropTypes.bool, /** * The handler which dispatches the (redux) action connect. * * @private */ _onConnect: PropTypes.func, /** * The handler which dispatches the (redux) action disconnect. * * @private */ _onDisconnect: PropTypes.func, /** * The handler which dispatches the (redux) action setToolboxVisible to * show/hide the Toolbox. * * @private */ _setToolboxVisible: PropTypes.func, /** * The indicator which determines whether the Toolbox is visible. * * @private */ _toolboxVisible: PropTypes.bool }; /** * Initializes a new Conference instance. * * @param {Object} props - The read-only properties with which the new * instance is to be initialized. */ constructor(props) { super(props); /** * The numerical ID of the timeout in milliseconds after which the * Toolbox will be hidden. To be used with * {@link WindowTimers#clearTimeout()}. * * @private */ this._toolboxTimeout = undefined; // Bind event handlers so they are only bound once for every instance. this._onClick = this._onClick.bind(this); } /** * Inits the Toolbox timeout after the component is initially rendered. * * @inheritdoc * returns {void} */ componentDidMount() { this._setToolboxTimeout(this.props._toolboxVisible); } /** * Inits new connection and conference when conference screen is entered. * * @inheritdoc * @returns {void} */ componentWillMount() { this.props._onConnect(); } /** * Destroys connection, conference and local tracks when conference screen * is left. Clears {@link #_toolboxTimeout} before the component unmounts. * * @inheritdoc * @returns {void} */ componentWillUnmount() { this._clearToolboxTimeout(); this.props._onDisconnect(); } /** * Implements React's {@link Component#render()}. * * @inheritdoc * @returns {ReactElement} */ render() { return ( {/* * The LargeVideo is the lowermost stacking layer. */} {/* * The Filmstrip is in a stacking layer above the LargeVideo. * The LargeVideo and the Filmstrip form what the Web/React app * calls "videospace". Presumably, the name and grouping stem * from the fact that these two React Components depict the * videos of the conference's participants. */} {/* * The overlays need to be bellow the Toolbox so that the user * may tap the ToolbarButtons. */} {/* * The activity/loading indicator goes above everything, except * the toolbox/toolbars and the dialogs. */ this.props._connecting && } {/* * The Toolbox is in a stacking layer above the Filmstrip. */} {/* * The dialogs are in the topmost stacking layers. */} ); } /** * Clears {@link #_toolboxTimeout} if any. * * @private * @returns {void} */ _clearToolboxTimeout() { if (this._toolboxTimeout) { clearTimeout(this._toolboxTimeout); this._toolboxTimeout = undefined; } } /** * Changes the value of the toolboxVisible state, thus allowing us to switch * between Toolbox and Filmstrip and change their visibility. * * @private * @returns {void} */ _onClick() { const toolboxVisible = !this.props._toolboxVisible; this.props._setToolboxVisible(toolboxVisible); this._setToolboxTimeout(toolboxVisible); } /** * Triggers the default Toolbox timeout. * * @param {boolean} toolboxVisible - Indicates whether the Toolbox is * currently visible. * @private * @returns {void} */ _setToolboxTimeout(toolboxVisible) { this._clearToolboxTimeout(); if (toolboxVisible) { this._toolboxTimeout = setTimeout(this._onClick, _TOOLBOX_TIMEOUT_MS); } } } /** * Maps dispatching of some action to React component props. * * @param {Function} dispatch - Redux action dispatcher. * @private * @returns {{ * _onConnect: Function, * _onDisconnect: Function, * _setToolboxVisible: Function * }} */ function _mapDispatchToProps(dispatch) { return { /** * Dispatches actions to create the desired local tracks and for * connecting to the conference. * * @returns {void} * @private */ _onConnect() { dispatch(createDesiredLocalTracks()); dispatch(connect()); }, /** * Dispatches an action disconnecting from the conference. * * @returns {void} * @private */ _onDisconnect() { dispatch(disconnect()); }, /** * Dispatches an action changing the visiblity of the Toolbox. * * @param {boolean} visible - True to show the Toolbox or false to hide * it. * @returns {void} * @private */ _setToolboxVisible(visible: boolean) { dispatch(setToolboxVisible(visible)); } }; } /** * Maps (parts of) the Redux state to the associated Conference's props. * * @param {Object} state - The Redux state. * @private * @returns {{ * _connecting: boolean, * _toolboxVisible: boolean * }} */ function _mapStateToProps(state) { const { connecting, connection } = state['features/base/connection']; const { conference, joining, leaving } = state['features/base/conference']; // XXX There is a window of time between the successful establishment of the // XMPP connection and the subsequent commencement of joining the MUC during // which the app does not appear to be doing anything according to the redux // state. In order to not toggle the _connecting props during the window of // time in question, define _connecting as follows: // - the XMPP connection is connecting, or // - the XMPP connection is connected and the conference is joining, or // - the XMPP connection is connected and we have no conference yet, nor we // are leaving one. const connecting_ = connecting || (connection && (joining || (!conference && !leaving))); return { /** * The indicator which determines that we are still connecting to the * conference which includes establishing the XMPP connection and then * joining the room. If truthy, then an activity/loading indicator will * be rendered. * * @private * @type {boolean} */ _connecting: Boolean(connecting_), /** * The indicator which determines whether the Toolbox is visible. * * @private * @type {boolean} */ _toolboxVisible: state['features/toolbox'].visible }; } export default reactReduxConnect(_mapStateToProps, _mapDispatchToProps)( Conference);