发布媒体事件通知
POST /strm/publish_strm_notif
本接口供企业应用在特定事件发生后向媒体服务中已经打开指定终端媒体通道的客户端发布媒体事件通知。 本通道和常规由媒体服务发出的媒体事件通知一样,是通过websocket端口来进行通知,没有通过websocket订阅事件的客户端不会获得通知, 与指定终端媒体通道不相关的客户端也不会获得通知。
目前只允许发布act
为sent
, 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
}
请求实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
act | string | Y | 通知的类型:
act 为sent , failed 的通知。 |
typ | string | Y | 流的类型:
|
reqId | string | Y | 请求ID。 |
simNo | string | Y | 终端识别号 |
chan | int | Y | 音视频逻辑通道号(参见JT/T 1076-2016 表2) |
目前只允许企业应用通过本接口发布act
为sent
, failed
的两种通知。
应答
{
"errCode": 0,
"message": "OK."
}
应答实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
errCode | int | Y | 错误码。 |
message | string | Y | 错误信息 |