短视频水印SDK集成指南_办公安全平台(SASE)-阿里云帮助中心

短视频水印主要用于AIGC类短视频、种草短视频等的版权保护、泄漏溯源等场景，视觉质量较高，鲁棒性较强。

当前支持在短视频上嵌入明水印和暗水印。

如果嵌入的是明水印，可以直接在短视频上看到明水印信息，定位泄露人员。
如果嵌入的是暗水印，无法通过肉眼直接看到暗水印信息，所以您需要在SASE控制台上提取暗水印信息，然后定位出泄露人员。要求用于嵌入和提取的短视频时长大于1秒（10秒以上效果最佳）。

而大部分发生信息泄露或者版权纠纷等都是暗水印场景。

操作流程

前提条件

已购买短视频水印服务。具体信息，请参见数字水印计费概述。

在业务服务器上嵌入短视频水印SDK

已存在一台基于X86架构的Linux服务器。该服务器用于部署短视频水印SDK。

本文以Ubuntu 24.04 64位的服务器为例。

步骤一：下载短视频水印SDK

登录办公安全平台控制台。
在左侧导航栏，选择数字水印服务 > 嵌入服务。
在嵌入服务页面，单击短视频水印操作列下载SDK。
将短视频水印压缩包下载到本地。当前只支持Java语言。
下载的SDK压缩包中包含如下内容：
watermark-purevideo-short-v1.0.0.jar：集成水印的SDK包，需要添加到Maven仓库。
watermark-purevideo_short_demo：水印的Demo，您可以通过Demo进行体验。
单击AK/SK信息列的图标，复制AK和SK信息并保存到本地。

步骤二：集成SDK

添加JAR包依赖（maven）。

添加watermark-purevideo-short-v1.0.0.jar依赖。

mvn install:install-file  -Dfile=watermark-purevideo-short-v1.0.0.jar  -DgroupId=com.aliyun.security.sase -DartifactId=watermark-purevideo-short -Dversion=v1.0.0  -Dpackaging=jar

在pom.xml文件中添加以下依赖。

<dependency>
  <groupId>com.aliyun.security.sase</groupId>
  <artifactId>watermark-purevideo-short</artifactId>
  <version>v1.0.0</version>
  <scope>compile</scope>
</dependency>

调用短视频水印接口。

初始化AK、SK。

/**
 * 初始化 ak sk
 * @param appKey 应用密钥Key
 * @param secret 应用密钥Secret
 * @param useLocalConfig 是否使用本地配置 0:远程配置(需要联网) 1:本地配置
 */
WaterMarkShortVideoUtils.init(appKey, secret, useLocalConfig);

在短视频上添加数字水印。

添加水印后生成新的视频。

ParamsFile paramsFile = new ParamsFile();
//支持短视频格式mp4，mov，avi , ts, f4v，mkv
paramsFile.setSrcFilePath("123.mp4");
paramsFile.setDestFilePath("234.mp4");

//明水印配置
paramsFile.setText("你好123a   bcOK");
// x,y是相对于短视频左上角的偏移像素
paramsFile.setText_x("100");
paramsFile.setText_y("100");
// 字体文件路径
paramsFile.setFontfile("/tmp/AlibabaPuHuiTi-2-45-Light.ttf");
// RGB颜色值
paramsFile.setFontsize("48");
// RGB颜色值
paramsFile.setFontcolor("0xFF0000");
//透明度，0~1
paramsFile.setAlpha("0.5");
//暗水印配置参数，长度为10进制字符串，大小为0-4294967295
paramsFile.setWatermarkbitsStr("12345");
//嵌入频率，每n帧嵌入1帧。默认为10
paramsFile.setInterleaveRate("10");

WaterMarkShortVideoUtils.waterMarkIntoVideoShort(paramsFile);

提取暗水印信息

已获取嵌入暗水印信息的外泄视频。

步骤一：创建提取任务

登录办公安全平台控制台。
在左侧导航栏，选择数字水印服务 > 提取服务。
在提取服务页面，单击创建提取任务。

在创建提取服务面板，参考如下说明配置提取文件。

配置项	说明
水印版本	根据购买的水印版本选择。
水印类型	选择视频水印。
嵌入水印信息位宽	设置水印信息的位宽，位宽需要与嵌入SDK位宽（默认为32位）保持一致。
视频类型	选择短视频。
上传待提取水印文件	根据界面提示，上传获取到的泄露文件。

单击确定。
创建成功后，会在提取服务页面显示创建的任务信息。

步骤二：查看提取结果

水印任务创建完成后，您需要待提取成功后，查看提取结果，获取暗水印原文。

在提取服务页面，单击提取信息列展示。
在展开的信息中，您可以提取到暗水印原文（十进制数字）。

溯源泄露人员

将提取的暗水印原文和您业务中使用的映射服务或者自定义的映射表进行对应，从而定位出具体的泄露人员。

例如，您提取的暗水印原文是123456，映射表中123456对应的是张三，则定位出泄露人员是员工张三。