配置录制回调
SparkRTC服务提供了录制任务状态回调设置，支持配置HTTP/HTTPS URL，向用户服务器发送POST请求，将录制任务状态信息实时反馈到用户服务器。
回调协议
- 请求：HTTP POST请求，请求Body的内容为JSON格式。
- 应答：HTTP STATUS CODE = 200，应答内容为JSON格式，用户可以根据实际需求自定义应答内容。
前提条件
已添加应用。
操作步骤
回调示例
录制文件生成事件回调示例如下。回调消息体字段如表1所示。
{
"event_type": "RECORD_FILE_COMPLETE",
"stream_name": "mystream",
"record_format": "HLS",
"download_url": "https://abc-rtc-bucket2.obs.cn-north-4.myhuaweicloud.com/Record/Record/5fcdf5651xxxxxx6f835d0d4.SparkRTC.myhuaweicloud.com/live/continuous_record/hls/mystream_2021-04-28-08-57-07/mystream_2021-04-28-08-57-07.m3u8",
"file_size": 26254952,
"record_duration": 65,
"start_time": "2021-04-28T08:56:57Z",
"end_time": "2021-04-28T08:58:02Z",
"width": 1280,
"height": 720,
"obs_location": "http://obs.cn-north-4.myhuaweicloud.com",
"obs_bucket": "abc-rtc-bucket2",
"obs_object": "Record/Record/5fcdf5651xxxxxx6f835d0d4.SparkRTC.myhuaweicloud.com/live/continuous_record/hls/mystream_2021-04-28-08-57-07/mystream_2021-04-28-08-57-07.m3u8",
"app_id": "5fcdf5651xxxxxx6f835d0d4",
"job_id": "608196a2fa1xxxxxx515147f32ef463b",
"room_id": "room01"
}
字段 |
描述 |
|---|---|
event_type |
通知事件类型。 取值如下：
|
stream_name |
录制的流名。 |
record_format |
录制格式，支持HLS和MP4格式。 |
download_url |
录制文件在OBS中的下载地址。当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。
说明：
该下载地址禁止用于录制文件的播放。 |
file_size |
文件大小。 单位：Byte。 |
record_duration |
录制文件的时长。 单位：秒。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
start_time |
录制文件的开始时间，即接收到第一帧数据的时间，格式为YYYY-MM-DDThh:mm:ssZ，UTC时间。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
end_time |
录制文件的结束时间，格式为YYYY-MM-DDThh:mm:ssZ，UTC时间。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
width |
录制文件分辨率的宽。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
height |
录制文件分辨率的高。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
obs_location |
存储录制文件的OBS桶所在区域。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
obs_bucket |
存储录制文件的OBS桶。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
obs_object |
OBS桶存储录制文件的路径。 当“event_type”为“RECORD_FILE_COMPLETE”时，携带该字段。 |
app_id |
应用ID。 |
job_id |
录制任务编号，可以用于修改、查看或停止录制任务。 |
room_id |
房间ID。 |
detail_message |
录制任务状态描述信息。 |
