monibuca/plugin-gb28181

gb28181 plugin for monibuca

GB28181插件

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

插件地址

github.com/Monibuca/plugin-gb28181

插件引入

import (
_ "m7s.live/plugin/gb28181/v4"
)

默认插件配置

gb28181:
  invitemode:     1 #0、手动invite 1、表示自动发起invite，当Server（SIP）接收到设备信息时，立即向设备发送invite命令获取流,2、按需拉流，既等待订阅者触发
  position:
    autosubposition: false #是否自动订阅定位
    expires: 3600s #订阅周期(单位：秒)，默认3600
    interval: 6s #订阅间隔（单位：秒），默认6
  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由设备编号和通道编号以及录像的起止时间拼接而成即[设备编号]/[通道编号]/[开始时间]-[结束时间]

接口API

罗列所有的gb28181协议的设备

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

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	是	订阅间隔（秒）

plugin-gb28181's Issues

为什么我用VLC无法播放拉过来的视频流啊

大佬，我开启了rtsp插件和GB28181插件，使用http://127.0.0.1:8080/api/summary?json=1查询发现有视频流"Path":"34020000001110000001/34020000001320000002"的，但是播放rtsp://localhost/34020000001110000001/34020000001320000002却报错？

向单设备多通道的NVR设备发送invite时出现多个相同CALL-ID的情况

间隔时间很短的时间内连续发送多个INVITE，而这些INVITE的CALL-ID可能一样，导致通道丢失，实际有3个通道，而在M7S里只能收到1个或2个通道

GB28181接入常见问题

这里记录一下GB28181接入的常见问题

SIP/2.0 400 Bad request

国标编码不一致，在nvr或者摄像头的国标配置页；外域编码需要配置和Monibuca一致

SIP/2.0 487 Request Terminated

国标编码问题，nvr的本机的11-13位国标编码需要为200，并修改摄像机11-13位的为131，Monibuca编码为120
还有可能是nvr配置Monibuca的国标编码和国标域反了

这个地方直接continue了是不是有问题？导致通道没有发送invite信息。

V4没有AutoCloseAfter配置？

AutoCloseAfter 如果设置大于等于0，则当某个流最后一个订阅者取消订阅时会延迟N秒，会自动发送bye，节省流量。如果为了响应及时，可以设置成-1，保持流的连接

求助

GB28181互联网视频传输，丢帧乱码，怎么解决。

invite请求发送失败

在创建sip请求时，Uri中少给了Param导致发送时产生空指针错误

发送控制命令ptzcmd参数传什么

请问 ，发送控制命令接口/gb28181/api/control的ptzcmd参数传什么

海康使用gb28181国标传输，通过/gb28181/api/list接口获取还是空

支持国标级联吗？

【bug】两个tplink的摄像头，但是只能播放一个

不知道为啥就timeout了

15:27:50	INFO	tcp listen 1 at :58201
15:28:00	WARN	no tracks	{"stream": "34020000001320000001/34020000001320000001"}
15:28:00	INFO	🟢->⌛	{"stream": "34020000001320000001/34020000001320000001", "action": "publish lost"}
15:28:00	DEBUG	wait publisher	{"stream": "34020000001320000001/34020000001320000001", "wait timeout": "10ms"}
15:28:00	DEBUG	timeout	{"stream": "34020000001320000001/34020000001320000001", "state": "⌛"}
15:28:00	INFO	⌛->🔴	{"stream": "34020000001320000001/34020000001320000001", "action": "timeout"}

感觉并发有问题

m7s.live/plugin/gb28181/v4 v4.3.6配m7s.live/engine/v4 v4.13.5会存在版本问题

\pkg\mod\m7s.live\plugin\ps\[email protected]\main.go:182:18: tcpConf.Listen undefined (type config.TCP has no field or method Listen)

能不能把插件和引擎的版本对应关系贴一下

gb音视频不同步导致播放问题

请问已经可以用在生产环境了么

请问已经可以用在生产环境了么,我看到更新时间还挺新的

海康使用gb28181国标传输，通过/gb28181/api/list返回的数据怎么没有包含通道编号字段，需要从哪里获取

求助 使用教程

直接在main。go 引用就行吗？我试了 运行不起来，请问有详细的教程吗 新手不懂怎么操作，有 demo 提供吗

TP-Link的无线摄像头与国标28181插件通信，无法autoinvite

