Monibuca

Appearance

GB28181 插件 ​

该插件提供 SIP server 的服务，以及流媒体服务器能力，可以将 NVR 和摄像头的流抓到 m7s 中，可获取的设备的录像数据以及访问录像视频。也可以控制摄像头的旋转、缩放等。

插件地址 ​

https://github.com/Monibuca/plugin-gb28181

插件引入 ​

go
import _ "m7s.live/plugin/gb28181/v4"

默认插件配置 ​

yaml
gb28181:
  invitemode: 1 #0、手动invite 1、表示自动发起invite，当Server（SIP）接收到设备信息时，立即向设备发送invite命令获取流,2、按需拉流，既等待订阅者触发
  position:
    autosubposition: false #是否自动订阅定位
    expires: 3600s #订阅周期(单位：秒)，默认3600
    interval: 6s #订阅间隔（单位：秒），默认6
  udpcachesize: 0 #表示UDP缓存大小，默认为0，不开启。仅当TCP关闭，切缓存大于0时才开启
  sipip: "" #sip服务器地址 默认 自动适配设备网段
  serial: "34020000002000000001"
  realm: "3402000000"
  username: ""
  password: ""

  registervalidity: 60s #注册有效期

  mediaip: "" #媒体服务器地址 默认 自动适配设备网段
  port:
    sip: udp:5060 #sip服务器端口
    media: tcp:58200-59200 #媒体服务器端口，用于接收设备的流

  removebaninterval: 10m #定时移除注册失败的设备黑名单，单位秒，默认10分钟（600秒）
  loglevel: info

如果配置了端口范围，将采用范围端口机制，每一个流对应一个端口

注意某些摄像机没有设置用户名的地方，摄像机会以自身的国标 id 作为用户名，这个时候 m7s 会忽略使用摄像机的用户名，忽略配置的用户名

如果设备配置了错误的用户名和密码，连续三次上报错误后，m7s 会记录设备 id，并在 10 分钟内禁止设备注册

插件功能 ​

使用 SIP 协议接受 NVR 或其他 GB28181 设备的注册 ​

  • 服务器启动时自动监听 SIP 协议端口，当有设备注册时，会记录该设备信息，可以从 UI 的列表中看到设备
  • 定时发送 Catalog 命令查询设备的目录信息，可获得通道数据或者子设备
  • 发送 RecordInfo 命令查询设备对录像数据
  • 发送 Invite 命令获取设备的实时视频或者录像视频
  • 发送 PTZ 命令来控制摄像头云台
  • 自动同步设备位置

作为 GB28281 的流媒体服务器接受设备的媒体流 ​

  • 当 invite 设备的实时视频流时，会在 m7s 中创建对应的流，StreamPath 由设备编号和通道编号组成，即[设备编号]/[通道编号],如果有多个层级，通道编号是最后一个层级的编号
  • 当 invite 设备的录像视频流时，StreamPath 由设备编号和通道编号以及录像的起止时间拼接而成即[设备编号]/[通道编号]/[开始时间]-[结束时间]

如何设置 UDP 缓存大小 ​

通过 wireshark 抓包，分析 rtp，然后看一下大概多少个包可以有序

接口 API ​

罗列所有的 gb28181 协议的设备 ​

/gb28181/api/list 设备的结构体如下

go
type Device struct {
	ID              string
	Name            string
	Manufacturer    string
	Model           string
	Owner           string
	RegisterTime    time.Time
	UpdateTime      time.Time
	LastKeepaliveAt time.Time
	Status          string
	Channels        []*Channel
	NetAddr         string
}

根据 golang 的规则，小写字母开头的变量不会被序列化

从设备拉取视频流 ​

/gb28181/api/invite

参数名必传含义
id是设备 ID
channel是通道编号
startTime否开始时间（纯数字 Unix 时间戳）
endTime否结束时间（纯数字 Unix 时间戳）

返回 200 代表成功, 304 代表已经在拉取中，不能重复拉（仅仅针对直播流）

停止从设备拉流 ​

/gb28181/api/bye

参数名必传含义
id是设备 ID
channel是通道编号

http 200 表示成功，404 流不存在

发送控制命令 ​

/gb28181/api/control

参数名必传含义
id是设备 ID
channel是通道编号
ptzcmd是PTZ 控制指令

查询录像 ​

/gb28181/api/records

参数名必传含义
id是设备 ID
channel是通道编号
startTime否开始时间（Unix 时间戳）
endTime否结束时间（Unix 时间戳）

移动位置订阅 ​

/gb28181/api/position

参数名必传含义
id是设备 ID
expires是订阅周期（秒）
interval是订阅间隔（秒）