refactor(radio): separate directory and playback components

This commit is contained in:
Sameh Khamis committed 2026-09-13 17:28:35 -07:00
1 parent ba7fda74d7
commit 41b3cc1705
30 files changed
+4488 -2795

No files matched your search

+148
View File
@@ -0,0 +1,148 @@
import { VOICE_RESTORE_DELAY_MS, VOICE_RESTORE_DURATION_MS } from './policy.js';
export function createVolume({ state: layerState, services, parts, source }) {
function clampRadioVolume(value) {
return Math.min(1, Math.max(0, Number(value) || 0));
}
function cancelRadioVolumeTransition() {
layerState._volumeTransitionGeneration += 1;
if (layerState._voiceRestoreTimer)
clearTimeout(layerState._voiceRestoreTimer);
layerState._voiceRestoreTimer = null;
if (layerState._volumeFadeFrame) {
if (typeof cancelAnimationFrame === 'function')
cancelAnimationFrame(layerState._volumeFadeFrame);
else clearTimeout(layerState._volumeFadeFrame);
}
layerState._volumeFadeFrame = null;
}
function scheduleVolumeFrame(callback) {
if (typeof requestAnimationFrame === 'function')
return requestAnimationFrame(callback);
return setTimeout(() => callback(Date.now()), 16);
}
function volumeClock() {
return typeof performance !== 'undefined' &&
typeof performance.now === 'function'
? performance.now()
: Date.now();
}
/** Set shared audio volume, clamped to [0, 1]. */
function setRadioVolume(value) {
if (!parts.interaction.radioPresentationAllowed()) return false;
const volume = clampRadioVolume(value);
layerState._userVolume = volume;
parts.playback.installAudio();
if (!layerState._voiceDucked) {
cancelRadioVolumeTransition();
layerState._voiceRestoring = false;
if (layerState._audio) layerState._audio.volume = volume;
}
parts.tuningNoise.syncTuningNoiseGain();
parts.presentation.emitState();
return true;
}
/**
* Mute Radio during a live voice turn, then gently restore the user-owned
* volume after voice returns to standby. Repeated state sync is idempotent.
*/
function setRadioVoiceDucking(
ducked,
{
restoreDelayMs = VOICE_RESTORE_DELAY_MS,
restoreDurationMs = VOICE_RESTORE_DURATION_MS,
} = {},
) {
const shouldDuck = Boolean(ducked);
if (
shouldDuck === layerState._voiceDucked &&
(shouldDuck || layerState._voiceRestoring)
)
return;
if (
!shouldDuck &&
!layerState._voiceDucked &&
!layerState._voiceRestoring &&
(!layerState._audio ||
Math.abs(layerState._audio.volume - layerState._userVolume) < 0.001)
)
return;
cancelRadioVolumeTransition();
layerState._voiceDucked = shouldDuck;
layerState._voiceRestoring = false;
if (shouldDuck) {
if (layerState._audio) layerState._audio.volume = 0;
parts.tuningNoise.syncTuningNoiseGain();
parts.presentation.emitState();
return;
}
if (!layerState._audio) {
parts.tuningNoise.syncTuningNoiseGain();
layerState._voiceRestoring = false;
parts.presentation.emitState();
return;
}
const generation = layerState._volumeTransitionGeneration;
parts.tuningNoise.syncTuningNoiseGain();
layerState._voiceRestoring = true;
parts.presentation.emitState();
const beginRestore = () => {
layerState._voiceRestoreTimer = null;
if (
generation !== layerState._volumeTransitionGeneration ||
layerState._voiceDucked ||
!layerState._audio
)
return;
const startedAt = volumeClock();
const initialVolume = layerState._audio.volume;
const duration = Math.max(0, Number(restoreDurationMs) || 0);
const step = (now) => {
if (
generation !== layerState._volumeTransitionGeneration ||
layerState._voiceDucked ||
!layerState._audio
)
return;
const progress =
duration === 0
? 1
: Math.min(1, Math.max(0, (now - startedAt) / duration));
const eased = progress * progress * (3 - 2 * progress);
layerState._audio.volume = clampRadioVolume(
initialVolume + (layerState._userVolume - initialVolume) * eased,
);
if (progress < 1) {
layerState._volumeFadeFrame = scheduleVolumeFrame(step);
return;
}
layerState._volumeFadeFrame = null;
layerState._voiceRestoring = false;
parts.presentation.emitState();
};
layerState._volumeFadeFrame = scheduleVolumeFrame(step);
};
const delay = Math.max(0, Number(restoreDelayMs) || 0);
if (delay > 0)
layerState._voiceRestoreTimer = setTimeout(beginRestore, delay);
else beginRestore();
}
return {
clampRadioVolume,
cancelRadioVolumeTransition,
scheduleVolumeFrame,
volumeClock,
setRadioVolume,
setRadioVoiceDucking,
};
}