局域网下可以成功通信，但是插件发送的invite消息出现可稳定复现的超时，只有极小的概率成功。
发送的消息如下
writing SIP message to UDP 192.168.0.108:5061 {"plugin": "GB28181", "prefix": "transport.Protocol", "connection_key": ""udp:0.0.0.0:5060"", "sip_server_ptr": ""0xc00021de00"", "protocol_ptr": ""0xc00024aa00"", "connection_ptr": ""0xc000314380"", "request_id": ""779f96d4-370d-4e54-a3af-83294d32a154"", "transport": ""UDP"", "source": ""192.168.0.106:5060"", "destination": ""192.168.0.108:5061"", "transport_layer_ptr": ""0xc00021dea0"", "transaction_ptr": ""0xc000244240"", "transaction_key": ""z9hG4bK.Dmv5akDdDsm8aLOsmeB8fT7mbnQgcUVf__INVITE""}

得到的报错如下（master分支暂时没有打印报错log，这个是自己改的）
do SipRequestForResponse faild transaction.TxTimeoutError<transaction_key=z9hG4bK.Dmv5akDdDsm8aLOsmeB8fT7mbnQgcUVf__INVITE transaction_ptr=0xc000244240>: transaction timed out

使用GB28181协议在订阅后流被断开该如何解决

使用设备为海康摄像头，配置如下：

config.yaml配置如下

llhls:
  enable: false
hls:
  enable: false
monitor:
  enable: false

global:
  pulseinterval: 5s # 心跳事件间隔时间

gb28181:
  invitemode:     1 #0、手动invite 1、表示自动发起invite，当Server（SIP）接收到设备信息时，立即向设备发送invite命令获取流,2、按需拉流，既等待订阅者触发
  position:
    autosubposition: false #是否自动订阅定位
    expires: 3600s #订阅周期(单位：秒)，默认3600
    interval: 61s #订阅间隔（单位：秒），默认6
  sipip:          "" #sip服务器地址 默认 自动适配设备网段
  serial:         "34020000001110000001"
  realm:          "3402000000"
  username:       "34020000001110000001"
  password:       "12345678"
  registervalidity:  80s #注册有效期
  mediaip:          "" #媒体服务器地址 默认 自动适配设备网段
  port:
    sip: udp:5060 #sip服务器端口
    media: tcp:58200-59200 #媒体服务器端口，用于接收设备的流

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

启用monibuca进程，查看8080/gb28181/api/list API接口返回如下：

[
  {
    "Channels": [
      {
        "Address": "192.168.254.3",
        "CivilCode": "CivilCode",
        "DeviceID": "34020000001310000001",
        "GpsTime": "0001-01-01T00:00:00Z",
        "Latitude": "",
        "LiveStatus": 0,
        "LiveSubSP": "",
        "Longitude": "",
        "Manufacturer": "Manufacturer",
        "Model": "Camera",
        "Name": "优曼测试",
        "Owner": "Owner",
        "ParentID": "",
        "Parental": 0,
        "Port": 0,
        "RegisterWay": 1,
        "SafetyWay": 0,
        "Secrecy": 0,
        "Status": "ON"
      },
      {
        "Address": "192.168.254.19",
        "CivilCode": "CivilCode",
        "DeviceID": "34020000001310000002",
        "GpsTime": "0001-01-01T00:00:00Z",
        "Latitude": "",
        "LiveStatus": 0,
        "LiveSubSP": "",
        "Longitude": "",
        "Manufacturer": "Manufacturer",
        "Model": "Camera",
        "Name": "Camera 01",
        "Owner": "Owner",
        "ParentID": "",
        "Parental": 0,
        "Port": 0,
        "RegisterWay": 1,
        "SafetyWay": 0,
        "Secrecy": 0,
        "Status": "OFF"
      }
    ],
    "ID": "34020000001110000001",
    "Name": "Network Video Recorder",
    "Manufacturer": "HIKVISION",
    "Model": "DS-7816N-R2/16P",
    "Owner": "",
    "RegisterTime": "2024-01-21T14:54:08.084150099+08:00",
    "UpdateTime": "2024-01-21T15:06:18.120260297+08:00",
    "LastKeepaliveAt": "2024-01-21T15:06:18.120381176+08:00",
    "Status": "ONLINE",
    "SN": 3,
    "SipIP": "172.18.156.34",
    "MediaIP": "172.18.156.34",
    "NetAddr": "171.106.18.191:62977",
    "GpsTime": "0001-01-01T00:00:00Z",
    "Longitude": "",
    "Latitude": ""
  }
]

