IConversationalAIAPIEventHandler 类
- Android
更新时间不可用
onMessageError
fun onMessageError(agentUserId: String, error: MessageError)消息处理出错回调。
该回调在消息处理过程中发生错误时触发。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
error | MessageError | 消息错误信息，包含错误类型和错误内容。详见 MessageError。 |
onMessageReceiptUpdated
fun onMessageReceiptUpdated(agentUserId: String, receipt: MessageReceipt)消息回执更新回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
receipt | MessageReceipt | 消息回执信息。详见 MessageReceipt。 |
onUserManualSosEvent
fun onUserManualSosEvent(agentUserId: String, event: UserManualSosEvent)手动 SoS 结果回调。
该回调用于接收服务端返回的手动 SoS 处理结果。服务端成功和失败都会通过该回调返回，业务侧可根据 event.payload.success 判断结果。
该回调有默认空实现，已有接入方无需强制实现。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
event | UserManualSosEvent | 手动 SoS 事件对象。详见 UserManualSosEvent。 |
onUserManualEosEvent
fun onUserManualEosEvent(agentUserId: String, event: UserManualEosEvent)手动 EoS 结果回调。
该回调用于接收服务端返回的手动 EoS 处理结果。服务端成功和失败都会通过该回调返回，业务侧可根据 event.payload.success 判断结果。
该回调有默认空实现，已有接入方无需强制实现。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
event | UserManualEosEvent | 手动 EoS 事件对象。详见 UserManualEosEvent。 |
onAgentManualEosEvent
fun onAgentManualEosEvent(agentUserId: String, event: AgentManualEosEvent)服务端超限自动 EoS 通知回调。
当用户单轮音频持续时间超过服务端阈值时，服务端会主动结束当前用户发言，并通过该回调通知客户端。该事件不是 manualEOS() 的调用结果。
该回调有默认空实现，已有接入方无需强制实现。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
event | AgentManualEosEvent | 服务端超限自动 EoS 事件对象。详见 AgentManualEosEvent。 |
onAgentStateChanged
fun onAgentStateChanged(agentUserId: String, event: StateChangeEvent)智能体状态变化回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
event | StateChangeEvent | 状态变化事件，详见 StateChangeEvent。 |
onAgentListeningChanged
fun onAgentListeningChanged(agentUserId: String, isListening: Boolean)智能体倾听状态变化回调。
该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在倾听用户输入。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
isListening | Boolean | 智能体当前是否处于倾听状态。 |
onAgentThinkingChanged
fun onAgentThinkingChanged(agentUserId: String, isThinking: Boolean)智能体思考状态变化回调。
该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在思考或处理请求。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
isThinking | Boolean | 智能体当前是否处于思考状态。 |
onAgentSpeakingChanged
fun onAgentSpeakingChanged(agentUserId: String, isSpeaking: Boolean)智能体说话状态变化回调。
该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在播报语音。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
isSpeaking | Boolean | 智能体当前是否处于说话状态。 |
onAgentInterrupted
fun onAgentInterrupted(agentUserId: String, event: InterruptEvent)中断事件回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
event | InterruptEvent | 中断事件，详见 InterruptEvent。 |
onAgentMetrics
fun onAgentMetrics(agentUserId: String, metric: Metric)性能指标回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
metric | Metric | 性能指标。详见 Metric。 |
onAgentError
fun onAgentError(agentUserId: String, error: ModuleError)智能体错误回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
error | ModuleError | 错误信息。详见 ModuleError。 |
onTranscriptUpdated
fun onTranscriptUpdated(agentUserId: String, transcript: Transcript)转写内容更新回调。
注意
该回调可能会高频触发。如需去重，请在业务层处理。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
agentUserId | String | 智能体用户 ID。 |
transcript | Transcript | 转写数据。详见 Transcript。 |
onDebugLog
fun onDebugLog(log: String)内部调试日志回调。
参数
| 参数 | 数据类型 | 描述 |
|---|---|---|
log | String | 调试日志信息。 |