wvp-GB28181-pro视频水印功能：动态添加设备信息实现

【免费下载链接】wvp-GB28181-pro 项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro

1. 技术痛点与解决方案

在安防监控系统中，视频流溯源是关键需求。传统静态水印无法满足多设备动态标识需求，而动态水印需解决三个核心问题：实时性处理、设备信息关联、配置灵活性。wvp-GB28181-pro作为GB/T 28181标准的开源实现，可通过FFmpeg滤镜链与设备元数据关联实现动态水印功能。

2. 实现原理

2.1 技术架构

2.2 数据流程

1. 设备信息采集：从GB28181注册信息中提取设备ID、通道号、厂商信息
2. 水印参数构建：根据设备状态动态生成水印文本（如设备ID:34020000001320000001 通道:01 时间:2025-09-09 12:00:00）
3. FFmpeg处理：通过drawtext滤镜实时叠加文本水印
4. 流转发：处理后的视频流通过RTMP/HTTP-FLV等协议分发

3. 核心实现代码

3.1 水印配置实体类

@Data
public class AblServerConfig {
    @ConfigKeyId("filterVideo_enable")
    private Integer filterVideoEnable;  // 水印开关：1-启用，0-禁用
    
    @ConfigKeyId("filterVideo_text")
    private String filterVideoText;     // 水印文本模板
    
    @ConfigKeyId("FilterFontSize")
    private Integer filterFontSize;     // 字体大小
    
    @ConfigKeyId("FilterFontColor")
    private String filterFontColor;     // 字体颜色（十六进制）
    
    @ConfigKeyId("FilterFontLeft")
    private Integer filterFontLeft;     // 水平偏移
    
    @ConfigKeyId("FilterFontTop")
    private Integer filterFontTop;      // 垂直偏移
    
    @ConfigKeyId("FilterFontAlpha")
    private Double filterFontAlpha;     // 透明度（0.0-1.0）
}

3.2 FFmpeg命令构建

public String buildWatermarkCommand(StreamPush streamPush, AblServerConfig config) {
    // 获取设备信息
    String deviceId = streamPush.getGbDeviceId();
    String channelId = streamPush.getStream();
    String manufacturer = getManufacturer(deviceId);  // 需实现设备信息查询
    
    // 构建水印文本
    String watermarkText = String.format(
        config.getFilterVideoText(),
        deviceId, channelId, manufacturer, 
        new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date())
    );
    
    // 构建FFmpeg滤镜
    return String.format(
        "ffmpeg -i rtsp://%s:%s -vf \"drawtext=text='%s':fontfile=/usr/share/fonts/dejavu/DejaVuSans.ttf:fontsize=%d:fontcolor=%s@%f:x=%d:y=%d\" -c:v libx264 -c:a copy -f flv rtmp://127.0.0.1/live/%s",
        streamPush.getApp(), streamPush.getStream(),
        watermarkText,
        config.getFilterFontSize(),
        config.getFilterFontColor(),
        config.getFilterFontAlpha(),
        config.getFilterFontLeft(),
        config.getFilterFontTop(),
        streamPush.getStream()
    );
}

3.3 流处理集成

在StreamPushServiceImpl的推流处理流程中添加水印逻辑：

@Override
public boolean startPush(StreamPush streamPush) {
    // 检查水印配置
    AblServerConfig ablConfig = ablServerConfigService.getConfig();
    if (ablConfig.getFilterVideoEnable() == 1) {
        // 构建带水印的FFmpeg命令
        String ffmpegCmd = buildWatermarkCommand(streamPush, ablConfig);
        // 执行FFmpeg处理
        mediaServerService.executeFFmpegCommand(ffmpegCmd);
    } else {
        // 直接转发
        mediaServerService.startPush(streamPush);
    }
    return true;
}

4. 配置参数详解

参数名	类型	说明	默认值
filterVideo_enable	Integer	水印功能开关	0（禁用）
filterVideo_text	String	水印文本模板，支持占位符	"设备:%s 通道:%s 时间:%s"
FilterFontSize	Integer	字体大小（像素）	24
FilterFontColor	String	字体颜色（十六进制）	"FFFFFF"（白色）
FilterFontAlpha	Double	透明度（0.0-1.0）	0.7
FilterFontLeft	Integer	水平偏移（像素）	10
FilterFontTop	Integer	垂直偏移（像素）	10

