IConversationalAIAPIEventHandler 类

onMessageError

Kotlin
fun onMessageError(agentUserId: String, error: MessageError)

消息处理出错回调。

该回调在消息处理过程中发生错误时触发。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`error`	`MessageError`	消息错误信息，包含错误类型和错误内容。详见 `MessageError`。

onMessageReceiptUpdated

Kotlin
fun onMessageReceiptUpdated(agentUserId: String, receipt: MessageReceipt)

消息回执更新回调。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`receipt`	`MessageReceipt`	消息回执信息。详见 `MessageReceipt`。

onAgentStateChanged

Kotlin
fun onAgentStateChanged(agentUserId: String, event: StateChangeEvent)

智能体状态变化回调。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`event`	`StateChangeEvent`	状态变化事件，详见 `StateChangeEvent`。

onAgentListeningChanged

Kotlin
fun onAgentListeningChanged(agentUserId: String, isListening: Boolean)

智能体倾听状态变化回调。

该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在倾听用户输入。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`isListening`	`Boolean`	智能体当前是否处于倾听状态。

onAgentThinkingChanged

Kotlin
fun onAgentThinkingChanged(agentUserId: String, isThinking: Boolean)

智能体思考状态变化回调。

该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在思考或处理请求。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`isThinking`	`Boolean`	智能体当前是否处于思考状态。

onAgentSpeakingChanged

Kotlin
fun onAgentSpeakingChanged(agentUserId: String, isSpeaking: Boolean)

智能体说话状态变化回调。

该回调是对 onAgentStateChanged 的细粒度补充，用于监听智能体是否正在播报语音。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`isSpeaking`	`Boolean`	智能体当前是否处于说话状态。

onAgentInterrupted

Kotlin
fun onAgentInterrupted(agentUserId: String, event: InterruptEvent)

中断事件回调。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`event`	`InterruptEvent`	中断事件，详见 `InterruptEvent`。

onAgentMetrics

Kotlin
fun onAgentMetrics(agentUserId: String, metric: Metric)

性能指标回调。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`metric`	`Metric`	性能指标。详见 `Metric`。

onAgentError

Kotlin
fun onAgentError(agentUserId: String, error: ModuleError)

智能体错误回调。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`error`	`ModuleError`	错误信息。详见 `ModuleError`。

onTranscriptUpdated

Kotlin
fun onTranscriptUpdated(agentUserId: String, transcript: Transcript)

转写内容更新回调。

注意

该回调可能会高频触发。如需去重，请在业务层处理。

参数

参数	数据类型	描述
`agentUserId`	`String`	智能体用户 ID。
`transcript`	`Transcript`	转写数据。详见 `Transcript`。

onDebugLog

Kotlin
fun onDebugLog(log: String)

内部调试日志回调。

参数

参数	数据类型	描述
`log`	`String`	调试日志信息。