WVP-GB28181-Pro Documentation

WVP-PRO is an out-of-the-box video platform implementing the GB/T 28181-2016 standard. It is built upon the ZLMediaKit open-source streaming service.

Key capabilities include:

• Connecting IPC cameras via the 28181 protocol.
• Distributing video streams using 28181, RTSP, RTMP, or FLV protocols to other platforms.
• Compatibility with major brands like Hikvision, Dahua, and Uniview (IPC, NVR, and platforms).
• Cascading GB/T 28181 devices to other national standard platforms.
• Supporting the push of non-standard device streams to GB/T 28181 platforms.
• Multi-stream media node load balancing.
• A complete built-in frontend for immediate deployment without secondary development.

WVP-PRO implements the broadcast mode from GB/T 28181-2016. In this mode, the server sends audio to the device. The device initiates the process by sending an Invite message to WVP-PRO, and the transport method (UDP/TCP Passive/TCP Active) is determined by the device.

Critical Limitations:

• Public Network Compatibility: Many devices (e.g., most Hikvision devices) only support UDP for receiving streams. If WVP-PRO is on a public network and the device is behind a NAT/Internal network, WVP-PRO cannot connect to the IP/port provided by the device, causing the intercom to fail.
• Compatible Devices: Devices that support TCP Active mode (such as Dahua or many law enforcement recorders) are suitable for public network intercom because they can pull the stream from the server.

WVP supports scaling video concurrency by managing a cluster of ZLM nodes.

• Storage: WVP records all connected nodes in Redis.
• Load Tracking: WVP tracks the current load status of each ZLM node.
• Load Balancing: When a new request arrives, WVP selects the ZLM node with the lowest current load to handle the request, ensuring efficient distribution across the cluster.

WVP-PRO's own code is licensed under the permissive MIT License, allowing free use in both commercial and non-commercial projects provided that copyright information is retained.

Important for Commercial Users:

• This project incorporates various other open-source code snippets. For commercial applications, you should manually replace or remove these third-party components to ensure compliance.
• When using this project, you must also declare the licenses of the third-party libraries that this project depends on within your own authorization/license documentation.
• The developers and the project itself are not liable for any commercial disputes or copyright infringements arising from the use of this project; users assume all legal risks.

The project documentation provides comprehensive guides for setting up the platform. You can find specific instructions for:

• Compilation: Building the project from source.
• Configuration: Setting up environment variables and system parameters.
• Deployment: Deploying the platform to production environments.

To contribute to the wvp-gb28181-pro project, ensure your development environment meets the following specifications:

• Backend: Java (JDK 1.8) using the Spring Boot framework.
• Frontend: Vue.js using Node.js v10.19.0 and npm 6.14.4.
• IDE: JetBrains IntelliJ IDEA is recommended.

Important Notes:

• The project makes extensive use of asynchronous operations.
• To understand the business logic and code flow, you must reference the GB/T 28181 protocol documentation; the code alone may be difficult to follow without protocol context.
• Proficiency with packet capture (tcpdump) is essential for debugging and development.