5. 性能优化策略

5.1 硬件加速

通过FFmpeg的VAAPI/NVENC加速视频编码：

# 使用NVIDIA硬件加速
ffmpeg -hwaccel cuda -i input.mp4 -vf "drawtext=..." -c:v h264_nvenc output.mp4

5.2 动态帧率适配

根据输入流帧率调整水印更新频率，降低CPU占用：

int frameRate = getStreamFrameRate(streamPush);  // 获取流帧率
if (frameRate > 25) {
    // 高帧率流每2帧更新一次水印
    filterCommand += ":rate=0.5";
}

6. 部署与测试

6.1 环境依赖

• FFmpeg 4.3+（需启用libfreetype）
• 中文字体支持（如文泉驿微米黑）
• JDK 11+
• Maven 3.6+

6.2 测试步骤

1. 配置水印参数：

INSERT INTO server_config (key, value) VALUES 
('filterVideo_enable', '1'),
('filterVideo_text', '设备:%s 通道:%s 厂商:%s 时间:%s'),
('FilterFontSize', '28'),
('FilterFontColor', 'FF0000'),
('FilterFontAlpha', '0.8'),
('FilterFontLeft', '20'),
('FilterFontTop', '20');

2. 启动服务：

cd /data/web/disk1/git_repo/GitHub_Trending/wv/wvp-GB28181-pro
./run.sh

3. 推流测试：

ffmpeg -re -i test.mp4 -f rtsp rtsp://localhost:554/stream1

4. 播放验证：通过VLC播放rtmp://localhost/live/stream1，检查水印是否正确显示

7. 常见问题处理

7.1 水印文字乱码

原因：缺少中文字体
解决：安装文泉驿字体并指定字体文件路径：

yum install -y wqy-microhei-fonts

修改FFmpeg命令中的fontfile参数为/usr/share/fonts/wqy-microhei/wqy-microhei.ttc

7.2 视频延迟增加

原因：FFmpeg处理引入缓冲
解决：调整FFmpeg参数减少延迟：

ffmpeg -i input -vf "drawtext=..." -preset ultrafast -tune zerolatency -c:v libx264 -f flv output

7.3 水印位置偏移

解决：使用相对坐标代替绝对坐标：

drawtext=...:x=w-tw-10:y=h-th-10  # 右下角对齐（边距10像素）

8. 扩展功能展望

1. 动态位置调整：根据视频内容自适应水印位置，避免遮挡关键区域
2. 二维码集成：添加包含设备信息的二维码，支持手机扫描查看详情
3. 水印权限控制：基于用户角色显示不同级别水印信息
4. AI辅助水印：使用AI识别视频场景，智能调整水印透明度和样式

9. 配置模板与工具

9.1 水印配置模板

{
  "filterVideo_enable": 1,
  "filterVideo_text": "设备ID:%s 通道:%s 时间:%s",
  "FilterFontSize": 24,
  "FilterFontColor": "FFFFFF",
  "FilterFontAlpha": 0.7,
  "FilterFontLeft": 10,
  "FilterFontTop": 10
}

9.2 性能测试工具

使用ffmpeg-benchmark测试水印处理性能：

ffmpeg -i input.mp4 -vf "drawtext=text='测试水印':fontfile=font.ttf" -f null -

关注输出中的fps值，建议保持在25fps以上以保证流畅性

10. 总结

通过FFmpeg的drawtext滤镜与设备元数据结合，wvp-GB28181-pro可实现高效的动态水印功能。该方案具有以下优势：

1. 实时性：基于FFmpeg的硬件加速支持，可满足4K视频实时处理需求
2. 灵活性：通过配置文件动态调整水印样式和内容
3. 可扩展性：预留接口支持AI水印、动态位置等高级功能

建议在生产环境中先进行压力测试，根据实际硬件配置调整并发处理数量，推荐每台服务器处理不超过32路1080P视频流。

【免费下载链接】wvp-GB28181-pro 项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro