模組事件
更新時間:2026-01-19 09:16:42
AI 助手模組透過事件機制提供狀態通知和訊息回呼。
事件列表
| 事件 | 說明 |
|---|---|
AIAssistantChatSetupedIndependent |
獨立模式 AI 助手設定完成 |
AIAssistantChatSetupedComplete |
AI 助手設定完成 |
AIAssistantChatStatusChange |
聊天狀態變化 |
AIAssistantChatMessage |
收到聊天訊息 |
ReplaceAIAssistantChatMessage |
聊天訊息更新(串流回應) |
事件監聽範例
import { AIAssistantEvents, PolyvAIAssistantChatStatus } from '@polyv/live-watch-ai-sdk';
const aiAssistant = aiCore.aiAssistant;
// 监听设置完成事件
aiAssistant.eventEmitter.on(AIAssistantEvents.AIAssistantChatSetupedIndependent, () => {
console.log('AI 助手已准备好');
});
// 监听聊天状态变化
aiAssistant.eventEmitter.on(AIAssistantEvents.AIAssistantChatStatusChange, ({ status }) => {
console.log('聊天状态:', status === PolyvAIAssistantChatStatus.Wait ? '等待输入' : 'AI 回答中');
});
// 监听聊天消息
aiAssistant.eventEmitter.on(AIAssistantEvents.AIAssistantChatMessage, ({ AIChatMsg }) => {
console.log('收到消息:', AIChatMsg.content);
});
// 监听消息更新(流式响应)
aiAssistant.eventEmitter.on(AIAssistantEvents.ReplaceAIAssistantChatMessage, ({ AIChatMsg }) => {
console.log('消息更新:', AIChatMsg.content);
});
// 清理事件监听器
aiAssistant.eventEmitter.off(AIAssistantEvents.AIAssistantChatMessage);
聊天狀態
| 狀態 | 值 | 說明 |
|---|---|---|
Wait |
0 | 等待使用者輸入 |
Replaying |
1 | AI 正在回答 |
Busy |
2 | AI 忙碌中 |
AI 助手獨立設定回呼
Event 事件: AIAssistantEvents.AIAssistantChatSetupedIndependent
回呼參數: Object 物件,詳細類型說明如下
| 屬性名 | 說明 | 類型 |
|---|
AI 助手完整功能設定回呼
Event 事件: AIAssistantEvents.AIAssistantChatSetupedComplete
AI 助手聊天狀態變化
Event 事件: AIAssistantEvents.AIAssistantChatStatusChange
回呼參數: Object 物件,詳細類型說明如下
| 屬性名 | 說明 | 類型 |
|---|---|---|
status |
狀態 | PolyvAIAssistantChatStatus |
AI 助手聊天資訊
Event 事件: AIAssistantEvents.AIAssistantChatMessage
回呼參數: Object 物件,詳細類型說明如下
| 屬性名 | 說明 | 類型 |
|---|---|---|
AIChatMsg |
聊天訊息 | PolyvAIAssistantChatMsgType |
替換聊天訊息事件
Event 事件: AIAssistantEvents.ReplaceAIAssistantChatMessage
回呼參數: Object 物件,詳細類型說明如下
| 屬性名 | 說明 | 類型 |
|---|---|---|
id |
需要替換的訊息 Id | string |
AIAssistantChatStatus |
AI 助手聊天狀態 | PolyvAIAssistantChatStatus |
AIChatMsg |
聊天訊息 | PolyvAIAssistantChatMsgType |
