腾讯云智能数智人查询会话状态-服务端 API 接入-文档中心-腾讯云

接口说明
查询指定会话的当前状态。
调用协议
HTTPS + JSON
POST /v2/ivh/sessionmanager/sessionmanagerservice/statsession
Header Content-Type: application/json;charset=utf-8
请求参数
参数名称
必选
类型
描述
ReqId
是
String
单次请求唯一标识，长度为32的 uuid。
SessionId
是
String
会话唯一标识。
返回参数
参数名称
必选
类型
描述
ReqId
是
String
单次请求唯一标识。
SessionStatus
是
int
会话状态。1：进行中(已就绪)，2：已关闭，3：准备中(未就绪)，4：创建会话失败
PlayStreamAddr
否
string
流播放地址。
SpeakStatus
否
string
数智人状态:
Initial：初始状态。
WaitingTextStart：等待文本播报开始。
TextStart：文本播报中。
WaitingTextOver：等待文本播报结束。
TextOver：文本播报结束。
WaitingAudioStart：等待音频开始播报。
AudioStart：音频开始播报。
WaitingAudioOver：等待音频播报结束。
AudioOver：音频播报结束。
Error：驱动错误（与 TextOver 和 AudioOver 含义一样表示一次驱动的终态），仅表示最近一次驱动失败，不影响继续发送驱动命令。
IsSessionStarted
是
bool
是否已经开启会话，只有开启状态，才可以发送驱动指令。
注意：
返回 false 时，需要调用开启会话接口进行开启。
ErrorCode
是
int
当前状态对应的错误码，0为正常。错误码列表参考错误码﻿
ErrorMessage
否
string
当前状态对应的错误信息。
请求示例
{
    "Header": {},
    "Payload": {
        "ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
        "SessionId": "m318552187863054171"
    }
}
返回示例
{
    "Header": {
        "Code": 0,
        "Message": "",
        "RequestID": "s34d23f4fd5hvdbsqfd5be5g8c5fg7h1"
    },
    "Payload": {
        "ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
        "SessionStatus": 1,
        "PlayStreamAddr": "rtmp://live.qq.com/live/m789",
        "SpeakStatus": "TextOver",
        "IsSessionStarted": true,
        "ErrorCode": 0,
        "ErrorMessage": ""
    }
}
﻿

参数名称	必选	类型	描述
ReqId	是	String	单次请求唯一标识，长度为32的 uuid。
SessionId	是	String	会话唯一标识。

查询会话状态

本页目录：

接口说明

调用协议

请求参数

返回参数

请求示例

返回示例