# 直播水印 (/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="toc_watermark"></a>

<a id="api_irtcengine_addvideowatermark1"></a>

<a id="ariaid-title2"></a>

## addVideoWatermark [1/3] [#addvideowatermark-13]

向本地视频添加水印图像。

<a id="api_irtcengine_addvideowatermark1__prototype"></a>

```java
public abstract int addVideoWatermark(AgoraImage watermark)
```

<a id="api_irtcengine_addvideowatermark1__detailed_desc"></a>

<a id="废弃"></a>

:::error[废弃]
自 v2.9.1 版本废弃，请改用 [addVideoWatermark [3/3]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengine_addvideowatermark3)。
:::

该方法在直播场景中向本地视频流添加 PNG 格式的水印图像。频道内的所有用户（包括 CDN 观众）以及视频采集设备都可以看到并采集该水印图像。如果你只想向 CDN 推流添加水印，请使用 [startRtmpStreamWithTranscoding](/zh-CN/api-reference/rtc/android/cloud-media-relay/media-push#api_irtcengine_startrtmpstreamwithtranscoding) 方法。

:::note
注：

- 本地视频和 CDN 推流中 URL 的含义不同：在本地视频流中，URL 指的是添加的水印图像文件在本地视频流中的绝对路径；在 CDN 推流中，URL 指的是添加的水印图像在 CDN 推流中的 URL 地址。
- 水印图像的源文件必须为 PNG 格式。如果 PNG 文件的宽高与该方法中的设置不一致，SDK 会对 PNG 文件进行裁剪以符合设置。
- SDK 仅支持在本地视频或 CDN 推流中添加一张水印图像。新添加的水印图像会替换之前的图像。
:::

<a id="api_irtcengine_addvideowatermark1__parameters"></a>

### 参数 [#参数]

<ParameterList>
<a id="watermark"></a>
<Parameter name="watermark">

要添加到本地直播中的水印图像。详见 [AgoraImage](/zh-CN/api-reference/rtc/android/class-rtcimage)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_addvideowatermark1__return_values"></a>

### 返回值 [#返回值]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类]

- [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_addvideowatermark2"></a>

<a id="ariaid-title3"></a>

## addVideoWatermark [2/3] [#addvideowatermark-23]

向本地视频添加水印图像。

<a id="api_irtcengine_addvideowatermark2__prototype"></a>

```java
public abstract int addVideoWatermark(String watermarkUrl, WatermarkOptions options)
```

<a id="api_irtcengine_addvideowatermark2__detailed_desc"></a>

<a id="废弃-1"></a>

:::error[废弃]
自 v4.6.0 版本废弃，请改用 [addVideoWatermark [3/3]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengine_addvideowatermark3) 方法。
:::

该方法在直播中向本地视频添加 PNG 格式的水印图像。添加水印后，频道中的所有观众（包括 CDN 观众）以及采集设备都可以看到并采集到该水印图像。声网 SDK 每个直播视频流仅支持添加一张水印图像，新添加的水印会替换之前的图像。
水印图像的位置依赖于 [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 方法中的设置：

- 如果编码视频的方向模式（[ORIENTATION_MODE](/zh-CN/api-reference/rtc/android/enum-orientationmode)）为固定横屏模式或自适应横屏模式，则水印使用横屏方向。
- 如果编码视频的方向模式为固定竖屏模式或自适应竖屏模式，则水印使用竖屏方向。
- 设置水印位置时，区域必须小于 [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 方法中设置的尺寸，否则水印图像会被裁剪。

你可以通过设置 `visibleInPreview` 参数控制预览时水印的可见性。但其最终是否生效还取决于调用 [setupLocalVideo](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setuplocalvideo) 时设置的 `position` 参数（视频帧在视频链路中的位置）：

- 观察位置 `VIDEO_MODULE_POSITION_POST_CAPTURER`（默认）：`visiblePreview` 为 true，则水印可见；`visiblePreview` 为 false，则水印不可见。
- 观察位置 `VIDEO_MODULE_POSITION_PRE_ENCODER`：`visiblePreview` 为 true，则水印可见；`visiblePreview` 为 false，则水印仍可见。

:::note
注：

- 请确保在调用该方法前已调用 [enableVideo](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_enablevideo)。
- 如果你只想为媒体推流添加水印，可以调用该方法或 [startRtmpStreamWithTranscoding](/zh-CN/api-reference/rtc/android/cloud-media-relay/media-push#api_irtcengine_startrtmpstreamwithtranscoding) 方法。
- 该方法仅支持添加 PNG 文件格式的水印图像。支持的 PNG 图像像素格式包括 RGBA、RGB、Palette、Gray 和 Alpha_gray。
- 如果 PNG 图像的尺寸与该方法中的设置不一致，图像将被裁剪或缩放以符合设置。
- 如果你为本地视频启用了镜像模式，则本地视频中的水印也会被镜像。为避免水印被镜像，声网建议不要同时使用本地视频的镜像和水印功能。你可以在应用层实现水印功能。
:::

<a id="api_irtcengine_addvideowatermark2__parameters"></a>

### 参数 [#参数-1]

<ParameterList>
<a id="watermarkurl"></a>
<Parameter name="watermarkUrl">

要添加的水印图像的本地文件路径。支持使用本地绝对路径或相对路径。

</Parameter>
<a id="options"></a>
<Parameter name="options">

水印图像的相关设置。详见 [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_addvideowatermark2__return_values"></a>

### 返回值 [#返回值-1]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-1]

- [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_addvideowatermark3"></a>

<a id="ariaid-title4"></a>

## addVideoWatermark [3/3] [#addvideowatermark-33]

向本地视频流添加水印图像。

<a id="api_irtcengine_addvideowatermark3__prototype"></a>

```java
public abstract int addVideoWatermark(WatermarkConfig config);
```

<a id="api_irtcengine_addvideowatermark3__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

你可以使用该方法通过 [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig) 配置，在本地视频流中叠加水印图像，包括设置水印在预览中的位置、大小和可见性。

<a id="api_irtcengine_addvideowatermark3__parameters"></a>

### 参数 [#参数-2]

<ParameterList>
<a id="config"></a>
<Parameter name="config">

水印配置。详见 [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_addvideowatermark3__return_values"></a>

### 返回值 [#返回值-2]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-2]

- [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)

<a id="api_irtcengineex_addvideowatermarkex"></a>

<a id="ariaid-title5"></a>

## addVideoWatermarkEx [1/2] [#addvideowatermarkex-12]

向本地视频添加水印图像。

<a id="api_irtcengineex_addvideowatermarkex__prototype"></a>

```java
public abstract int addVideoWatermarkEx(String watermarkUrl, WatermarkOptions options, RtcConnection connection)
```

<a id="api_irtcengineex_addvideowatermarkex__detailed_desc"></a>

<a id="废弃-2"></a>

:::error[废弃]
自 v4.6.0 版本废弃，请改用 [addVideoWatermarkEx [2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengineex_addvideowatermarkex1) 方法。
:::

该方法在直播中向本地视频添加 PNG 格式的水印图像。添加水印图像后，频道中的所有观众（包括 CDN 观众）以及采集设备都可以看到并采集该图像。声网 SDK 仅支持在一个直播视频流中添加一张水印图像，新添加的水印图像会替换之前的图像。
水印图像的坐标依赖于 [setVideoEncoderConfigurationEx](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengineex_setvideoencoderconfigurationex) 方法中的设置：

- 如果编码视频的方向模式（[ORIENTATION_MODE](/zh-CN/api-reference/rtc/android/enum-orientationmode)）为固定横屏模式或自适应横屏模式，则水印使用横屏方向。
- 如果编码视频的方向模式为固定竖屏模式或自适应竖屏模式，则水印使用竖屏方向。
- 设置水印位置时，区域必须小于 [setVideoEncoderConfigurationEx](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengineex_setvideoencoderconfigurationex) 方法中设置的尺寸，否则水印图像会被裁剪。

:::note
注：

- 请确保在调用该方法前已调用 [enableVideo](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_enablevideo) 方法。
- 该方法仅支持添加 PNG 文件格式的水印图像。支持的 PNG 图像像素格式包括 RGBA、RGB、Palette、Gray 和 Alpha_gray。
- 如果 PNG 图像的尺寸与该方法中的设置不一致，图像将被裁剪或缩放以符合设置。
- 如果你已通过调用 `startPreview` 方法启用了本地视频预览，可以使用 `visibleInPreview` 成员设置水印在预览中是否可见。
- 如果你为本地视频启用了镜像模式，则本地视频中的水印也会被镜像。为避免水印被镜像，声网建议不要同时使用本地视频的镜像和水印功能。你可以在应用层实现水印功能。
:::

<a id="api_irtcengineex_addvideowatermarkex__scenario"></a>

### 适用场景 [#适用场景]

该方法适用于多频道场景。

<a id="api_irtcengineex_addvideowatermarkex__parameters"></a>

### 参数 [#参数-3]

<ParameterList>
<a id="watermarkurl-1"></a>
<Parameter name="watermarkUrl">

要添加的水印图像的本地文件路径。支持使用本地绝对路径或相对路径。

</Parameter>
<a id="options-1"></a>
<Parameter name="options">

水印图像的相关设置。详见 [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)。

</Parameter>
<a id="connection"></a>
<Parameter name="connection">

连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/android/class-rtcconnection)。

</Parameter>
</ParameterList>

<a id="api_irtcengineex_addvideowatermarkex__return_values"></a>

### 返回值 [#返回值-3]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-3]

- [RtcEngineEx](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengineex)

<a id="api_irtcengineex_addvideowatermarkex1"></a>

<a id="ariaid-title6"></a>

## addVideoWatermarkEx [2/2] [#addvideowatermarkex-22]

向本地视频添加水印图像。

<a id="api_irtcengineex_addvideowatermarkex1__prototype"></a>

```java
public abstract int addVideoWatermarkEx(WatermarkConfig config, RtcConnection connection);
```

<a id="api_irtcengineex_addvideowatermarkex1__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_irtcengineex_addvideowatermarkex1__scenario"></a>

### 适用场景 [#适用场景-1]

该方法适用于多频道场景。

<a id="api_irtcengineex_addvideowatermarkex1__parameters"></a>

### 参数 [#参数-4]

<ParameterList>
<a id="config-1"></a>
<Parameter name="config">

水印配置。详见 [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig)。

</Parameter>
<a id="connection-1"></a>
<Parameter name="connection">

[RtcConnection](/zh-CN/api-reference/rtc/android/class-rtcconnection) 对象。详见 [RtcConnection](/zh-CN/api-reference/rtc/android/class-rtcconnection)。

</Parameter>
</ParameterList>

<a id="api_irtcengineex_addvideowatermarkex1__return_values"></a>

### 返回值 [#返回值-4]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-4]

- [RtcEngineEx](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengineex)

<a id="api_irtcengineex_clearvideowatermarkex"></a>

<a id="ariaid-title7"></a>

## clearVideoWatermarkEx [#clearvideowatermarkex]

从视频流中移除水印图像。

<a id="api_irtcengineex_clearvideowatermarkex__prototype"></a>

```java
public abstract int clearVideoWatermarkEx(RtcConnection connection);
```

<a id="api_irtcengineex_clearvideowatermarkex__detailed_desc"></a>

<a id="api_irtcengineex_clearvideowatermarkex__scenario"></a>

### 适用场景 [#适用场景-2]

该方法适用于多频道场景。

<a id="api_irtcengineex_clearvideowatermarkex__parameters"></a>

### 参数 [#参数-5]

<ParameterList>
<a id="connection-2"></a>
<Parameter name="connection">

连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/android/class-rtcconnection)。

</Parameter>
</ParameterList>

<a id="api_irtcengineex_clearvideowatermarkex__return_values"></a>

### 返回值 [#返回值-5]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-5]

- [RtcEngineEx](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengineex)

<a id="api_irtcengine_clearvideowatermarks"></a>

<a id="ariaid-title8"></a>

## clearVideoWatermarks [#clearvideowatermarks]

从视频流中移除水印图像。

<a id="api_irtcengine_clearvideowatermarks__prototype"></a>

```java
public abstract int clearVideoWatermarks();
```

<a id="api_irtcengine_clearvideowatermarks__detailed_desc"></a>

<a id="api_irtcengine_clearvideowatermarks__return_values"></a>

### 返回值 [#返回值-6]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-6]

- [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)

<a id="api_watermarkbuffer_getbuffer"></a>

<a id="ariaid-title9"></a>

## getBuffer [#getbuffer]

获取水印图像的数据缓冲区。

<a id="api_watermarkbuffer_getbuffer__prototype"></a>

```java
public ByteBuffer getBuffer()
```

<a id="api_watermarkbuffer_getbuffer__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkbuffer_getbuffer__return_values"></a>

### 返回值 [#返回值-7]

方法调用成功时，返回包含水印图像数据的 `ByteBuffer` 对象。

### 所属接口类 [#所属接口类-7]

- [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer)

<a id="api_watermarkbuffer_getformat"></a>

<a id="ariaid-title10"></a>

## getFormat [#getformat]

获取水印图像的格式。

<a id="api_watermarkbuffer_getformat__prototype"></a>

```java
public int getFormat()
```

<a id="api_watermarkbuffer_getformat__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkbuffer_getformat__return_values"></a>

### 返回值 [#返回值-8]

方法调用成功，返回水印图像缓冲区的格式。

### 所属接口类 [#所属接口类-8]

- [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer)

<a id="api_watermarkbuffer_getheight"></a>

<a id="ariaid-title11"></a>

## getHeight [#getheight]

获取水印图像的高度。

<a id="api_watermarkbuffer_getheight__prototype"></a>

```java
public int getHeight()
```

<a id="api_watermarkbuffer_getheight__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkbuffer_getheight__return_values"></a>

### 返回值 [#返回值-9]

方法调用成功，返回水印图像的高度，单位为像素。

### 所属接口类 [#所属接口类-9]

- [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer)

<a id="api_watermarkbuffer_getid"></a>

<a id="ariaid-title12"></a>

## getId [#getid]

获取水印的唯一标识符。

<a id="api_watermarkbuffer_getid__prototype"></a>

```java
public String getId()
```

<a id="api_watermarkbuffer_getid__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

用于从 [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer) 或 [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig) 实例中获取水印的唯一标识符。

<a id="api_watermarkbuffer_getid__return_values"></a>

### 返回值 [#返回值-10]

- 方法调用成功时，返回水印的唯一标识符。
- 方法调用失败，返回空字符串。

### 所属接口类 [#所属接口类-10]

- [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer)

<a id="api_watermarkconfig_getimageurl"></a>

<a id="ariaid-title13"></a>

## getImageUrl [#getimageurl]

获取水印图像的 URL。

<a id="api_watermarkconfig_getimageurl__prototype"></a>

```java
public String getImageUrl()
```

<a id="api_watermarkconfig_getimageurl__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkconfig_getimageurl__return_values"></a>

### 返回值 [#返回值-11]

- 方法调用成功时，返回水印图像的 URL。
- 方法调用失败，返回空字符串。

### 所属接口类 [#所属接口类-11]

- [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig)

<a id="api_watermarkoptions_getpositioninlandscapemode"></a>

<a id="ariaid-title14"></a>

## getPositionInLandscapeMode [#getpositioninlandscapemode]

获取横屏模式下水印的位置。

<a id="api_watermarkoptions_getpositioninlandscapemode__prototype"></a>

```java
public int[] getPositionInLandscapeMode()
```

<a id="api_watermarkoptions_getpositioninlandscapemode__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkoptions_getpositioninlandscapemode__return_values"></a>

### 返回值 [#返回值-12]

方法调用成功，返回一个包含四个元素的整数数组，依次表示水印矩形的 x、y、宽度和高度。

### 所属接口类 [#所属接口类-12]

- [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)

<a id="api_watermarkoptions_getpositioninportraitmode"></a>

<a id="ariaid-title15"></a>

## getPositionInPortraitMode [#getpositioninportraitmode]

获取竖屏模式下水印的位置。

<a id="api_watermarkoptions_getpositioninportraitmode__prototype"></a>

```java
public int[] getPositionInPortraitMode()
```

<a id="api_watermarkoptions_getpositioninportraitmode__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkoptions_getpositioninportraitmode__return_values"></a>

### 返回值 [#返回值-13]

方法调用成功，返回一个包含四个元素的整数数组，分别表示水印矩形的 x、y、宽度和高度。

### 所属接口类 [#所属接口类-13]

- [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)

<a id="api_watermarkconfig_gettype"></a>

<a id="ariaid-title16"></a>

## getType [#gettype]

获取当前水印配置中的水印类型信息。

<a id="api_watermarkconfig_gettype__prototype"></a>

```java
public int getType()
```

<a id="api_watermarkconfig_gettype__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkconfig_gettype__return_values"></a>

### 返回值 [#返回值-14]

方法调用成功，返回水印类型：

- `WATERMARK_TYPE_IMAGE`：图片水印。
- `WATERMARK_TYPE_BUFFER`：Buffer 水印。

### 所属接口类 [#所属接口类-14]

- [WatermarkConfig](/zh-CN/api-reference/rtc/android/class-watermarkconfig)

<a id="api_watermarkbuffer_getwidth"></a>

<a id="ariaid-title17"></a>

## getWidth [#getwidth]

获取水印图像的宽度。

<a id="api_watermarkbuffer_getwidth__prototype"></a>

```java
public int getWidth()
```

<a id="api_watermarkbuffer_getwidth__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkbuffer_getwidth__return_values"></a>

### 返回值 [#返回值-15]

方法调用成功，返回水印图像的宽度，单位为像素。

### 所属接口类 [#所属接口类-15]

- [WatermarkBuffer](/zh-CN/api-reference/rtc/android/class-watermarkbuffer)

<a id="api_watermarkoptions_getzorder"></a>

<a id="ariaid-title18"></a>

## getzOrder [#getzorder]

获取水印图像的 Z-order 索引。

<a id="api_watermarkoptions_getzorder__prototype"></a>

```java
public int getzOrder()
```

<a id="api_watermarkoptions_getzorder__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkoptions_getzorder__return_values"></a>

### 返回值 [#返回值-16]

方法调用成功，返回水印图像的 Z-order 索引。

### 所属接口类 [#所属接口类-16]

- [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)

<a id="api_watermarkoptions_isvisibleinpreview"></a>

<a id="ariaid-title19"></a>

## isVisibleInPreview [#isvisibleinpreview]

检查水印在本地视频预览中是否可见。

<a id="api_watermarkoptions_isvisibleinpreview__prototype"></a>

```java
public boolean isVisibleInPreview()
```

<a id="api_watermarkoptions_isvisibleinpreview__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_watermarkoptions_isvisibleinpreview__return_values"></a>

### 返回值 [#返回值-17]

- true：水印在本地视频预览中可见。
- false：水印在本地视频预览中不可见。

### 所属接口类 [#所属接口类-17]

- [WatermarkOptions](/zh-CN/api-reference/rtc/android/class-watermarkoptions)

<a id="api_irtcengine_removevideowatermark"></a>

<a id="ariaid-title20"></a>

## removeVideoWatermark [#removevideowatermark]

从本地视频中移除水印图像。

<a id="api_irtcengine_removevideowatermark__prototype"></a>

```java
public abstract int removeVideoWatermark(String id);
```

<a id="api_irtcengine_removevideowatermark__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

该方法使用指定的唯一 ID，从本地视频流中移除之前添加的水印图像。

<a id="api_irtcengine_removevideowatermark__parameters"></a>

### 参数 [#参数-6]

<ParameterList>
<a id="id"></a>
<Parameter name="id">

要移除的水印图像的 ID。

</Parameter>
</ParameterList>

<a id="api_irtcengine_removevideowatermark__return_values"></a>

### 返回值 [#返回值-18]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-18]

- [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)

<a id="api_irtcengineex_removevideowatermarkex"></a>

<a id="ariaid-title21"></a>

## removeVideoWatermarkEx [#removevideowatermarkex]

从本地或远端视频流中移除指定的水印图像。

<a id="api_irtcengineex_removevideowatermarkex__prototype"></a>

```java
public abstract int removeVideoWatermarkEx(String id, RtcConnection connection);
```

<a id="api_irtcengineex_removevideowatermarkex__detailed_desc"></a>

:::info[自从]
自 v4.6.0 版本新增。
:::

<a id="api_irtcengineex_removevideowatermarkex__scenario"></a>

### 适用场景 [#适用场景-3]

该方法适用于多频道场景。

<a id="api_irtcengineex_removevideowatermarkex__parameters"></a>

### 参数 [#参数-7]

<ParameterList>
<a id="id-1"></a>
<Parameter name="id">

要移除的水印图像的 ID。

</Parameter>
<a id="connection-3"></a>
<Parameter name="connection">

连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/android/class-rtcconnection)。

</Parameter>
</ParameterList>

<a id="api_irtcengineex_removevideowatermarkex__return_values"></a>

### 返回值 [#返回值-19]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-19]

- [RtcEngineEx](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengineex)