跳到主要内容
版本:3.4.4

发布媒体事件通知

POST /strm/publish_strm_notif

本接口供企业应用在特定事件发生后向媒体服务中已经打开指定终端媒体通道的客户端发布媒体事件通知。 本通道和常规由媒体服务发出的媒体事件通知一样,是通过websocket端口来进行通知,没有通过websocket订阅事件的客户端不会获得通知, 与指定终端媒体通道不相关的客户端也不会获得通知。

目前只允许发布actsent, failed两种类型的通知,且媒体服务未对这两种事件做特殊的业务处理,只是将这两种通知经由 POST /strm_notif SPI接口转而通知企业应用,故此两种类型通知是可选性,如果企业端应用没对这两种事件处理的需求, 或使用其它事件传递路径,则可以不使用本接口。

请求

POST https://n11.gratour.info:7011/strm/publish_strm_notif
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4

{
"act": "changeCodeStrm",
"typ": "live",
"simNo": "13320200317",
"chan": 1,
"codeStrm": 1
}

请求实体属性

属性数据类型必要说明
actstringY通知的类型:
  • sent: 下发指令(当终端未及时推流时,服务端可能多次下发指令,因此此通知也可能多次推送)。
  • failed: 终端指令失败(终端不在线或终端应答提出指令已经失败)。
目前只允许发布actsent, failed的通知。
typstringY流的类型:
  • live: 表示流为直播流
  • replay: 表示流为回放流
reqIdstringY请求ID。
simNostringY终端识别号
chanintY音视频逻辑通道号(参见JT/T 1076-2016 表2)

目前只允许企业应用通过本接口发布actsent, failed的两种通知。

应答

{
"errCode": 0,
"message": "OK."
}

应答实体属性

属性数据类型必要说明
errCodeintY错误码。
messagestringY错误信息