文档中心
实时音视频
视频能力
水印和截图

水印和截图

更新时间：2024-02-29 16:37

功能简介

本文档暂不适用于 Web 平台。

当需要为教育类的教学课件设置版权方 Logo 等场景下，可使用 SDK 的水印功能来实现。

本文主要讲述如何利用 SDK 实现水印和截图功能。

示例源码下载

请参考下载示例源码获取源码。

相关源码请查看 “lib\topics\OtherFunctions\beauty_watermark_snapshot” 目录下的文件。

前提条件

在实现水印和截图功能之前，请确保：

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目信息。
已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考快速开始 - 集成和快速开始 - 实现流程。

使用步骤

水印

调用 ZegoWatermark 配置一个水印的图片 URL 以及该水印在画面中的大小方位。

调用 setPublishWatermark 接口设置推流水印。

水印图片只支持 “PNG” 与 “JPEG” 两种图片格式，即 “.png”、“.jpg”、“.jpeg” 三种后缀的图片文件。

ZegoWatermark 对象中的 imageURL 参数支持传两种路径格式。

绝对路径

Android：file://[图片在 Android 设备中的绝对路径]，需要将图片存放在 Android 设备的某目录中，例如 Android 的 App 的私有目录：“/sdcard/Android/data/im.zego.zegoexpressapp/ZegoLogo.png”。
iOS：file://[图片在 Bundle 中的绝对路径]，需要将图片存放于项目 Bundle 内任意位置，通过 “NSBundle” 的 pathForResource:ofType: 方法获取图片的绝对路径，并加上 file:// 前缀。

// 支持 JPG 与 PNG 格式的图片
String imageURL = "file:///sdcard/Android/data/im.zego.zegoexpressapp/ZegoLogo.png";
// 水印布局左上角为坐标系原点，区域不能超过编码分辨率设置的大小。若为空表示取消水印
var layout = Rect.fromLTWH(0,0,300,600);
var watermark = ZegoWatermark(imageURL, layout);
// 设置水印，支持推流过程中动态修改
ZegoExpressEngine.instance.setPublishWatermark.setPublishWatermark(watermark: watermark, isPreviewVisible: true);

Assets

flutter-asset://[图片资源名称]：需要在 pubspec.yaml 中声明资源文件的相对路径。

// 支持 JPG 与 PNG 格式的图片
String imageURL = "flutter-asset://resources/images/ZegoLogo.png";

// 水印布局左上角为坐标系原点，区域不能超过编码分辨率设置的大小。若为空表示取消水印
var layout = Rect.fromLTWH(0,0,300,600);
var watermark = ZegoWatermark(imageURL,layout);
// 设置水印，支持推流过程中动态修改
ZegoExpressEngine.instance.setPublishWatermark.setPublishWatermark(watermark: watermark, isPreviewVisible: true);

截图

推流后，调用 takePublishStreamSnapshot 接口对推流画面截图。

ZegoExpressEngine.instance.takePublishStreamSnapshot().then((ZegoPublisherTakeSnapshotResult result) {
    // 保存图片     
});

拉流后，调用 takePlayStreamSnapshot 接口对拉流画面截图。

ZegoExpressEngine.instance.takePlayStreamSnapshot(streamID).then((ZegoPlayerTakeSnapshotResult result) {
    // 保存图片
});

常见问题

ZegoWatermark 中的 imageURL 如何指定？

支持 JPG 与 PNG 两种格式的图片，如果图片的路径为是设备上的绝对路径，imageURL 则须使用 file:// 为前缀 + 设备上的绝对路径；

如果路径是 Assets 形式，且图片是放在 Flutter 工程中，需要先在 pubspec.yaml 中声明资源文件的相对路径，imageURL 则须使用 “flutter-asset://” 作为前缀。
ZegoWatermark 中的 layout 如何指定？

水印的布局不能超过当前设置的推流的视频编码分辨率，对推流编码分辨率的设置可参考 setVideoConfig 接口。