腾讯云互动白板实时录制事件-教育服务解决方案
录制开始
事件名称OnlineRecordStarted 事件说明当实时录制服务准备完成,开始录制时通知 App 后台EventData 结构定义:
参数名称 | 类型 | 描述 |
TaskId | String | 录制已开始的实时录制 TaskId |
RoomId | Integer | 实时录制的房间 Id |
RecordUserId | String | 当前任务用于实时录制服务进房的用户 Id |
示例
{ "EventData": { "RecordUserId": "tic_record_user_1253_01", "RoomId": 1253, "TaskId": "bj0mt2l23osdj300hl30" }, "EventType": "OnlineRecordStarted", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
录制停止
事件名称OnlineRecordStopped事件说明当用户主动调用停止录制接口或者由于其他原因自动停止录制时通知 App 后台EventData结构定义:
参数名称 | 类型 | 描述 |
TaskId | String | 录制已停止的实时录制 TaskId |
RoomId | Integer | 实时录制的房间 Id |
RecordUserId | String | 当前任务用于实时录制服务进房的用户 Id |
示例
{ "EventData": { "RecordUserId": "tic_record_user_1253_01", "RoomId": 1253, "TaskId": "bj0mt2l23osdj300hl30" }, "EventType": "OnlineRecordStopped", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
录制结果回调
事件名称OnlineRecordFinished事件说明当实时录制完成时通知 App 后台EventData结构定义:
参数名称 | 类型 | 描述 |
TaskId | String | 录制结束的实时录制任务 Id |
RoomId | Integer | 房间号 |
GroupId | String | 白板的群组 Id |
RecordUserId | String | 录制用户 Id |
FinishReason | String | 录制结束原因 – AUTO: 房间内长时间没有音视频上行及白板操作导致自动停止录制 – USER_CALL: 主动调用了停止录制接口 – EXCEPTION: 录制异常结束 |
RecordStartTime | Integer | 实际开始录制时间,Unix 时间戳,单位秒 |
RecordStopTime | Integer | 实际停止录制时间,Unix 时间戳,单位秒 |
TotalTime | Integer | 回放视频总时长(单位:毫秒) |
ExceptionCnt | Integer | 录制过程中出现异常的次数 |
OmittedDurations | Array of OmittedDuration | 拼接视频中被忽略的时间段,只有开启视频拼接功能的时候,这个参数才是有效的 |
VideoInfos | Array of VideoInfo | 录制视频列表 |
Error.Code | String | 如果实时录制发生错误会有该字段,具体错误码描述请参考接口文档 查询实时录制任务 |
Error.Message | String | 如果实时录制发生错误的具体错误描述 |
示例示例1 实时录制成功的回调
{ "EventData": { "TaskId": "ghucnligqtgtvk2624mb", "RoomId": 880528, "GroupId": "880528", "RecordUserId": "tic_record_user_880528_test-01", "FinishReason": "USER_CALL", "RecordStartTime": 1568949369, "RecordStopTime": 1568949392, "TotalTime": 18317, "ExceptionCnt": 0, "OmittedDurations": [], "VideoInfos": [ { "UserId": "Mac_trtc_04", "VideoDuration": 17969, "VideoFormat": "mp4", "VideoId": "dace3518e865e76a9e36712c629822ba", "VideoPlayTime": 0, "VideoSize": 593418, "VideoType": 0, "VideoUrl": "http://online-recording-1259648581.file.myqcloud.com/00sp43mantgtv4r842mb/d124f518e865e76a9e36712c629822ba.mp4" }, { "UserId": "tic_mixstream_880528_101", "VideoDuration": 18205, "VideoFormat": "mp4", "VideoId": "763d1f6b8679c3f17fb118bd37d05c85", "VideoPlayTime": 3, "VideoSize": 765545, "VideoType": 3, "VideoUrl": "http://online-recording-1259648581.file.myqcloud.com/00sp43mantgtv4r842mb/763d1f6b86724f51fb118bd37d05c85.mp4" }, { "UserId": "tic_mixstream_880528_3", "VideoDuration": 18222, "VideoFormat": "mp4", "VideoId": "1b9623df0516dc7318df89f6e7fffc1e", "VideoPlayTime": 95, "VideoSize": 402038, "VideoType": 3, "VideoUrl": "http://online-recording-1259648581.file.myqcloud.com/00sp43mantgtv4r842mb/1b9623df05124f51318df89f6e7fffc1e.mp4" }, { "UserId": "", "VideoDuration": 17605, "VideoFormat": "mp4", "VideoId": "a8152f8faa2cfe621dc965a066a5813c", "VideoPlayTime": 623, "VideoSize": 226337, "VideoType": 2, "VideoUrl": "http://online-recording-1259648581.file.myqcloud.com/00sp43mantgtv4r842mb/a815224f512cfe621dc965a066a5813c.mp4" } ] }, "EventType": "OnlineRecordFinished", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
示例2 实时录制失败的回调
{ "EventData": { "Error": { "Code": "FailedOperation.Record", "Message": "code: 40001, msg: 2020-05-21 15:20:06, invalid userid\n" }, "ExceptionCnt": 0, "FinishReason": "EXCEPTION", "GroupId": "880528", "OmittedDurations": [], "RecordStartTime": 0, "RecordStopTime": 1590045606, "RecordUserId": "tic_record_user_880528_test-01", "RoomId": 880528, "TaskId": "ghucnligqtgtvk2624mb", "TotalTime": 0, "VideoInfos": [] }, "EventType": "OnlineRecordFinished", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
长时间暂停告警
事件名称OnlineRecordLongPauseWarning事件说明实时录制暂停超过30分钟会自动停止,当暂停了20分钟时,会通知 App 后台处理该任务EventData结构定义:
参数名称 | 类型 | 描述 |
TaskId | String | 录制已开始的实时录制 TaskId |
RoomId | Integer | 实时录制的房间 Id |
RecordUserId | String | 当前任务用于实时录制服务进房的用户 Id |
PauseTime | Integer | 暂停时间,Unix 时间戳,单位秒 |
EstimateStopTime | Integer | 预计自动停止时间,Unix 时间戳,单位秒 |
示例
{ "EventData": { "TaskId": "bj0mt2l23osdj300hl30", "RoomId": 1253, "RecordUserId": "tic_record_user_1253_01", "PauseTime": 1575545412, "EstimateStopTime": 1575546412 }, "EventType": "OnlineRecordLongPauseWarning", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
长时间暂停自动结束
事件名称OnlineRecordLongPauseForceStopped事件说明实时录制暂停超过30分钟会自动停止,会通知 App 后台已经自动停止当前任务EventData结构定义:
参数名称 | 类型 | 描述 |
TaskId | String | 录制已开始的实时录制 TaskId |
RoomId | Integer | 实时录制的房间 Id |
RecordUserId | String | 当前任务用于实时录制服务进房的用户 Id |
PauseTime | Integer | 暂停时间,Unix 时间戳,单位秒 |
StopTime | Integer | 自动停止时间,Unix 时间戳,单位秒 |
示例
{ "EventData": { "TaskId": "bj0mt2l23osdj300hl30", "RoomId": 1253, "RecordUserId": "tic_record_user_1253_01", "PauseTime": 1575545412, "StopTime": 1575546412 }, "EventType": "OnlineRecordLongPauseForceStopped", "ExpireTime": 1590046391, "SdkAppId": 1400000001, "Sign": "a2dabb362a9b811c0e26953a6276a41c", "Timestamp": 1575545412}
腾讯云官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
发表评论