# AgoraImage (/zh-CN/api-reference/rtc/harmonyos/class-rtcimage)

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

<a id="class_rtcimage__prototype"></a>

```ts
export class AgoraImage {

  public url: string;

  public x: number;

  public y: number;

  public width: number;

  public height: number;

  public zOrder: number;

  public alpha: number;
  constructor(url: string) {
    this.url = url;
    this.x = 0;
    this.y = 0;
    this.width = 0;
    this.height = 0;
    this.zOrder = 0;
    this.alpha = 1.0;
  }
}
```

<a id="class_rtcimage__detailed_desc"></a>

### 详情 [#详情]

用于设置直播视频的水印和背景图片的属性。

<a id="class_rtcimage__parameters"></a>

##

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

直播视频上图片的 HTTP/HTTPS 地址。字符长度不得超过 1024 字节。

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

图片在视频画面上的 x 坐标 (px)，以输出视频画面的左上角为原点。

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

图片在视频画面上的 y 坐标 (px)，以输出视频画面的左上角为原点。

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

图片在视频画面上的宽度 (px)。

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

图片在视频画面上的高度 (px)。

</Parameter>
<a id="zorder"></a>
<Parameter name="zOrder">

水印或背景图的图层编号。使用水印数组添加单张或多张水印时，必须向 zOrder 传值，取值范围为 [1,255]，否则 SDK 会报错。其余情况，zOrder 可选传值，取值范围为 [0,255]，0 为默认值。0 代表图层的最下层，255 代表图层的最上层。

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

水印或背景图片的透明度。取值范围为 [0.0,1.0]：

- 0.0: 完全透明。
- 1.0:（默认）完全不透明。

</Parameter>
</ParameterList>