2026-03-07 18:03:32 +11:00
|
|
|
|
import {
|
|
|
|
|
|
ClientWidgetApi,
|
|
|
|
|
|
IWidgetApiAcknowledgeResponseData,
|
|
|
|
|
|
IWidgetApiRequestData,
|
|
|
|
|
|
} from 'matrix-widget-api';
|
2026-09-25 12:09:34 -04:00
|
|
|
|
import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';
|
2026-03-07 18:03:32 +11:00
|
|
|
|
import { CallControl, CallControlEvent } from './CallControl';
|
|
|
|
|
|
import { CallControlState } from './CallControlState';
|
2026-09-25 12:09:34 -04:00
|
|
|
|
import type { CallEmbed } from './CallEmbed';
|
2026-03-07 18:03:32 +11:00
|
|
|
|
|
|
|
|
|
|
export const useClientWidgetApiEvent = <T>(
|
|
|
|
|
|
api: ClientWidgetApi | undefined,
|
|
|
|
|
|
type: string,
|
2026-05-21 23:30:50 -04:00
|
|
|
|
callback: (event: CustomEvent<T>) => void,
|
2026-03-07 18:03:32 +11:00
|
|
|
|
) => {
|
|
|
|
|
|
useEffect(() => {
|
|
|
|
|
|
api?.on(`action:${type}`, callback);
|
|
|
|
|
|
return () => {
|
|
|
|
|
|
api?.off(`action:${type}`, callback);
|
|
|
|
|
|
};
|
|
|
|
|
|
}, [api, type, callback]);
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
export const useSendClientWidgetApiAction = (api: ClientWidgetApi) => {
|
|
|
|
|
|
const sendWidgetAction = useCallback(
|
|
|
|
|
|
async <T extends IWidgetApiRequestData = IWidgetApiRequestData>(
|
|
|
|
|
|
action: string,
|
2026-05-21 23:30:50 -04:00
|
|
|
|
data: T,
|
2026-03-07 18:03:32 +11:00
|
|
|
|
): Promise<IWidgetApiAcknowledgeResponseData> => api.transport.send(action, data),
|
2026-05-21 23:30:50 -04:00
|
|
|
|
[api],
|
2026-03-07 18:03:32 +11:00
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
|
|
return sendWidgetAction;
|
|
|
|
|
|
};
|
|
|
|
|
|
|
2026-05-24 23:16:43 -04:00
|
|
|
|
const DEFAULT_CONTROL_STATE = new CallControlState(false, false, false);
|
|
|
|
|
|
|
|
|
|
|
|
export const useCallControlState = (control: CallControl | undefined): CallControlState => {
|
2026-09-23 21:53:43 -04:00
|
|
|
|
// Remember which control the stored state came from. When a call starts the
|
|
|
|
|
|
// control changes, and the effect below only catches up after a render; until
|
|
|
|
|
|
// then the old (default: all off) state would be returned for the NEW call —
|
|
|
|
|
|
// one render of "muted + deafened" that the thumbbar, SMTC and tray (#4)
|
|
|
|
|
|
// pushed to the OS as a flicker. Read the new control directly instead.
|
|
|
|
|
|
const [entry, setEntry] = useState(() => ({
|
|
|
|
|
|
control,
|
|
|
|
|
|
state: control?.getState() ?? DEFAULT_CONTROL_STATE,
|
|
|
|
|
|
}));
|
2026-03-07 18:03:32 +11:00
|
|
|
|
|
|
|
|
|
|
useEffect(() => {
|
2026-05-24 23:16:43 -04:00
|
|
|
|
if (!control) {
|
2026-09-23 21:53:43 -04:00
|
|
|
|
setEntry({ control, state: DEFAULT_CONTROL_STATE });
|
2026-05-24 23:16:43 -04:00
|
|
|
|
return;
|
|
|
|
|
|
}
|
2026-09-23 21:53:43 -04:00
|
|
|
|
setEntry({ control, state: control.getState() });
|
|
|
|
|
|
const handleUpdate = () => setEntry({ control, state: control.getState() });
|
2026-03-07 18:03:32 +11:00
|
|
|
|
control.on(CallControlEvent.StateUpdate, handleUpdate);
|
|
|
|
|
|
return () => {
|
|
|
|
|
|
control.off(CallControlEvent.StateUpdate, handleUpdate);
|
|
|
|
|
|
};
|
|
|
|
|
|
}, [control]);
|
|
|
|
|
|
|
2026-09-23 21:53:43 -04:00
|
|
|
|
if (entry.control !== control) return control?.getState() ?? DEFAULT_CONTROL_STATE;
|
|
|
|
|
|
return entry.state;
|
2026-03-07 18:03:32 +11:00
|
|
|
|
};
|
2026-09-25 12:09:34 -04:00
|
|
|
|
|
|
|
|
|
|
const noSubscribe = () => () => undefined;
|
|
|
|
|
|
|
|
|
|
|
|
/** [Gitea #146] The local mic level (0–3 bars) reported by the call, or 0. */
|
|
|
|
|
|
export const useCallMicLevel = (callEmbed: CallEmbed | undefined): number => {
|
|
|
|
|
|
const subscribe = useCallback(
|
|
|
|
|
|
(cb: () => void) => (callEmbed ? callEmbed.onMicLevel(cb) : noSubscribe()),
|
|
|
|
|
|
[callEmbed],
|
|
|
|
|
|
);
|
|
|
|
|
|
return useSyncExternalStore(subscribe, () => callEmbed?.getMicLevel() ?? 0);
|
|
|
|
|
|
};
|