事件与消息处理

ConvaiClient 提供强类型事件系统。使用 client.on(event, handler) 进行订阅。

事件

状态变化

client.on('stateChange', (state) => {
  console.log(state.agentState, state.isConnected);
});

新消息

client.on('message', (message) => {
  console.log('消息：', message.type, message.content);
});

消息已更新

client.on('messagesChange', (messages) => {
  console.log('消息总数：', messages.length);
});

实时转写

client.on('userTranscriptionChange', (text) => {
  console.log('你说了：', text);
});

生命周期事件

client.on('connect', () => console.log('已连接'));
client.on('disconnect', () => console.log('已断开连接'));
client.on('botReady', () => console.log('机器人已就绪'));

错误

client.on('error', (err) => {
  console.error('Convai 错误：', err);
});

---

消息类型

Convai 消息包括：

• user-transcription
• bot-llm-text
• bot-emotion
• action
• behavior-tree

只有部分会在 UI 中显示（通常是转写内容 + 机器人文本）。

---

移除监听器

const unsub = client.on('message', handler);
unsub(); // 移除监听器