在线媒体流说明文档

输入在线媒体流回调

服务端输入在线媒体流回调支持将您使用输入在线媒体流 REST API 产生输入在线媒体流的事件，以 HTTP 请求的形式通知到您的服务器。

配置信息

在推流至语音频道传入 stream_url 参数，配置完成后即可接收事件回调通知。

超时重试

事件回调服务器在发送消息通知后，5秒内没有收到您的服务器的响应，即认为通知失败。失败后会以10秒的间隔继续重试，直到消息存续时间超过1分钟，不再重试。

事件回调消息格式

事件回调消息以 HTTP/HTTPS POST 请求发送给您的服务器，其中：
字符编码格式：UTF-8。
请求：body 格式为 JSON。
应答：HTTP STATUS CODE = 200，服务端忽略应答包具体内容。
包体示例：下述为“输入在线媒体流开始成功”事件的包体示例。

{
        "EventGroupId": 7,
        "EventType":    701,
        "CallbackMsTs":   1701937900012,
        "EventInfo":    {
                "EventMsTs": 1701937900013,
                "TaskId":"xx",
                "Status":0
        }
}

参数说明

回调消息参数

Header 中包含以下字段：

字段名	值
`Content-Type`	`application/json`
`Sign`	签名值
`SdkAppId`	SDK Application ID

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	状态码

推流至语音频道

接口约定

operator 为操作者的UID, 如小明使用了 /点歌 指令, 此处应为小明的UID

stream_url 为形如 https://a.b/test.mp4 的音频直链

一个频道同时只能有一个推送中的媒体流

接口地址

推流至语音频道

停止推流至语音频道

接口地址

停止推流至语音频道

输入在线媒体流回调#

配置信息#

超时重试#

事件回调消息格式#

参数说明#

回调消息参数#

Header 中包含以下字段：#

Body 中包含以下字段：#

事件组 ID 对照表#

事件类型对照表#

当 EventType = 701 (EVENT_TYPE_STREAM_INGEST_START) 时，EventInfo 字段定义如下：#

推流至语音频道#

接口约定#

接口地址#

停止推流至语音频道#

接口地址#

输入在线媒体流回调

配置信息

超时重试

事件回调消息格式

参数说明

回调消息参数

Header 中包含以下字段：

Body 中包含以下字段：

事件组 ID 对照表

事件类型对照表

当 `EventType = 701` (`EVENT_TYPE_STREAM_INGEST_START`) 时，`EventInfo` 字段定义如下：

推流至语音频道

接口约定

接口地址

停止推流至语音频道

接口地址