// @flow import type { Dispatch } from 'redux'; import { createSelectParticipantFailedEvent, sendAnalytics } from '../analytics'; import { _handleParticipantError } from '../base/conference'; import { MEDIA_TYPE } from '../base/media'; import { getParticipants } from '../base/participants'; import { reportError } from '../base/util'; import { shouldDisplayTileView } from '../video-layout'; import { SELECT_LARGE_VIDEO_PARTICIPANT, UPDATE_KNOWN_LARGE_VIDEO_RESOLUTION } from './actionTypes'; declare var APP: Object; /** * Signals conference to select a participant. * * @returns {Function} */ export function selectParticipant() { return (dispatch: Dispatch, getState: Function) => { const state = getState(); const { conference } = state['features/base/conference']; if (conference) { const ids = shouldDisplayTileView(state) ? getParticipants(state).map(participant => participant.id) : [ state['features/large-video'].participantId ]; try { conference.selectParticipants(ids); } catch (err) { _handleParticipantError(err); sendAnalytics(createSelectParticipantFailedEvent(err)); reportError( err, `Failed to select participants ${ids.toString()}`); } } }; } /** * Action to select the participant to be displayed in LargeVideo based on a * variety of factors: If there is a dominant or pinned speaker, or if there are * remote tracks, etc. * * @returns {Function} */ export function selectParticipantInLargeVideo() { return (dispatch: Dispatch, getState: Function) => { const state = getState(); const participantId = _electParticipantInLargeVideo(state); const largeVideo = state['features/large-video']; if (participantId !== largeVideo.participantId) { dispatch({ type: SELECT_LARGE_VIDEO_PARTICIPANT, participantId }); dispatch(selectParticipant()); } }; } /** * Updates the currently seen resolution of the video displayed on large video. * * @param {number} resolution - The current resolution (height) of the video. * @returns {{ * type: UPDATE_KNOWN_LARGE_VIDEO_RESOLUTION, * resolution: number * }} */ export function updateKnownLargeVideoResolution(resolution: number) { return { type: UPDATE_KNOWN_LARGE_VIDEO_RESOLUTION, resolution }; } /** * Returns the most recent existing remote video track. * * @param {Track[]} tracks - All current tracks. * @private * @returns {(Track|undefined)} */ function _electLastVisibleRemoteVideo(tracks) { // First we try to get most recent remote video track. for (let i = tracks.length - 1; i >= 0; --i) { const track = tracks[i]; if (!track.local && track.mediaType === MEDIA_TYPE.VIDEO) { return track; } } } /** * Returns the identifier of the participant who is to be on the stage and * should be displayed in {@code LargeVideo}. * * @param {Object} state - The Redux state from which the participant to be * displayed in {@code LargeVideo} is to be elected. * @private * @returns {(string|undefined)} */ function _electParticipantInLargeVideo(state) { // 1. If a participant is pinned, they will be shown in the LargeVideo ( // regardless of whether they are local or remote). const participants = state['features/base/participants']; let participant = participants.find(p => p.pinned); let id = participant && participant.id; if (!id) { // 2. No participant is pinned so get the dominant speaker. But the // local participant won't be displayed in LargeVideo even if she is // the dominant speaker. participant = participants.find(p => p.dominantSpeaker && !p.local); id = participant && participant.id; if (!id) { // 3. There is no dominant speaker so select the remote participant // who last had visible video. const tracks = state['features/base/tracks']; const videoTrack = _electLastVisibleRemoteVideo(tracks); id = videoTrack && videoTrack.participantId; if (!id) { // 4. It's possible there is no participant with visible video. // This can happen for a number of reasons: // - there is only one participant (i.e. the local user), // - other participants joined with video muted. // As a last resort, pick the last participant who joined the // conference (regardless of whether they are local or // remote). // // HOWEVER: We don't want to show poltergeist or other bot type participants on stage // automatically, because it's misleading (users may think they are already // joined and maybe speaking). for (let i = participants.length; i > 0 && !participant; i--) { const p = participants[i - 1]; !p.botType && (participant = p); } id = participant && participant.id; } } } return id; }