回调事件概览

开通消息通知服务后，当你指定要接收通知的事件发生时，声网消息通知服务器会以 HTTP 请求形式向你发送回调。回调的具体内容在请求 Body 中以 JSON 对象形式返回，根据事件不同，请求 Body 中 JSON 对象所包含的字段也不一样。

下面以一个示例说明请求 Body 中的字段：

上图中红色框内字段为消息通知服务请求 Body 的公共字段，所有回调中都包含这些字段，公共字段的含义详见消息通知回调格式。其中 eventType 表示云端录制回调事件的类型。

蓝色框内字段为云端录制事件 payload 中的公共字段，所有的云端录制事件的回调中 payload 都包含这些字段。其中 serviceType 表示该事件与云端录制的哪个服务模块有关，details 则包含具体的事件信息。payload 中包含的字段及详细含义见下文。

payload 字段说明Copy Anchor Link

payload 字段是一个 JSON Object，包含事件的具体内容。云端录制每种类型的事件通知中 payload 都会包含以下字段：

• cname：String 类型，录制的频道名称。
• uid：String 类型，录制使用的用户 ID。
• sid：String 类型，录制 ID，一次云端录制的唯一标识。
• sequence：Number 类型，消息序列号，从 0 开始计数。消息可能乱序到达或者丢失重发，可以通过该参数标识消息。
• serviceScene：String 类型，当前运行的录制场景或录制阶段：
  • "rtc_record"：实时录制。
  • "rtc_snapshot"：截图。
  • "web_record"：页面录制。
• sendts：Number 类型， 事件发生的时间 （UTC 时间）。Unix 时间戳，精确到毫秒。
• serviceType：Number 类型，回调事件服务的类型。
  • 0：云端录制服务
  • 1：录制模块
  • 2：上传模块
  • 6：页面录制
• details：JSON Object，具体的消息内容，详见每个事件的描述。消息通知服务可能会在 details 中新增字段，但为保证兼容，不会改变现有字段的数据格式。

回调事件概览Copy Anchor Link

本节详细介绍云端录制每种回调事件的相关字段。

回调事件详情Copy Anchor Link

你可以参考如下文档，按照业务需要查看云端录制各模块的回调事件：

• 录制服务事件
• 上传模块事件
• 录制模块事件
• 页面录制事件