在线媒体流说明文档
输入在线媒体流回调
配置信息
stream_url 参数，配置完成后即可接收事件回调通知。超时重试
事件回调消息格式
字符编码格式：UTF-8。
请求：body 格式为 JSON。
请求头: 线路1和线路2的回调格式不同 通过
SDK-Type区分 线路一为trtc 线路二为volc应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容。
包体示例：下述为“trtc 输入在线媒体流开始成功”事件的包体示例。
参数说明
回调消息参数
Header 中包含以下字段：
| 字段名 | 值 |
|---|---|
Content-Type | application/json |
SDK-Type | trtc/volc |
trtc
Body 中包含以下字段：
| 字段名 | 类型 | 含义 |
|---|---|---|
EventGroupId | Number | 事件组 ID，混流转推事件固定为 4 |
EventType | Number | 回调通知的事件类型 |
CallbackMsTs | Number | 事件回调服务器向您的服务器发出回调请求的 Unix 时间戳（毫秒） |
EventInfo | JSON Object | 事件信息对象 |
事件组 ID 对照表
| 字段名 | 值 | 含义 |
|---|---|---|
EVENT_GROUP_STREAM_INGEST | 7 | 输入在线媒体流事件组 |
事件类型对照表
| 字段名 | 值 | 含义 |
|---|---|---|
EVENT_TYPE_STREAM_INGEST_START | 701 | 输入在线媒体流开始 |
EVENT_TYPE_STREAM_INGEST_STOP | 702 | 输入在线媒体流停止 |
当 EventType = 701 (EVENT_TYPE_STREAM_INGEST_START) 时，EventInfo 字段定义如下：
| 字段名 | 类型 | 含义 |
|---|---|---|
EventMsTs | String | 事件发生的 Unix 时间戳（单位为毫秒） |
TaskId | String | 输入在线媒体流任务 ID |
Status | Number | 状态码 |
volc
EventType为RelayStreamStateChangedEventData
| 参数名 | 类型 | 示例值 | 描述 |
|---|---|---|---|
RoomId | String | Your_RoomId | 房间 ID，是房间的唯一标志 |
TaskId | String | Your_TaskId | 任务 ID |
UserId | String | Your_UserId | 在线媒体流对应的 UserId |
StreamUrl | String | rtmp://xxx | 在线流媒体地址 |
Status | Int | 1 | 任务状态： 1：待机中 2：连接中 3：运行中 4：已停止 5：重试中 |
StartTimeStamp | Int | 0 | 任务起始时间戳，用于定时播放，Unix时间，单位为秒。默认为 0，表示立即启动。 |
Msg | String | / | 描述信息 |
Reason | Int | 1 | 任务停止原因，仅当 Status = 4 时有效：1：空闲超时 2：停止接口调用 3：流播放结束 4：内部错误 5：url 地址异常 6：编码格式不支持 7：token 错误 8：没有发布权限 9：被移除房间 |
推流至语音频道
接口约定
operator 为操作者的UID, 如小明使用了 /点歌 指令, 此处应为小明的UIDstream_url 为形如 https://a.b/test.mp4 的音频直链RoomId为黑盒语音的channel_idAAC、Opus的音频媒体接口地址
停止推流至语音频道
接口地址
修改于 2025-07-25 07:54:06