服务端事件通知
服务端事件通知简介
- 易视云视频服务器提供HTTP回调通知的方式,将直播流的状态主动通知给视频服务使用者。
- HTTP回调的基本流程是:服务使用者后台搭建一个HTTP服务来接收回调,服务使用者将回调URL发送给易视云商务人员进行回调配置;当直播流状态发生改变时,易视云视频服务端会向该URL发起HTTP GET请求,具体内容将通过HTTP参数送达APP后台。
流状态通知
接口说明
名称 |
内容 |
接口名称 |
由服务使用者提供 |
功能说明 |
通知服务使用者直播状态变化 |
服务器地址 |
由服务使用者提供 |
请求方式 |
GET |
参数说明
参数名称 |
必填 |
类型 |
说明 |
appid |
是 |
String |
服务使用者对应的appid |
lid |
是 |
String |
直播或录播的唯一标识,流id |
module |
是 |
String |
模块,标识直播状态或录播状态 |
from |
否 |
String |
来源,标识文件录制或文件存储 |
state |
是 |
int |
状态值,详见以下状态说明 |
fid |
否 |
String |
生成录播文件名 |
size |
否 |
String |
生成录播文件大小 |
dura |
否 |
String |
生成录播视频的时长 |
msg |
否 |
String |
当次通知说明 |
- 直播状态通知
- module为live时表示直播状态通知
- state参数值及说明如下
- -1,流退出
- 0,流开始前
- 1,流开始
- 2,流断开
- 3,流暂时停止推送
- 录播状态通知
- moudle为file且from为record时表示录播状态通知
- state参数值及说明如下
- -1,录播文件已放弃
- 0,录播文件创建中
- 1,录播文件创建完成
- 2,录播文件尝试创建中
- 当state为1时,会附加fid/size/dura等录播文件信息