- 文档首页
实时音视频
AI 音视频互动方案
开发指南
获取 AI 对话任务事件
获取 AI 对话任务事件
调用 StartVoiceChat 接口启动任务后,你可以通过服务端回调,实时获取任务的状态变化(如任务开始、结束)、获取任务资源用量以及任务错误信息,从而实现精细化的任务监控或故障排查。
应用场景
- 通过监听 AI 对话任务状态,捕获用户结束说话、AI 回答完毕等关键节点,以便添加自定义业务逻辑,例如记录任务时长、更新客户端 UI 状态或触发下游数据分析流程等。
- 通过比对不同状态回调的时间戳,分析 ASR、LLM、TTS 各个核心处理阶段的耗时,为性能体验优化提供数据支持。
- 当 AI 对话任务发生异常时,回调会提供错误码和错误信息,帮助你快速定位问题根源。
实现方式
- 若接口版本为 2025-06-01:前往 功能配置,选择回调设置。
- 若接口版本为 2024-12-01(建议迁移至2025-06-01版本): 实时音视频-功能配置,选择回调设置。
- 单击 添加配置,按页面指引填写相关参数,其中回调事件选择 VoiceChat。
如无特殊需求则无需配置业务标识,否则可能导致无法正常收到回调消息。
配置完成后,当 AI 对话任务状态变更或发生错误时,配置的 URL 将会收到 VoiceChat 事件(JSON 格式)。事件详情,请参看事件和错误码。
最近更新时间:2026.09.09 17:39:16