录制状态变更之后回调

Download

聚焦模式

字号

最后更新时间： 2026-08-12 16:56:37

功能说明
App 后台可以通过该回调实时监控云端录制任务的状态变化。
注意事项
要启用回调，必须通过 REST API 配置回调 URL，并打开本条回调协议对应的开关，配置方法详见 设置回调配置 文档。
回调的方向是 TRTC 后台向 App 后台发起 HTTP POST 请求。
App 后台在收到回调请求之后，务必校验请求 URL 中的参数 SDKAppID 是否是自己的 SDKAppID。
可能触发该回调的场景
云端录制任务状态变更。
回调发生时机
云端录制任务状态发生变更之后。
接口说明
请求 URL 示例
以下示例中 App 配置的回调 URL 为 https://www.example.com。
示例：
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform
请求参数说明
参数
说明
https
请求协议为 HTTPS，请求方式为 POST。
www.example.com
回调 URL。
SdkAppid
创建应用时在 TRTC 控制台分配的 SDKAppID。
CallbackCommand
固定为 Call.CallbackAfterRecordChanged。
contenttype
固定值为 json。
ClientIP
客户端 IP，格式如：127.0.0.1。
OptPlatform
客户端平台，取值参见 第三方回调简介 中 OptPlatform 的参数含义。
请求包示例及参数说明
{
    "CallId": "f6273604-3806-4abb-bc7e-090cd9208ee6",
    "Callback": {
        "EventGroupId": 3,
        "EventType": 301,
        "CallbackTs": 1774425607091,
        "EventInfo": {
            "RoomId": "1280586498",
            "EventTs": 1774425607,
            "UserId": "callkit_1500099430_record_1280586498",
            "TaskId": "-nHuqHlU7islZCDCjMne7HY2TJoU1NbbDkHjVoK-yqHu8ZWQndibQJtEhvB6ShqolkmNmnxz7AE.",
            "Payload": {
                "Status": 0
            },
            "EventMsTs": 1774425607077
        },
        "KitType": 2
    },
    "CallbackCommand": "Call.CallbackAfterRecordChanged",
    "EventTime": 1774425607149
}
请求包字段说明：
字段名
类型
含义
CallbackCommand
String
回调命令字。
EventTime
Number
事件触发的毫秒级别时间戳。
CallId
String
通话 ID。
Callback
JsonObject
具体事件信息。
EventGroupId
Number
事件组 ID， 云端录制固定为3，页面录制固定为8。
EventType
Number
回调通知的事件类型。
CallbackTs
Number
事件回调服务器向您的服务器发出回调请求的 Unix 时间戳，单位为毫秒。
EventInfo
JSON Object
事件信息，详细内容可以参考 云端录制回调 EventInfo。
应答包示例
App 后台同步数据后，发送回调应答包。
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0
}
应答包字段说明
字段
类型
属性
说明
ActionStatus
String
必填
请求处理的结果，OK 表示处理成功，FAIL 表示失败。
ErrorInfo
String
必填
错误信息，处理成功时为空字符串。
ErrorCode
Integer
必填
错误码，0 表示忽略应答结果，继续后续流程。
参考
﻿第三方回调简介﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

实时音视频

录制状态变更之后回调

功能说明

注意事项

可能触发该回调的场景

回调发生时机

接口说明

请求 URL 示例

请求参数说明

请求包示例及参数说明

请求包字段说明：

应答包示例

应答包字段说明

参考

帮助和支持

参数	说明
https	请求协议为 HTTPS，请求方式为 POST。
www.example.com	回调 URL。
SdkAppid	创建应用时在 TRTC 控制台分配的 SDKAppID。
CallbackCommand	固定为 `Call.CallbackAfterRecordChanged`。
contenttype	固定值为 `json`。
ClientIP	客户端 IP，格式如：`127.0.0.1`。
OptPlatform	客户端平台，取值参见第三方回调简介中 OptPlatform 的参数含义。

字段名	类型	含义
CallbackCommand	String	回调命令字。
EventTime	Number	事件触发的毫秒级别时间戳。
CallId	String	通话 ID。
Callback	JsonObject	具体事件信息。
EventGroupId	Number	事件组 ID，云端录制固定为3，页面录制固定为8。
EventType	Number	回调通知的事件类型。
CallbackTs	Number	事件回调服务器向您的服务器发出回调请求的 Unix 时间戳，单位为毫秒。
EventInfo	JSON Object	事件信息，详细内容可以参考云端录制回调 EventInfo。

字段	类型	属性	说明
ActionStatus	String	必填	请求处理的结果，OK 表示处理成功，FAIL 表示失败。
ErrorInfo	String	必填	错误信息，处理成功时为空字符串。
ErrorCode	Integer	必填	错误码，0 表示忽略应答结果，继续后续流程。