Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

2.6 KB
Raw Blame
/**
 * mediaPlaybackBus
 * ---------------------------------------------------------------------------
 * 聊天流里所有 <audio> / <video> 的全局互斥总线。两条规则:
 *   1. 同一时刻只允许一个媒体元素在播放——新的 play 事件触发时,自动
 *      pause 其它所有已注册的元素。
 *   2. 切 session 时调用 stopAllMedia() 把当前 session 仍在播放的媒体
 *      显式停掉(由 MessageStream 顶层 useEffect cleanup 触发)。
 *
 * 用法:
 *   useEffect(() => {
 *     const el = mediaRef.current;
 *     if (!el) return;
 *     return registerMedia(el);   // 返回 cleanup
 *   }, []);
 *
 * 设计要点:
 *   - 监听元素自身的 `play` 事件,而不是包一层 togglePlay() 之类的方法。
 *     这样无论谁触发播放(自定义按钮 / 原生 controls / autoPlay /
 *     element.play())都能命中互斥。
 *   - pause() 是同步的,不返回 Promise(只有 play() 返 Promise),所以
 *     这里不需要 await。
 *   - 不调 onpause / onended 反向更新状态——pause() 会自然派发 pause
 *     事件,各组件已经各自监听了 pause/ended 来收敛 UI。
 */

const registered = new Set<HTMLMediaElement>();

function pauseOthers(active: HTMLMediaElement): void {
  for (const el of registered) {
    if (el === active) continue;
    if (!el.paused) {
      try {
        el.pause();
      } catch {
        /* 元素已 detach / 销毁中 — 静默 */
      }
    }
  }
}

/**
 * 注册一个媒体元素到互斥总线。返回 cleanup,必须在 effect cleanup 里调用。
 * 多次注册同一个元素是幂等的(Set 去重 + 同一 listener 重复 add 在
 * 浏览器层也只会挂一份,但稳妥起见 cleanup 逻辑仍按对称形式写)。
 */
export function registerMedia(el: HTMLMediaElement): () => void {
  const onPlay = (): void => {
    pauseOthers(el);
  };
  registered.add(el);
  el.addEventListener('play', onPlay);
  return () => {
    el.removeEventListener('play', onPlay);
    registered.delete(el);
  };
}

/**
 * 停止所有已注册的媒体元素。由 MessageStream 在 session 切换 / unmount
 * 时调用,作为 React unmount 的兜底——元素从 DOM 移除通常会自动停止
 * 播放,但 chromium 偶发存在短暂延迟,显式 pause 能保证即时停止。
 */
export function stopAllMedia(): void {
  for (const el of registered) {
    if (!el.paused) {
      try {
        el.pause();
      } catch {
        /* 元素已 detach — 静默 */
      }
    }
  }
}

/** 测试用:清空注册表(不在生产路径使用)。 */
export function __resetMediaBusForTests(): void {
  registered.clear();
}