xunzhi-media-domain

name	xunzhi-media-domain
description	AI-Meeting 媒体与实时通信知识 Skill。用于处理实时语音转写、WebSocket 推送、心跳、错误通知、长文本 TTS 和消息协议；当需求命中 `/api/xunzhi/v1/xunfei/**`、`/api/xunzhi/v1/websocket/**` 或 `@ServerEndpoint` 实时链路时使用。

xunzhi-media-domain

使用顺序

• 再看 references/object-dictionary.md，确认连接对象、转写对象、TTS 对象的真相源。
• 先看 references/api-map.md，确认是 WebSocket、转写还是 TTS。
• 再看 references/realtime-asr.md，理解实时转写会话与消息协议。
• 再看 references/websocket-notification.md，理解服务器推送的消息类型。
• 最后看 references/tts.md 和 references/gotchas.md。

关键入口

• admin/src/main/java/com/hewei/hzyjy/xunzhi/media/api/WebSocketController.java
• admin/src/main/java/com/hewei/hzyjy/xunzhi/media/api/XunfeiTtsController.java
• admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/websocket/AudioTranscriptionWebSocketHandler.java
• admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/integration/XunfeiAudioService.java
• admin/src/main/java/com/hewei/hzyjy/xunzhi/media/infrastructure/integration/XunfeiLongTextTtsService.java

必守约束

• WebSocket 连接 session 和业务 sessionId 不是一回事，不能混写。
• WebSocket 转写必须先鉴权，再进入转写会话。
• 同一个 session 不能无限叠加多个转写上下文。
• 心跳、开始、停止、状态查询的协议字段必须前后端一致。
• 长文本 TTS 的任务创建和查询是两条不同的生命周期。

参考资料

• references/object-dictionary.md
• references/api-map.md
• references/realtime-asr.md
• references/websocket-notification.md
• references/tts.md
• references/gotchas.md