LiveGBS流媒体平台GB/T28181功能-视频直播流快照的安全控制配置播放回调鉴权接口控制播放权限

Posted 2023-04-03 Marvin1311

LiveGBS功能-视频直播流快照的安全控制配置播放回调鉴权接口控制播放权限

• 1、直播流安全控制
• • 1.1、直播流开启控制
  • 1.2、直播流回调鉴权
• 2、配置播放鉴权回调
• • 2.1、准备回调鉴权接口
  • 2.2、配置回调鉴权地址
  • 2.3、调试说明
  • • 2.3.1、调试环境
    • 2.3.2、调用示例
    • • 2.3.2.1、视频流地址
      • 2.3.2.2、附加鉴权参数
    • 2.3.3、播放器播放
    • 2.3.4、回调请求鉴权
    • • 2.3.4.1、回调请求参数-说明
      • 2.3.4.2、回调请求参数-示例
    • 2.3.5、开始播放
    • 2.3.6、阻止播放
• 3、常见问题
• • 3.1、如何单独控制快照权限？
  • 3.2、如何单独控制录像回看权限？
• 4、搭建GB28181视频直播平台

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、视频流地址

http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000022_34020000001320000002.flv

2.3.2.2、附加鉴权参数

为视频流地址，附加鉴权回调的接口需要的参数如：param1、param2

http://192.168.2.135:10000/sms/34020000002020000001/flv/hls/34020000001110000022_34020000001320000002.flv?param1=Cs09vtkMR.04ccf46c56c2371a48&param2=testsssssss

2.3.3、播放器播放

使用播放器播放上述 附加鉴权参数后 的地址

2.3.4、回调请求鉴权

LiveGBS服务会在用户播放视频流的时候 ，回调已经配置的回到接口，如上配置的播放回调鉴权地址： http://192.168.2.153:8080/authstream

2.3.4.1、回调请求参数-说明

名称	描述
raddr	客户端远端IP
app	应用类型： webrtc (webrtc播放) hls (其它视频流播放) record (M3U8录像播放) snap (快照获取)
call	操作类型：play
name	资源唯一标记： 如视频ID、快照名称
其它自定义入参	自定义的入参：如上面示例的 param1、param2，名称根据需要自定义

2.3.4.2、回调请求参数-示例

详细的回调请求示例如下：

http://192.168.2.153:8080/authstream?raddr=192.168.2.136&app=hls&call=play&name=34020000001110000022_34020000001320000002&param1=Cs09vtkMR.04ccf46c56c2371a48&param2=testsssssss

播放前回调鉴权传递参数，说明如下：
raddr=192.168.2.136  客户端远端IP
app=hls 应用类型
call=play  操作
name=34020000001110000022_34020000001320000002 资源唯一标记（视频流）

param1和param2是自定义附加的，可以自定义参数名，播放回调时会透传后来用于自定义的鉴权逻辑

2.3.5、开始播放

播放视频 或是 请求快照展示，会回调接口：

此时请求的接口，返回的HTTP 状态码是 200 ，就继续播放，播放器开始播放 或是 展示快照

2.3.6、阻止播放

播放视频 或是 请求快照展示，会回调接口：
此时请求的接口，返回的HTTP 状态码不是 200 ，将阻止播放，播放器无法播放 或是 无法展示快照

- 重要说明
param1=Cs09vtkMR.04ccf46c56c2371a48&param2=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"

...

4、搭建GB28181视频直播平台

• 支持 Windows Linux 及其它CPU架构（国产、嵌入式…）操作系统
• 安装包下载 、 安装使用说明、 WEB前端源码
• 更多常见问题

LiveGBS国标GB_T28181视频平台如何配置全局目录订阅周期(秒)快捷配置开启目录订阅周期

@(LiveGBS国标GB/T28181视频平台如何配置全局目录订阅周期单位秒) 1、目录订阅周期 目录订阅周期配置后，可以收到下级上报的通道状态的变化，之前介绍过，可以通过国标设备菜单，单独编辑设备配置订阅周期，开启目录订阅。 LiveGBS国标GB/T28181视频流媒体平台接入下级平台设备后如

WEB：https://www.liveqing.com