# GB28181.Solution **Repository Path**: a22110/GB28181.Solution ## Basic Information - **Project Name**: GB28181.Solution - **Description**: 默认使用develop分支 - **Primary Language**: C# - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 71 - **Created**: 2020-05-21 - **Last Updated**: 2024-11-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # GB28181 Standard + GB28181开源的目标是：通过代码复用，适当降低工作难度和减少业务代码的重复性，并非替代你的开发工作或者让你几乎不用开发工作。 + 最新国标是：【[GB28181-2016](docs/GBT%2028181-2016%20公共安全视频监控联网系统信息传输、交换、控制技术要求-目录版.pdf)】 + 项目结构、代码结仍存在不少问题，待完善,因为时间问题，也是希望大家能一起完善 + 希望每一个对本项目感兴趣的朋友，都能成为本项目的共同作者或者贡献者 + 注意：**代码一直在更新，GB28181系列项目，并不是生产就绪的，往往须要根据自己的项目和产品架构，做适当的调整和适配！！** ## 运行环境(environment) ~~~ bash running in docker running on Linux running on aspnetcore 3.1+ ~~~ + [可以协同测试的Linux/Windows版工具](https://github.com/GB28181/GB28181-Simulation-Tool) + [FAQ:常见的一些问题](https://github.com/GB28181/GB28181.Solution/wiki/FAQ:%E5%B8%B8%E8%A7%81%E7%9A%84%E4%B8%80%E4%BA%9B%E9%97%AE%E9%A2%98) + [WinTool视频播放测试指南](https://github.com/GB28181/GB28181.Solution/wiki/WinTool%E8%A7%86%E9%A2%91%E6%92%AD%E6%94%BE%E6%B5%8B%E8%AF%95%E6%8C%87%E5%8D%97) ## 说明(instruction) + Mainly on `develop` branch ,in order to support .net core3.1+. + 以develop分支为主. + The windows function part was not maintained . + Form Client Project Need to be fixed. + you can refer to other branch in this repo , `PRs` are always welcome. + provide grpc interface for other microservice ## 一些要做的事情(TODO List) 项目希望达到的目标功能,如下: 打勾的是已完成的，没打勾的是正在做的，需要大家一起完成的. + Architecture & framework + [x] 设计与流媒体服务交互的GRPC接口 + [x] 设计与系统配置服务(或数据服务)交互的GRPC接口 + [x] 精简服务模块，调整代码结构关系 + [ ] 为配置接口和流媒体服务接口提供mock数据,使得服务可以独立运行 + [ ] 以GRPC方式对接流媒体服务【[monibuca](https://github.com/langhuihui/monibuca)】 + [ ] 以GRPC方式从系统配置服务(或者数据服务)中获取GB信令服务的配置信息，包括名称、ID、端口、协议等 + [ ] 使服务注册组件变成可配置的（或者移除），(当前是consul，并且k8s环境中也不需要) + [x] 将GRPC服务的实现改为apsnetcore3.1+的内置实现方式. + [ ] 从GB28181.Sipsorcery项目中将原始的sipsorcery项目分离出来 + [x] 剥离删除DNS组件,直接使用sipsorcery项目的原始功能. + SIP信令服务 + [x] 对接GB28181设备,实现基本的设备控制(暂不含双向语音和巡航等功能) + [x] Device Registering And management + [x] Device Controlling Service such as :PTZ + [x] Device Catalog Query + [x] Device Info Query + [x] Device Live Video + [x] Device History Video Query + [x] 对接GB28181平台，实现完整的平台级联控制。 + [x] 注册到服务的设备信息缓存 + [ ] 注册到服务的平台信息缓存，待进一步测试 + Streaming Media(流媒体，以【[monibuca](https://github.com/langhuihui/monibuca)】为基础) + [x] 修复视频测试工具(WinTool) + [x] 完善项目视频组件功能相关的测试流程文档 + [ ] 定义SIP信令服务与流媒体服务交互的RTSP接口 + [x] 定义SIP信令服务与流媒体服务交互的GRPC接口 + [ ] 实现完整的实时视频播放功能, Video Live Play + [ ] 实现完整的历史视频搜索功能，History Video Record Search + [ ] 实现完整的历史视频播放功能, History Video PlayBack ## 模块在系统内架构关系 下图展示 GB28181.Server 在整个系统架构中设定的、与其他服务的模块关系以及交互方式设计： ![GB28181.Server-Assembly-Relationship](./docs/GB28181.Server-Assembly-Relationship.png) *需要注意：图示中的架构设计，不一定适合你的项目需求和你的系统架构设计要求，往往需要根据你的项目实际做修改和调整* *欢迎共同讨论，共同进步，欢迎PR* ## 讨论、成为共同作者、近距离贡献 微信扫描二维码，添加好友，进入微信讨论群(注明：GB28181-公司-姓名)： ![qrcode](./docs/crazybber.jpg) ## Inspired By + [Gb28181_Platform](https://github.com/mackenbaron/Gb28181_Platform) + [sipsorcery](https://github.com/sipsorcery/sipsorcery) + [GB28181-2016(C/C++)](https://github.com/usecpp/gb28181-2016) ## License MIT & BSD v2 & BSD v3 & GPL ***说明: 由于项目前期License问题的不严谨性，项目采用了诸多协议，如GPL、MIT、BSD v2 BSD v3等，但是,由于GPL License的存在以及[GPL License的约束和传染性](https://www.oschina.net/question/12_2826)，这对希望修改后闭源使用的朋友可能会造成较大影响.*** ***项目中用到的 [SIPSorcery](https://github.com/sipsorcery/sipsorcery)中明确使用了[GPL License](http://www.opensource.org/licenses/gpl-license.php), 比如: [DNSResponse](https://github.com/GB28181/GB28181.Solution/blob/dc38a76ddcd8b424768089ad4ba2f5bee4a2931c/GB28181.SIPSorcery/Net/DNS/DNSResponse.cs#L16)*** ***针对该License问题：项目的后续计划是将使用的 [SIPSorcery](https://github.com/sipsorcery/sipsorcery)中的相关代码更新为原作者使用[Code Project Open License (CPOL)](https://www.codeproject.com/info/cpol10.aspx)的版本, 比如：[使用CPOL版本DNSResponse](https://github.com/sipsorcery/sipsorcery/blob/e677393f7e8c30a10b311892eff78a86ddaa8aba/src/net/DNS/DNSResponse.cs#L17)，同时将其他代码的License也做适当的更宽泛化调整*** GPL License 有三个版本:[GPL(GPL 1.0)](http://www.gnu.org/licenses/old-licenses/gpl-1.0.html)、[GPL 2.0](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html)、[GPL 3.0](http://www.gnu.org/licenses/gpl-3.0.html) 关于GPL的更多了解：[开源中国GPL](https://www.oschina.net/question/12_2826)、[百科 GPL](https://baike.baidu.com/item/GPL/2357903) ## 其他 + [可以协同测试的Linux/Windows版工具](https://github.com/GB28181/GB28181-Simulation-Tool) + [FAQ:常见的一些问题](https://github.com/GB28181/GB28181.Solution/wiki/FAQ:%E5%B8%B8%E8%A7%81%E7%9A%84%E4%B8%80%E4%BA%9B%E9%97%AE%E9%A2%98) + [WinTool视频播放测试指南](https://github.com/GB28181/GB28181.Solution/wiki/WinTool%E8%A7%86%E9%A2%91%E6%92%AD%E6%94%BE%E6%B5%8B%E8%AF%95%E6%8C%87%E5%8D%97)