GB28181国标视频监控平台LiveGBS用户自定义播放回调鉴权，允许用户按照自己的业务逻辑控制播放权限
GB28181流媒体平台LiveGBS中有是否需要用户登录认证才可播放视频的选项控制。但是很多情况不能满足实际项目使用场景中对播放权限的控制，允许谁播不允许谁播等可能有更详细的控制。为此LiveGBS提供了用户自定义鉴权的回调设置，支持用户自己去管理这些权限。当收到播放请求时，LiveGBS会将播放携带的用户自定义参数传给回调接口，回调接口中返回200 OK，LiveGBS就允许播放，返回400 Bad Request，LiveGBS就不允许播放。
1、直播流安全控制
1.1、直播流开启控制
默认直播流的开启，需要调用api接口开始直播，这样之后流地址才会有效。
1.2、直播流回调鉴权
LiveGBS中可以配置，在播放直播的流的时候，回调一个鉴权接口，鉴权接口返回的状态码，控制该路直播是否能被允许继续播放。如何配置播放鉴权回调呢？看下面的具体说明示例。
2、配置播放鉴权回调
2.1、准备回调鉴权接口
该接口由自己的业务系统提供，用于接收，用户播放视频前的回调操作
项目业务系统，提供一个接口地址，用于流媒体服务在播放的时候回调的接口。比如：http://192.168.2.153:8080/authstream
2.2、配置回调鉴权地址
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
2.3、调试说明
2.3.1、调试环境
- 流媒体服务视频源IP: 192.168.2.135
- 客户端访问IP：192.168.2.136
- 回调鉴权接口IP: 192.168.1.11
2.3.2、调用示例
2.3.2.1、视频流地址
2.3.2.2、附加鉴权参数
为视频流地址，附加鉴权回调的接口需要的参数如：param1、param2
2.3.2.3、播放器播放
使用播放器播放上述 附加鉴权参数后的地址
2.3.2.4、回调请求鉴权
LiveGBS服务会在用户播放视频流的时候，回调已经配置的回到接口，如上配置的播放回调鉴权地址： http://192.168.2.153:8080/authstream
2.3.2.4.1、回调请求参数-说明
| 名称 | 描述 |
|---|---|
| raddr | 客户端远端IP |
| app | 应用类型： webrtc (webrtc播放) hls (其它视频流播放) record (M3U8录像播放) snap (快照获取) |
| call | 操作类型：play |
| name | 资源唯一标记： 如视频ID、快照名称 |
| 其它自定义入参 | 自定义的入参：如上面示例的 param1、param2，名称根据需要自定义 |
2.3.2.4.2、回调请求参数-示例
详细的回调请求示例如下：
播放前回调鉴权传递参数，说明如下：
raddr=192.168.2.136 客户端远端IP
app=hls 应用类型
call=play 操作
name=34020000001110000022_34020000001320000002 资源唯一标记（视频流）
param1和param2是自定义附加的，可以自定义参数名，播放回调时会透传后来用于自定义的鉴权逻辑
2.3.2.4.1、开始播放
播放视频 或是 请求快照展示，会回调接口：
此时请求的接口，返回的HTTP 状态码是 200 ，就继续播放，播放器开始播放 或是 展示快照
2.3.2.4..2、阻止播放
播放视频 或是 请求快照展示，会回调接口：
此时请求的接口，返回的HTTP 状态码不是 200 ，将阻止播放，播放器无法播放 或是 无法展示快照
- 重要说明
param1=Cs09vtkMR.04ccf46c56c2371a48¶m2=testsssssss 是示例附加传参，回调会传递附加的所有参数，不限定个数和名称
3、常见问题
3.1、如何单独控制快照权限？
可以在回调接口里面，判断 app == snap ，针对快照的回调直接返回 200，如下示例
...
var app = getQueryParma("app);
if (app == "snap") {
res.code = 200
res.status = "OK"
}
...
3.2、如何单独控制录像回看权限？
可以在回调接口里面，判断 app == record ，针对快照的回调直接返回 200，如下示例
...
var app = getQueryParma("app);
if (app == "record") {
res.code = 200
res.status = "OK"
}
...
