Proper use of getPropertyValue in base/media

This commit is contained in:
zbettenbuk 2018-04-13 18:26:42 +02:00 committed by Lyubo Marinov
parent 1513e1f3b3
commit e30d141cec
3 changed files with 116 additions and 44 deletions

View File

@ -1,4 +1,4 @@
/* @flow */ // @flow
import { import {
createStartAudioOnlyEvent, createStartAudioOnlyEvent,
@ -6,7 +6,7 @@ import {
createSyncTrackStateEvent, createSyncTrackStateEvent,
sendAnalytics sendAnalytics
} from '../../analytics'; } from '../../analytics';
import { SET_ROOM, setAudioOnly } from '../conference'; import { isRoomValid, SET_ROOM, setAudioOnly } from '../conference';
import JitsiMeetJS from '../lib-jitsi-meet'; import JitsiMeetJS from '../lib-jitsi-meet';
import { getPropertyValue } from '../profile'; import { getPropertyValue } from '../profile';
import { MiddlewareRegistry } from '../redux'; import { MiddlewareRegistry } from '../redux';
@ -14,6 +14,10 @@ import { setTrackMuted, TRACK_ADDED } from '../tracks';
import { setAudioMuted, setCameraFacingMode, setVideoMuted } from './actions'; import { setAudioMuted, setCameraFacingMode, setVideoMuted } from './actions';
import { CAMERA_FACING_MODE } from './constants'; import { CAMERA_FACING_MODE } from './constants';
import {
_AUDIO_INITIAL_MEDIA_STATE,
_VIDEO_INITIAL_MEDIA_STATE
} from './reducer';
const logger = require('jitsi-meet-logger').getLogger(__filename); const logger = require('jitsi-meet-logger').getLogger(__filename);
@ -30,8 +34,9 @@ MiddlewareRegistry.register(store => next => action => {
case TRACK_ADDED: { case TRACK_ADDED: {
const result = next(action); const result = next(action);
const { track } = action;
action.track.local && _syncTrackMutedState(store, action.track); track.local && _syncTrackMutedState(store, track);
return result; return result;
} }
@ -55,24 +60,50 @@ MiddlewareRegistry.register(store => next => action => {
* specified {@code action}. * specified {@code action}.
*/ */
function _setRoom({ dispatch, getState }, next, action) { function _setRoom({ dispatch, getState }, next, action) {
const { room } = action; // Figure out the desires/intents i.e. the state of base/media. There are
// multiple desires/intents ordered by precedence such as server-side
// Read the config. // config, config overrides in the user-supplied URL, user's own app
// settings, etc.
const state = getState(); const state = getState();
const hasRoom = Boolean(room); const { room } = action;
const roomIsValid = isRoomValid(room);
const audioMuted = Boolean(getPropertyValue(state, 'startWithAudioMuted', { // XXX The configurations/preferences/settings startWithAudioMuted,
urlParams: hasRoom // startWithVideoMuted, and startAudioOnly were introduced for
})); // conferences/meetings. So it makes sense for these to not be considered
const videoMuted = Boolean(getPropertyValue(state, 'startWithVideoMuted', { // outside of conferences/meetings (e.g. WelcomePage). Later on, though, we
urlParams: hasRoom // introduced a "Video <-> Voice" toggle on the WelcomePage which utilizes
})); // startAudioOnly outside of conferences/meetings so that particular
// configuration/preference/setting employs slightly exclusive logic.
const mutedSources = {
// We have startWithAudioMuted and startWithVideoMuted here:
config: true,
profile: true,
sendAnalytics(createStartMutedConfigurationEvent( // XXX We've already overwritten base/config with urlParams. However,
'local', audioMuted, videoMuted)); // profile is more important than the server-side config. Consequently,
// we need to read from urlParams anyway:
urlParams: true,
logger.log(`Start muted: ${audioMuted ? 'audio, ' : ''}${ // We don't have startWithAudioMuted and startWithVideoMuted here:
jwt: false
};
const audioMuted
= roomIsValid
? Boolean(
getPropertyValue(state, 'startWithAudioMuted', mutedSources))
: _AUDIO_INITIAL_MEDIA_STATE.muted;
const videoMuted
= roomIsValid
? Boolean(
getPropertyValue(state, 'startWithVideoMuted', mutedSources))
: _VIDEO_INITIAL_MEDIA_STATE.muted;
sendAnalytics(
createStartMutedConfigurationEvent('local', audioMuted, videoMuted));
logger.log(
`Start muted: ${audioMuted ? 'audio, ' : ''}${
videoMuted ? 'video' : ''}`); videoMuted ? 'video' : ''}`);
// Unconditionally express the desires/expectations/intents of the app and // Unconditionally express the desires/expectations/intents of the app and
@ -82,28 +113,56 @@ function _setRoom({ dispatch, getState }, next, action) {
dispatch(setCameraFacingMode(CAMERA_FACING_MODE.USER)); dispatch(setCameraFacingMode(CAMERA_FACING_MODE.USER));
dispatch(setVideoMuted(videoMuted)); dispatch(setVideoMuted(videoMuted));
// config.startAudioOnly // startAudioOnly
// //
// FIXME Technically, the audio-only feature is owned by base/conference, // FIXME Technically, the audio-only feature is owned by base/conference,
// not base/media so the following should be in base/conference. // not base/media so the following should be in base/conference.
// Practically, I presume it was easier to write the source code here // Practically, I presume it was easier to write the source code here
// because it looks like config.startWithAudioMuted and // because it looks like startWithAudioMuted and startWithVideoMuted.
// config.startWithVideoMuted. //
if (room) { // XXX After the introduction of the "Video <-> Voice" toggle on the
// WelcomePage, startAudioOnly is utilized even outside of
// conferences/meetings.
let audioOnly; let audioOnly;
if (JitsiMeetJS.mediaDevices.supportsVideo()) { if (JitsiMeetJS.mediaDevices.supportsVideo()) {
audioOnly = Boolean(getPropertyValue(state, 'startAudioOnly')); audioOnly
= Boolean(
getPropertyValue(
state,
'startAudioOnly',
/* sources */ {
// FIXME Practically, base/config is (really) correct
// only if roomIsValid. At the time of this writing,
// base/config is overwritten by URL params which leaves
// base/config incorrect on the WelcomePage after
// leaving a conference which explicitly overwrites
// base/config with URL params.
config: roomIsValid,
// XXX We've already overwritten base/config with
// urlParams if roomIsValid. However, profile is more
// important than the server-side config. Consequently,
// we need to read from urlParams anyway. We also
// probably want to read from urlParams when
// !roomIsValid.
urlParams: true,
// The following don't have complications around whether
// they are defined or not:
jwt: false,
profile: true
}));
} else { } else {
// Always default to being audio only if the current environment // Default to audio-only if the (execution) environment does not
// does not support sending or receiving video. // support (sending and/or receiving) video.
audioOnly = true; audioOnly = true;
} }
sendAnalytics(createStartAudioOnlyEvent(audioOnly)); sendAnalytics(createStartAudioOnlyEvent(audioOnly));
logger.log(`Start audio only set to ${audioOnly.toString()}`); logger.log(`Start audio only set to ${audioOnly.toString()}`);
dispatch(setAudioOnly(audioOnly)); dispatch(setAudioOnly(audioOnly));
}
return next(action); return next(action);
} }
@ -127,8 +186,10 @@ function _syncTrackMutedState({ getState }, track) {
// fired before track gets to state. // fired before track gets to state.
if (track.muted !== muted) { if (track.muted !== muted) {
sendAnalytics(createSyncTrackStateEvent(track.mediaType, muted)); sendAnalytics(createSyncTrackStateEvent(track.mediaType, muted));
logger.log(`Sync ${track.mediaType} track muted state to ${ logger.log(
`Sync ${track.mediaType} track muted state to ${
muted ? 'muted' : 'unmuted'}`); muted ? 'muted' : 'unmuted'}`);
track.muted = muted; track.muted = muted;
setTrackMuted(track.jitsiTrack, muted); setTrackMuted(track.jitsiTrack, muted);
} }

View File

@ -22,12 +22,16 @@ import { CAMERA_FACING_MODE } from './constants';
* @property {boolean} muted=false - Audio muted state. * @property {boolean} muted=false - Audio muted state.
*/ */
// FIXME Technically, _AUDIO_INITIAL_MEDIA_STATE is a constant internal to the
// feature base/media and used in multiple files so it should be in
// constants.js. Practically though, AudioMediaState would then be used in
// multiple files as well so I don't know where and how to move it.
/** /**
* Initial state for local audio. * Initial state for local audio.
* *
* @type {AudioMediaState} * @type {AudioMediaState}
*/ */
const AUDIO_INITIAL_MEDIA_STATE = { export const _AUDIO_INITIAL_MEDIA_STATE = {
available: true, available: true,
muted: false muted: false
}; };
@ -41,7 +45,7 @@ const AUDIO_INITIAL_MEDIA_STATE = {
* @private * @private
* @returns {AudioMediaState} * @returns {AudioMediaState}
*/ */
function _audio(state = AUDIO_INITIAL_MEDIA_STATE, action) { function _audio(state = _AUDIO_INITIAL_MEDIA_STATE, action) {
switch (action.type) { switch (action.type) {
case SET_AUDIO_AVAILABLE: case SET_AUDIO_AVAILABLE:
return { return {
@ -68,12 +72,16 @@ function _audio(state = AUDIO_INITIAL_MEDIA_STATE, action) {
* @property {boolean} muted=false - Video muted state. * @property {boolean} muted=false - Video muted state.
*/ */
// FIXME Technically, _VIDEO_INITIAL_MEDIA_STATE is a constant internal to the
// feature base/media and used in multiple files so it should be in
// constants.js. Practically though, VideoMediaState would then be used in
// multiple files as well so I don't know where and how to move it.
/** /**
* Initial state for video. * Initial state for video.
* *
* @type {VideoMediaState} * @type {VideoMediaState}
*/ */
const VIDEO_INITIAL_MEDIA_STATE = { export const _VIDEO_INITIAL_MEDIA_STATE = {
available: true, available: true,
facingMode: CAMERA_FACING_MODE.USER, facingMode: CAMERA_FACING_MODE.USER,
muted: 0, muted: 0,
@ -94,7 +102,7 @@ const VIDEO_INITIAL_MEDIA_STATE = {
* @private * @private
* @returns {VideoMediaState} * @returns {VideoMediaState}
*/ */
function _video(state = VIDEO_INITIAL_MEDIA_STATE, action) { function _video(state = _VIDEO_INITIAL_MEDIA_STATE, action) {
switch (action.type) { switch (action.type) {
case CONFERENCE_FAILED: case CONFERENCE_FAILED:
case CONFERENCE_LEFT: case CONFERENCE_LEFT:
@ -168,7 +176,7 @@ ReducerRegistry.register('features/base/media', combineReducers({
function _clearAllVideoTransforms(state) { function _clearAllVideoTransforms(state) {
return { return {
...state, ...state,
transforms: VIDEO_INITIAL_MEDIA_STATE.transforms transforms: _VIDEO_INITIAL_MEDIA_STATE.transforms
}; };
} }

View File

@ -7,7 +7,9 @@ import { MiddlewareRegistry, toState } from '../redux';
import { PROFILE_UPDATED } from './actionTypes'; import { PROFILE_UPDATED } from './actionTypes';
/** /**
* A middleWare to update the local participant when the profile is updated. * The middleware of the feature base/profile. Distributes changes to the state
* of base/profile to the states of other features computed from the state of
* base/profile.
* *
* @param {Store} store - The redux store. * @param {Store} store - The redux store.
* @returns {Function} * @returns {Function}
@ -18,21 +20,21 @@ MiddlewareRegistry.register(store => next => action => {
switch (action.type) { switch (action.type) {
case PROFILE_UPDATED: case PROFILE_UPDATED:
_updateLocalParticipant(store); _updateLocalParticipant(store);
_maybeUpdateStartAudioOnly(store, action); _maybeSetAudioOnly(store, action);
} }
return result; return result;
}); });
/** /**
* Updates startAudioOnly flag if it's updated in the profile. * Updates {@code startAudioOnly} flag if it's updated in the profile.
* *
* @private
* @param {Store} store - The redux store. * @param {Store} store - The redux store.
* @param {Object} action - The redux action. * @param {Object} action - The redux action.
* @private
* @returns {void} * @returns {void}
*/ */
function _maybeUpdateStartAudioOnly( function _maybeSetAudioOnly(
{ dispatch }, { dispatch },
{ profile: { startAudioOnly } }) { { profile: { startAudioOnly } }) {
if (typeof startAudioOnly === 'boolean') { if (typeof startAudioOnly === 'boolean') {
@ -44,6 +46,7 @@ function _maybeUpdateStartAudioOnly(
* Updates the local participant according to profile changes. * Updates the local participant according to profile changes.
* *
* @param {Store} store - The redux store. * @param {Store} store - The redux store.
* @private
* @returns {void} * @returns {void}
*/ */
function _updateLocalParticipant(store) { function _updateLocalParticipant(store) {