tencent cloud

游戏多媒体引擎

产品动态
产品介绍
产品概述
优势特性
产品功能
应用场景
安全合规认证
新手指引
产品计费
免费额度
购买指南
SDK 下载指引
产品功能体验
基本功能演示
场景化 Demo 体验
控制台指南
用量查看
服务开通
快速入门
快速接入 SDK
快速接入 Sample Project
基础功能开发指南
鉴权密钥
实时语音角色设置
音质选择
进阶功能开发指南
服务端录制
万人范围语音
3D 音效
音效与伴奏
网络音频流转发路由
自定义消息通道
如何应对公司防火墙限制
语言参数参考列表
房间管理功能
客户端 API
Unity SDK
Unreal Engine SDK
Cocos2D SDK
Windows SDK
iOS SDK
Android SDK
macOS SDK
H5SDK
Electron SDK
Flutter SDK
SDK 版本升级指引
错误码
编译工具链文档
服务端 API
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
常见问题
产品功能问题
问题解决指南
计费相关问题
Sample Project 使用问题
一般性问题
鉴权相关问题
实时语音进房失败问题
实时语音无声及音频问题
网络问题
语音转文本问题
工程导出问题
服务协议
服务等级协议
联系我们
词汇表
GME 政策
数据处理和安全协议
隐私协议

录制回调说明

PDF
聚焦模式
字号
最后更新时间: 2025-08-26 15:58:58

服务端录制回调说明

说明

受网络影响,您的服务器收到的通知顺序和事件发生的顺序可能不完全一致。我们的服务有重试机制,但仍不能保证所有的消息都能到达。考虑到以上两点,不建议您业务的核心业务逻辑依赖消息通知服务。

网络协议

如果在控制台配置了回调地址,即一个 HTTP(S) 协议接口的 URL,则需要支持 POST 方法,传输数据编码采用 UTF-8。

HTTP 头参数

名称
类型
是否必需
描述
Signature
string
签名,具体见下方 签名生成 说明

签名生成

Signature = HMAC-SH1 ( strContent, SecretKey )
strContent:签名原文串,为 body 的整个 JSON 内容(长度以 Content-Length 为准)。
body:回调给业务的 JSON 内容,下方 回调示例 中的全部内容即为 body。
SecretKey:密钥,为应用的权限密钥,可通过 控制台 > 应用详情 查看。
HMAC-SH1:签名算法。

回调参数

名称
类型
描述
BizID
Integer
应用的 AppID,可通过控制台 > 应用详情 查看。
RoomID
String
房间 ID
UserID
String
用户 ID
RecordMode
Integer
录制模式
0:单流
1:混流
Timestamp
Integer
发送回调时的时间戳(s)
TaskID
Integer
云录制服务分配的任务 ID。任务 ID 是对一次录制生命周期过程的唯一标识,结束录制时会失去意义。当您使用自定义录制模式时,任务 ID 可以在开始录制时通过响应参数获取,需要业务保存下来,作为下次针对这个录制任务操作的请求参数。
EventType
Integer
事件类型
Detail
事件详情,由 EventType 决定格式

EventDetail 事件详情说明

EventType
说明
Detail
1
音频文件启动录制
SeqNo:Number,分片序号
FileName:String,文件名
2
音频文件完成录制
SeqNo:Number,分片序号
FileName: String,文件名
3
音频文件上传完成
SeqNo:Number,分片序号
FileName:String,文件名

回调示例

{
"BizID":1400000000,
"RoomID":"100",
"UserID":"999",
"TaskID":446946705284000000,
"RecordMode":1,
"Timestamp":1675930605,
"EventType":1,
"Detail":{
"SeqNo":0,
"FileName":"1400000000_100_999/2023-02-09-16-16-45_446946705284000000_audio.mp3"
}
}


帮助和支持

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

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

文档反馈