音视频通话

视频水印

功能介绍

水印在图像采集后立即添加,本地显示、远端显示、录制内容均包含添加的水印。
支持的水印种类有:

  • 静态图片水印:传入图片作为水印;
  • 文字水印:传入一段文字作为水印,支持设置:字体大小、文字颜色、背影色;
  • 时间戳水印:文字水印中增加变量%timestamp%

1. 配置水印

调用 setVideoWatermark(videoID, params) 配置水印。

  • videoID:视频设备 ID。传 -1 表示配置全局默认水印,对所有未单独配置水印的视频设备生效。
  • params:水印内容,JSON 格式,为 list<CRMixerContentObj>,此处仅支持 CRVSDK_MIXCONT_PIC(图片)和 CRVSDK_MIXCONT_TEXT(文本)类型。传 nullptr 或 "" 表示移除该 videoID 的水印配置。

优先级:某个视频设备若配置了自身 watermark,则使用该配置;否则使用 videoID 为 -1 的全局水印配置。

示例(逻辑示意,具体 JSON 字段以 CRMixerContentObj 为准):


// 设置全局的文本+时戳水印
const char* textParams = R"([{"type":10, "left":5, "top":5, "param":{"text":"Time:%timestamp%"}}])";
g_sdkMain->getSDKMeeting().setVideoWatermark(-1, textParams);

// 设置全局的图片水印
CRVideoFrame picFrm
g_sdkMain->coverToVideoFrame(picPathFileName, picFrm);
g_sdkMain->setPicResource("xxx", picFrm);
const char* picParams = R"([{"type":1, "left":5, "top":5, "param":{"resourceid":"xxx"}}])";
g_sdkMain->getSDKMeeting().setVideoWatermark(-1, picParams);

// 移除全局水印
g_sdkMain->getSDKMeeting().setVideoWatermark(-1, nullptr);

相关 API 与结构请参考:

2. 获取当前水印配置

调用 getVideoWatermark(videoID) 可获取指定视频设备或全局(videoID 为 -1)的水印配置 JSON 串。

相关 API 请参考:

3. 注意事项

  • 水印叠加在编码前进行,会略微增加 CPU 开销;图片资源可通过 setPicResource 等接口注册供混图/水印使用。
  • 文本类型中可支持时间戳等占位符,具体以 CRMixerContentObj 及服务端/文档说明为准。