本文为您介绍实时媒体处理相关事件的事件通知内容及回调示例。

直播文件生成

事件类型

LiveRecordFileCreated

事件通知内容

参数名称 类型 必备项 描述
EventType String 是 事件类型。
UserId Integer 是 用户ID。
EventTime String 是 事件产生时间，为UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。
MessageBody - Object 是 消息体。
duration float 是 录制文件时长，单位：秒。
jobId String 是 UUID格式的录制任务ID。
record_id String 是 UUID格式的录制文件ID。
start_time Long 是 录制文件开始的时间戳。
stop_time Long 是 录制文件结束的时间戳。
uri String 是 录制文件在OSS对应bucket中的储存路径。

回调示例

回调示例说明：
  • 对于HTTP回调，以下内容为HTTP Post Body。
  • 对于MNS回调，以下内容为消息体。
{
    "EventType": "LiveRecordFileCreated",
    "UserId": 123456,
    "EventTime": "2022-06-29T01:36:02Z",
    "MessageBody": {
        "duration": 35.09,
        "jobId": "d6a856d4-ca81-47e8-9d66-*****",
        "record_id": "13a10bbb-f717-4228-9e53-db8f****",
        "start_time": 1656466420,
        "stop_time": 1656466456,
        "uri": "record/d6a856d4-ca81-47e8-9d66-*****/***.m3u8"
    }
}

直播录制状态

事件类型

LiveRecordTaskStatus

事件通知内容

参数名称 类型 必备项 描述
EventType String 是 事件类型。
UserId Integer 是 用户ID。
EventTime String 是 事件产生时间，为UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。
MessageBody - Object 是 消息体。
event String 是 录制事件，取值：
  • record_error：录制任务错误。
  • record_started：开始录制任务。
  • record_paused：暂停录制任务。
  • record_resumed：继续录制任务。
  • record_force_transcode_fail：录制强制转码失败。
jobId String 是 UUID格式的录制任务ID。
session String 否 录制会话ID。
created String 否 录制会话创建时间。
error_info - Object 否 录制错误回调信息。
code String 是 错误码。
message String 是 错误消息。
file_info - Object 否 文件消息。
uri String 是 文件路径。
start_time Long 是 录制文件开始的时间戳。
stop_time Long 是 录制文件结束的时间戳。

回调示例

回调示例说明：
  • 对于HTTP回调，以下内容为HTTP Post Body。
  • 对于MNS回调，以下内容为消息体。
{
    "EventType": "LiveRecordTaskStatus",
    "UserId": 123456,
    "EventTime": "2022-06-29T01:35:32Z",
    "MessageBody": {
        "jobId": "d6a856d4-ca81-47e8-9d66-*****",
        "created": "2022-06-29T01:35:31.716Z",
        "session": "725d15ba-c589-3aeb-a3b6-*****",
        "event": "record_paused"
    }
}

直播截图回调

事件类型

LiveSnapshotFileCreated

事件通知内容

参数名称 类型 必备项 描述
EventType String 是 事件类型。
UserId Integer 是 用户ID。
EventTime String 是 事件产生时间，为UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。
MessageBody - Object 是 消息体。
SnapshotUrl String 是 截图文件地址。
jobId String 是 UUID格式的录制任务ID。
StreamInputUrl String 是 直播流名。
Bucket String 是 OSS bucket名称。
Height Integer 是 截图高度，单位：px。
Width Integer 是 截图宽度，单位：px。
Endpoint String 是 OSS Endpoint。
Object String 是 OSS对象储存路径。
Size Integer 是 文件大小，单位：Byte。

回调示例

回调示例说明：
  • 对于HTTP回调，以下内容为HTTP Post Body。
  • 对于MNS回调，以下内容为消息体。
{
    "MessageBody": {
        "SnapshotUrl": "http://example.com/bucket/snapshot.jpg",
        "JobId": "cef3de8c-b02c-4462-ad02-****",
        "StreamInputUrl": "rtmp://example.com/app/stream",
        "Bucket": "OssBucket",
        "Height": 720,
        "Width": 1280,
        "Endpoint": "oss-cn-shanghai.aliyuncs.com",
        "Object": "app/snapshot.jpg",
        "Size": 50000
    },
    "EventTime": "2022-08-08T09:10:02Z",
    "UserId": 123456,
    "EventType": "LiveSnapshotFileCreated"
}