默认直播流的开启,需要调用api接口开始直播,这样之后流地址才会有效。
LiveGBS中可以配置,在播放直播的流的时候,回调一个鉴权接口,鉴权接口返回的状态码,控制该路直播是否能被允许继续播放。如何配置播放鉴权回调呢?看下面的具体说明示例。
该接口由自己的业务系统提供,用于接收,用户播放视频前的回调操作
项目业务系统,提供一个接口地址,用于流媒体服务在播放的时候回调的接口。比如:http://192.168.2.153:8080/authstream
LiveCMS下面配置 livecms.ini->[sip]->stream_auth_url 配置 ,需要重启LiveCMS服务,如:
[sip]
; 直播鉴权第三方回调地址, HTTP GET
; 请求参数: 除透传流地址参数外, 固定参数: app, call, name
; 响应: 200 - 鉴权通过, 其它 - 鉴权不通过
stream_auth_url=http://192.168.2.153:8080/authstream
http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000022_34020000001320000002.flv
为视频流地址,附加鉴权回调的接口需要的参数如:param1、param2
http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000022_34020000001320000002.flv?param1=Cs09vtkMR.04ccf46c56c2371a48¶m2=testsssssss
使用播放器播放上述 附加鉴权参数后 的地址
LiveGBS服务会在用户播放视频流的时候 ,回调已经配置的回到接口,如上配置的播放回调鉴权地址: http://192.168.2.153:8080/authstream
名称 | 描述 |
---|---|
raddr | 客户端远端IP |
app | 应用类型: webrtc (webrtc播放) hls (其它视频流播放) record (M3U8录像播放) snap (快照获取) |
call | 操作类型:play |
name | 资源唯一标记: 如视频ID、快照名称 |
其它自定义入参 | 自定义的入参:如上面示例的 param1、param2,名称根据需要自定义 |
详细的回调请求示例如下:
http://192.168.2.153:8080/authstream?raddr=192.168.2.136&app=hls&call=play&name=34020000001110000022_34020000001320000002¶m1=Cs09vtkMR.04ccf46c56c2371a48¶m2=testsssssss
播放前回调鉴权传递参数,说明如下:
raddr=192.168.2.136 客户端远端IP
app=hls 应用类型
call=play 操作
name=34020000001110000022_34020000001320000002 资源唯一标记(视频流)
param1和param2是自定义附加的,可以自定义参数名,播放回调时会透传后来用于自定义的鉴权逻辑
播放视频 或是 请求快照展示,会回调接口:
此时请求的接口,返回的HTTP 状态码是 200 ,就继续播放,播放器开始播放 或是 展示快照
播放视频 或是 请求快照展示,会回调接口:
此时请求的接口,返回的HTTP 状态码不是 200 ,将阻止播放,播放器无法播放 或是 无法展示快照
- 重要说明
param1=Cs09vtkMR.04ccf46c56c2371a48¶m2=testsssssss 是示例附加传参,回调会传递附加的所有参数,不限定个数和名称
可以在回调接口里面,判断 app == snap ,针对快照的回调直接返回 200,如下示例
...
var app = getQueryParma("app);
if (app == "snap") {
res.code = 200
res.status = "OK"
}
...
可以在回调接口里面,判断 app == record ,针对快照的回调直接返回 200,如下示例
...
var app = getQueryParma("app);
if (app == "record") {
res.code = 200
res.status = "OK"
}
...