2026-09-11 21:57:38 +08:00
|
|
|
|
import { SOCKET_ROOMS } from '@classhelper/shared';
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 实时事件总线。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 业务模块只依赖这里,不直接依赖 Socket.IO 实例,
|
|
|
|
|
|
* 因此「移除实时推送」只需让它注册不到 emitter,业务代码无需改动。
|
|
|
|
|
|
*/
|
|
|
|
|
|
export type RealtimeEmitter = (rooms: string[], event: string, payload: unknown) => void;
|
|
|
|
|
|
|
|
|
|
|
|
let emitter: RealtimeEmitter | null = null;
|
|
|
|
|
|
|
|
|
|
|
|
export function registerEmitter(next: RealtimeEmitter): void {
|
|
|
|
|
|
emitter = next;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
export function emitToRooms(rooms: string[], event: string, payload: unknown): void {
|
|
|
|
|
|
if (!emitter || rooms.length === 0) return;
|
|
|
|
|
|
emitter(rooms, event, payload);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/** 按班级房间广播(class:{classId}) */
|
|
|
|
|
|
export function emitToClass(classId: string, event: string, payload: unknown): void {
|
|
|
|
|
|
emitToRooms([SOCKET_ROOMS.class(classId)], event, payload);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-06 19:41:18 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 定向推送给单个会话。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 会话 id:教师/管理员是自己的账号 id,ClassHelper 班级端是**班级 id**
|
|
|
|
|
|
* (见 socket.ts 的握手逻辑)。学生不是账号,因此没有"学生房间"。
|
|
|
|
|
|
*/
|
|
|
|
|
|
export function emitToSession(sessionId: string, event: string, payload: unknown): void {
|
|
|
|
|
|
emitToRooms([SOCKET_ROOMS.session(sessionId)], event, payload);
|
2026-09-11 21:57:38 +08:00
|
|
|
|
}
|