视频水印
功能介绍
水印在图像采集后立即添加,本地显示、远端显示、录制内容均包含添加的水印。
支持的水印种类有:
- 静态图片水印:传入图片作为水印;
- 文字水印:传入一段文字作为水印,支持设置:字体大小、文字颜色、背影色;
- 时间戳水印:文字水印中增加变量
%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 与结构请参考:
- setVideoWatermark
- getVideoWatermark
- CRMixerContentObj
- CRVSDK_MIXER_CONTENT_TYPE(MIXCONT_PIC、MIXCONT_TEXT)
2. 获取当前水印配置
调用 getVideoWatermark(videoID) 可获取指定视频设备或全局(videoID 为 -1)的水印配置 JSON 串。
相关 API 请参考:
3. 注意事项
- 水印叠加在编码前进行,会略微增加 CPU 开销;图片资源可通过 setPicResource 等接口注册供混图/水印使用。
- 文本类型中可支持时间戳等占位符,具体以 CRMixerContentObj 及服务端/文档说明为准。