访问：8080/preview/34020000001110000001/34020000001310000001播放视频流失败，STD输出如下：

15:13:57        DEBUG   Preview visit   {"path": "/preview/34020000001110000001/decoder-pro-hard.js", "remote": "222.71.242.202:56737"}
15:13:57        DEBUG   Preview visit   {"path": "/preview/34020000001110000001/decoder-pro-audio.wasm", "remote": "222.71.242.202:56737"}
15:13:58        DEBUG   HDL     visit   {"path": "/hdl/34020000001110000001/34020000001310000001.flv", "remote": "222.71.242.202:56737"}
15:13:58        INFO    已创建  {"流": "34020000001110000001/34020000001310000001", "id": 1}
15:13:58        DEBUG   warp context    {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "HDLSubscriber", "ID": "222.71.242.202:56737"}
15:13:58        INFO    订阅    {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "HDLSubscriber", "ID": "222.71.242.202:56737"}
15:13:58        DEBUG   GB28181 TryAutoInvite   {"id": "34020000001110000001", "channel": "34020000001310000001", "opt": "t=0 0", "condition": true}
15:13:58        INFO    订阅者+1        {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "HDLSubscriber", "ID": "222.71.242.202:56737", "remains": 1}
15:13:58        INFO    GB28181 invite response {"id": "34020000001110000001", "channel": "34020000001310000001", "status code": 200}
15:13:58        DEBUG   GB28181 Device support tcp      {"id": "34020000001110000001", "channel": "34020000001310000001"}
15:13:58        DEBUG   found   {"流": "34020000001110000001/34020000001310000001", "id": 1}
15:13:58        DEBUG   create context  {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "PSPublisher"}
15:13:58        INFO    发布    {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "PSPublisher", "ptr": "0xc000c135e0"}
15:13:58        INFO    ⌛->🟡    {"流": "34020000001110000001/34020000001310000001", "id": 1, "动作": "publish"}
15:13:58        INFO    tcp listen 1 at :58200
15:14:03        WARN    no tracks       {"流": "34020000001110000001/34020000001310000001", "id": 1}
15:14:03        INFO    🟡->🔴    {"流": "34020000001110000001/34020000001310000001", "id": 1, "动作": "timeout"}
15:14:03        INFO    close   {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "HDLSubscriber", "ID": "222.71.242.202:56737", "event": "close"}
15:14:03        INFO    close   {"流": "34020000001110000001/34020000001310000001", "id": 1, "类型": "PSPublisher", "event": "close"}

观察到的现象：
当播放失败后，8080/gb28181/api/list这个API的返回对象就会变为[]空数组
目前看起来连接是建立了，从报错内容来看是没有收到推流数据，想请教一下该如何排查问题。
服务器上的端口已经全部开放（1-60999）

Ubuntu 20.04 下部署存在性能问题

CPU占用高

1.UDP拉流

2.TCP拉流

对讲支持

您好,
准备在利用该插件实现语音推送(摄像头播放).实现流程如下:
1）前端页面向sip服务发送HTTP请求(摄像头ID作为参数)。
2）sip服务接收到前端页面请求后根据ID查询到对应的摄像头设备，发送SIP广播通知，并接收摄像头的广播应答。应答中包含摄像头的IP地址，端口号，音频编码信息。
3）sip服务向流媒体服务发送HTTP请求，携带要发送的摄像头RTP相关信息。流媒体服务发送前端音频流。
4）前端页面接收到步骤1的HTTP返回后，进行拾音操作，将PCM格式的音频流发送给流媒体服务。
5）流媒体服务将接收到的PCM音频流转码为PCMA格式。
6）流媒体服务将PCMA音频数据进行RTP封装，以UDP的方式发送到对应的摄像头。
这个插件内置的sip server, sip通信都没有问题. 有个问题是: 步骤3 是插件同monibuca之间通信吗?这个该如何实现?
谢谢

请问能否实现rtsp拉流后转成gb28181客户端？

首先这个项目太棒了，解决了多种视频流的接入问题。但我们有个场景，相机只有rtsp流，请问能否拉流并转成gb28181格式，然后推送给gb28181服务端？

海康摄像头，必须要填写账号密码。并且header里没有Authorization字段，无法通过认证

