mirror of
https://github.com/vector-im/element-call.git
synced 2026-11-19 09:32:29 +08:00
193 lines
6.6 KiB
TypeScript
193 lines
6.6 KiB
TypeScript
/*
|
|
Copyright 2026 Element Creations Ltd.
|
|
|
|
SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
|
|
Please see LICENSE in the repository root for full details.
|
|
*/
|
|
|
|
import { combineLatest, map, type Observable } from "rxjs";
|
|
import { type LocalVideoMediaTrack } from "@element-hq/matrixrtc-sdk";
|
|
|
|
import { type CallViewModel } from "../state/CallViewModel/CallViewModel";
|
|
import { type BackgroundEffectsState } from "../state/BackgroundEffects";
|
|
import { type MediaDevices } from "../state/MediaDevices";
|
|
import { debugTileLayout as debugTileLayoutSetting } from "../settings/settings";
|
|
import { type Behavior, constant } from "../state/Behavior";
|
|
import type { ObservableScope } from "../state/ObservableScope";
|
|
import { type MuteStates } from "../state/MuteStates";
|
|
import { createStaticViewModel, type ViewModel } from "../state/ViewModel";
|
|
import { HeaderStyle } from "../UrlParams";
|
|
import { platform } from "../Platform";
|
|
import { type FooterSnapshot } from "./CallFooter";
|
|
import {
|
|
createAudioMenuViewModel,
|
|
createCameraMenuViewModel,
|
|
} from "./MediaMenuViewModel";
|
|
|
|
/**
|
|
* Creates the ViewModel for the CallFooter.
|
|
*
|
|
* @param scope - ObservableScope that bounds the lifetime of derived behaviors.
|
|
* @param callModel - The root CallViewModel; provides layout, grid mode, reactions, etc.
|
|
* @param muteStates - Audio and video mute state + toggles.
|
|
* @param mediaDevices - Available and selected input devices.
|
|
* @param backgroundEffectsState$ - The background pipeline's state: whether
|
|
* effects run here, and the wait for the first.
|
|
* @param reactionIdentifier - The local user's reaction identifier string, or
|
|
* undefined when reactions are not supported (hides the reaction button).
|
|
* @param options - `showControls`: whether the call controls should be shown.
|
|
* `header`: the style of header, which decides whether to show the logo.
|
|
*/
|
|
export function createCallFooterViewModel(
|
|
scope: ObservableScope,
|
|
callModel: CallViewModel,
|
|
muteStates: MuteStates,
|
|
mediaDevices: MediaDevices,
|
|
backgroundEffectsState$: Observable<BackgroundEffectsState>,
|
|
reactionIdentifier: string | undefined,
|
|
options: { showControls: boolean; header: HeaderStyle },
|
|
): ViewModel<FooterSnapshot> {
|
|
const { showControls, header: headerStyle } = options;
|
|
const showLogo = headerStyle === HeaderStyle.Standard;
|
|
|
|
const isPip$ = scope.behavior(
|
|
callModel.layout$.pipe(map((l) => l.type === "pip")),
|
|
);
|
|
const disableDeviceSwitcher$ = scope.behavior(
|
|
isPip$.pipe(map((isPip) => isPip || platform !== "desktop")),
|
|
);
|
|
return {
|
|
audioMenuVm$: constant(
|
|
createAudioMenuViewModel(
|
|
scope,
|
|
muteStates,
|
|
mediaDevices,
|
|
disableDeviceSwitcher$,
|
|
),
|
|
),
|
|
cameraMenuVm$: constant(
|
|
createCameraMenuViewModel(
|
|
scope,
|
|
muteStates,
|
|
mediaDevices,
|
|
disableDeviceSwitcher$,
|
|
backgroundEffectsState$,
|
|
callModel.camera$,
|
|
),
|
|
),
|
|
// candidat to move into the FooterViewModel
|
|
showFooter$: callModel.showFooter$,
|
|
hideControls$: constant(!showControls),
|
|
showModals$: callModel.showModals$,
|
|
asOverlay$: callModel.edgeToEdge$,
|
|
buttonSize$: scope.behavior(
|
|
isPip$.pipe(map<boolean, "md" | "lg">((pip) => (pip ? "md" : "lg"))),
|
|
),
|
|
|
|
openSettings$: scope.behavior(
|
|
combineLatest([
|
|
callModel.showModals$,
|
|
callModel.showHeader$,
|
|
callModel.setSettingsOpen$,
|
|
]).pipe(
|
|
map(([showModals, showHeader, setSettingsOpen]) =>
|
|
showModals && headerStyle !== HeaderStyle.AppBar && showControls
|
|
? (): void => setSettingsOpen(true)
|
|
: undefined,
|
|
),
|
|
),
|
|
),
|
|
|
|
showLogo$: scope.behavior(isPip$.pipe(map((isPip) => showLogo && !isPip))),
|
|
|
|
layoutSwitchVm$: callModel.layoutSwitchVm$,
|
|
|
|
sharingScreen$: callModel.sharingScreen$,
|
|
toggleScreenSharing$: constant(callModel.toggleScreenSharing ?? undefined),
|
|
|
|
audioOutputSwitcher$: scope.behavior(
|
|
callModel.audioOutputSwitcher$.pipe(
|
|
map((switcher) => switcher ?? undefined),
|
|
),
|
|
),
|
|
|
|
hangup$: constant(callModel.hangup),
|
|
|
|
reactionIdentifier$: constant(reactionIdentifier),
|
|
reactionData$: constant(
|
|
reactionIdentifier !== undefined
|
|
? {
|
|
handsRaised$: callModel.handsRaised$,
|
|
reactions$: callModel.reactions$,
|
|
}
|
|
: undefined,
|
|
),
|
|
|
|
debugTileLayout$: debugTileLayoutSetting.value$,
|
|
tileStoreGeneration$: callModel.tileStoreGeneration$,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Creates a simplified ViewModel for the CallFooter used in the lobby
|
|
* (pre-call) screen. Unlike createCallFooterViewModel, this does not require
|
|
* a CallViewModel — it only needs mute states, device lists, and callbacks.
|
|
*
|
|
* @param scope - ObservableScope that bounds the lifetime of derived behaviors.
|
|
* @param muteStates - Audio and video mute state + toggles.
|
|
* @param mediaDevices - Available and selected input devices.
|
|
* @param backgroundEffectsState$ - The background pipeline's state: whether
|
|
* effects run here, and the wait for the first.
|
|
* @param camera$ - The lobby's camera, for the camera menu's preview.
|
|
* @param openSettings - Callback to open the settings modal, or undefined.
|
|
* @param hangup - Callback to leave/cancel, or undefined (hides the button).
|
|
* @param showLogo - Whether to show the Element Call logo.
|
|
*/
|
|
export function createLobbyFooterViewModel(
|
|
scope: ObservableScope,
|
|
muteStates: MuteStates,
|
|
mediaDevices: MediaDevices,
|
|
backgroundEffectsState$: Observable<BackgroundEffectsState>,
|
|
camera$: Behavior<LocalVideoMediaTrack | null>,
|
|
openSettings: (() => void) | undefined,
|
|
hangup: (() => void) | undefined,
|
|
showLogo: boolean,
|
|
): ViewModel<FooterSnapshot> {
|
|
return createStaticViewModel({
|
|
// we can safly skip any props that we do not need.
|
|
// The view model will then have less keys.
|
|
// But as soon as we call `useViewModel` and convert back to a snapshot the missing props will
|
|
// be correcty matching the snapshot type.
|
|
showLogo,
|
|
hideControls: false,
|
|
asOverlay: false,
|
|
showModals: true,
|
|
buttonSize: "lg",
|
|
openSettings,
|
|
hangup,
|
|
debugTileLayout: false,
|
|
showFooter: true,
|
|
toggleScreenSharing: undefined,
|
|
layoutSwitchVm: null,
|
|
sharingScreen: false,
|
|
audioOutputSwitcher: undefined,
|
|
reactionIdentifier: undefined,
|
|
reactionData: undefined,
|
|
tileStoreGeneration: undefined,
|
|
audioMenuVm: createAudioMenuViewModel(
|
|
scope,
|
|
muteStates,
|
|
mediaDevices,
|
|
constant(false),
|
|
),
|
|
cameraMenuVm: createCameraMenuViewModel(
|
|
scope,
|
|
muteStates,
|
|
mediaDevices,
|
|
constant(false),
|
|
backgroundEffectsState$,
|
|
camera$,
|
|
),
|
|
});
|
|
}
|