海康摄像机使用gb28181报错

panic: runtime error: slice bounds out of range [:-1]

goroutine 120 [running]:
m7s.live/plugin/gb28181/v4.(*GB28181Config).StoreDevice(0x1937440, {0xc000757645, 0x14}, {0x1235158, 0xc000c286e0}, 0xc00074d8e0)
/home/runner/go/pkg/mod/m7s.live/plugin/gb28181/[email protected]/device.go:88 +0x705
m7s.live/plugin/gb28181/v4.(*GB28181Config).OnRegister(0x1937440, {0x1235158?, 0xc000c286e0}, {0x7f635cf23318, 0xc000c07b80})
/home/runner/go/pkg/mod/m7s.live/plugin/gb28181/[email protected]/handle.go:95 +0x3f2
created by github.com/ghettovoice/gosip.(*server).handleRequest
/home/runner/go/pkg/mod/github.com/ghettovoice/[email protected]/server.go:270 +0x28a

v3版如何配置子码流呢

/api/gb28181/list缺少移动侦测的录像

/api/gb28181/list只能查询计划的录像，而特殊的如移动侦测、事件录像是没有的

海康摄像机接入状态正常 但是无法拉流 服务器上显示失败

下面是我的摄像机配置

下面是我的服务器配置

下面是服务器报错

v4版本的GB28181具体怎么实现调取NVR存储的视频回放？

目前NVR的推流，播放都没问题，非常不错，就是不知道调取NVR存储的视频回放该怎么做？麻烦告知，谢谢！

Monibuca和nvr的sip注册

请问Monibuca 和nvr需要在一个网段内吗？

没有GPS定位

设备上线后，好像没有订阅GPS定位消息，导致接收不到定位数据

该插件支持gb28181级联不

handle.go的notifyMessage 的Event变量，按照gb2016版实际上在域内notify的消息并没有这个变量对应的值，在域间才有这个值。因此在域内，通道上下线并不会有notify消息

关于设备注册的问题

按照GB28181附录J或者SIP协议，设备在SIP服务器注册成功，服务器返回的200相应中应该是有Contact这一头部字段的，但是目前版本插件是没有的，导致注册成功服务器返回给设备的报文是200 OK (0bingdings)，而正常的应该是200OK (1bingdings)，所以希望插件在返回的报文里添加Contact这一头部字段,这样就返回正确了

panic错误

panic: runtime error: slice bounds out of range [:9] with length 0

goroutine 1616 [running]:
m7s.live/plugin/gb28181/v4.(*Channel).CreateRequst(0xc0013ae1c0, {0xe6cbab, 0x6})
	/go/pkg/mod/m7s.live/plugin/gb28181/[email protected]/channel.go:100 +0x725
m7s.live/plugin/gb28181/v4.(*Channel).Invite(0xc0013ae1c0, {0x0, 0x0, {0x0, 0x0}, {0xc000804b50, 0xa}, 0xbebd2f1, 0xe358})
	/go/pkg/mod/m7s.live/plugin/gb28181/[email protected]/channel.go:358 +0xbbc
created by m7s.live/plugin/gb28181/v4.(*Device).UpdateChannels
	/go/pkg/mod/m7s.live/plugin/gb28181/[email protected]/device.go:245 +0x9b6

海康设备注册失败的问题

SIP服务器向设备发送inite请求，返回Status-Line: SIP/2.0 415 Unsupported Media Type。

time.After mem++

	sse.WriteJSON(list)
	select {
	case <-time.After(time.Second * 5):
	case <-sse.Done():
		return
	}

restful的这里建议NewTimer，确保超时内存能及时释放
sse.WriteJSON(list)
timeOut := time.NewTimer(time.Second * 5)
defer timeOut.Stop()
select {
case <-timeOut.C:
case <-sse.Done():
return
}
同样的server.go建议增加
t := time.NewTicker(time.Duration(config.RemoveBanInterval) * time.Second)
defer t.Stop() //新增

GB35114-2017可以支持起来了

RT: GB35114-2017可以支持起来了^.^

接入 国标 配置好了 提示这个 gb28181 decode rtp error: size 481 < 49376: RTP header size insufficient for extension

接入 国标 配置好了 提示这个 gb28181 decode rtp error: size 481 < 49376: RTP header size insufficient for extension 什么问题啊

此插件如何安装？找不到相应的文档

plugin-gb28181插件怎样安装 呢？