# com.herewhite.sdk.domain.CameraBound class 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound)

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

<a id="details"></a>

## 详细描述 [#详细描述]

适用版本：**Whiteboard Android SDK 2.16.134**。

`CameraBound` 类，用于设置视角边界。

视角边界指白板场景内，用户可以移动视角的范围。当视角超出视角边界时，视角会被拉回。

@since 2.5.0

父类：[WhiteObject](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-white-object)；继承接口详见父类。

## 属性与 JSON 字段 [#属性与-json-字段]

Java 非公开字段通过对应 getter/setter 访问；可选包装类型未设置时通常不写入 JSON。初值包含字段声明及无参构造中的直接赋值；其他构造参数以签名为准。

| 字段 | 声明 | 源码初值 | 说明 |
| --- | --- | --- | --- |
| [damping](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a6afe0800bc35d488e35b198b5595a313) | `Double damping` | 未显式赋值 | [api-center-table-0 details](#table-slot-api-center-table-0) |
| [centerX](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a6ab9a20dca26acfa1823417d3a3254df) | `Double centerX` | 未显式赋值 | [api-center-table-1 details](#table-slot-api-center-table-1) |
| [centerY](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a984c6c79a0848533b726e9d4a98ceee2) | `Double centerY` | 未显式赋值 | [api-center-table-2 details](#table-slot-api-center-table-2) |
| [width](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#afb1e1adca8f3871319e9099722689098) | `Double width` | 未显式赋值 | [api-center-table-3 details](#table-slot-api-center-table-3) |
| [height](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#abac1050d246229bdeee8352f52f9780c) | `Double height` | 未显式赋值 | [api-center-table-4 details](#table-slot-api-center-table-4) |
| [maxContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a5ca1b7ce61956bfa3b61ef78363dd321) | `ContentModeConfig maxContentMode` | 未显式赋值 | [api-center-table-5 details](#table-slot-api-center-table-5) |
| [minContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#acde2ab44615b44bb15f876448ec158b7) | `ContentModeConfig minContentMode` | 未显式赋值 | [api-center-table-6 details](#table-slot-api-center-table-6) |

<a id="table-slot-api-center-table-0"></a>

**api-center-table-0 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-1"></a>

**api-center-table-1 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-2"></a>

**api-center-table-2 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-3"></a>

**api-center-table-3 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-4"></a>

**api-center-table-4 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-5"></a>

**api-center-table-5 details**

模型属性；通过对应 getter/setter 访问。

<a id="table-slot-api-center-table-6"></a>

**api-center-table-6 details**

模型属性；通过对应 getter/setter 访问。

| 公开成员签名 |  |
| --- | --- |
|  | [CameraBound](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#aac38180b4a2b591c2f0a5d933318f991) () |
|  | [CameraBound](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#ab3be3d1c15ab69dcf067dcba4d5cea00) (Double miniScale, Double maxScale) |
| Double | [getCenterX](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#af10a016ee2828d33beb9f63012d4f5d6) () |
| void | [setCenterX](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a55381452b418bd007dace0e3ab42e2a9) (Double centerX) |
| Double | [getCenterY](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a07258c5ab55fa52c2e358f78e1fdfa0c) () |
| void | [setCenterY](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#aeb79b8c1d7c9471dc8e8e683d27bfc9c) (Double centerY) |
| Double | [getWidth](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a2959924ced012f75c8f7af2e2385ab8a) () |
| void | [setWidth](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a9d516aef8b71282fcfe9bf0512767373) (Double width) |
| Double | [getHeight](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#ac9f6023ff209476e7dad1421f32e6099) () |
| void | [setHeight](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a9359ae034e2dc924d686604d4d1a42a3) (Double height) |
| ContentModeConfig | [getMaxContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a3f86f60880e9462b8a64775972aa6cdf) () |
| void | [setMaxContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#ab00400e0704e141608d676e058c7806b) (ContentModeConfig maxContentMode) |
| ContentModeConfig | [getMinContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#aa40a670d489a70de4b9e903d69e3c465) () |
| void | [setMinContentMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a4237cf9e50393447e59a23b54e352735) (ContentModeConfig minContentMode) |
| Double | [getDamping](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#a68edcda93e00c71ead62c96fb908a507) () |
| void | [setDamping](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-camera-bound#ac387fa1a63ff3df2a70276c8d1f52353) (Double damping) |

## 变量说明 [#变量说明]

<a id="a6afe0800bc35d488e35b198b5595a313"></a>

### damping [#damping]

```text
Double damping
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="a6ab9a20dca26acfa1823417d3a3254df"></a>

### centerX [#centerx]

```text
Double centerX
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="a984c6c79a0848533b726e9d4a98ceee2"></a>

### centerY [#centery]

```text
Double centerY
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="afb1e1adca8f3871319e9099722689098"></a>

### width [#width]

```text
Double width
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="abac1050d246229bdeee8352f52f9780c"></a>

### height [#height]

```text
Double height
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="a5ca1b7ce61956bfa3b61ef78363dd321"></a>

### maxContentMode [#maxcontentmode]

```text
ContentModeConfig maxContentMode
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

<a id="acde2ab44615b44bb15f876448ec158b7"></a>

### minContentMode [#mincontentmode]

```text
ContentModeConfig minContentMode
```

源码初值：未显式赋值

模型属性；通过对应 getter/setter 访问。

## 函数说明 [#函数说明]

<a id="aac38180b4a2b591c2f0a5d933318f991"></a>

### CameraBound() [#camerabound]

<ApiSignature>

CameraBound()

</ApiSignature>

CameraBound：com.herewhite.sdk.domain.CameraBound 的公开成员。参数和返回类型见下方签名。

<a id="ab3be3d1c15ab69dcf067dcba4d5cea00"></a>

### CameraBound() [#camerabound-1]

<ApiSignature>

CameraBound(Double miniScale, Double maxScale)

</ApiSignature>

初始化视角边界。

<ParameterList title="参数">
<Parameter name="miniScale">

视角边界的最小缩放比例。

</Parameter>
<Parameter name="maxScale">

视角边界的最大缩放比例。

</Parameter>
</ParameterList>

<a id="af10a016ee2828d33beb9f63012d4f5d6"></a>

### getCenterX() [#getcenterx]

<ApiSignature>

Double getCenterX()

</ApiSignature>

获取视角边界的中心点在世界坐标系（以白板初始化时的中心点为原点的坐标系）中的 X 轴坐标。

<h4 data-toc-hidden="true" id={"返回值"}>返回值</h4>

视角边界的中心点在世界坐标系中的 X 轴坐标。

<a id="a55381452b418bd007dace0e3ab42e2a9"></a>

### setCenterX() [#setcenterx]

<ApiSignature>

void setCenterX(Double centerX)

</ApiSignature>

设置视角边界的中心点在世界坐标系（以白板初始化时的中心点为原点的坐标系）中的 X 轴坐标。

<ParameterList title="参数">
<Parameter name="centerX">

视角边界的中心点在世界坐标系的 X 轴坐标。默认值为 0.0。

</Parameter>
</ParameterList>

<a id="a07258c5ab55fa52c2e358f78e1fdfa0c"></a>

### getCenterY() [#getcentery]

<ApiSignature>

Double getCenterY()

</ApiSignature>

获取视角边界的中心点在世界坐标系（以白板初始化时的中心点为原点的坐标系）中的 Y 轴坐标。

<h4 data-toc-hidden="true" id={"返回值-1"}>返回值</h4>

视角边界的中心点在世界坐标系中的 Y 轴坐标。

<a id="aeb79b8c1d7c9471dc8e8e683d27bfc9c"></a>

### setCenterY() [#setcentery]

<ApiSignature>

void setCenterY(Double centerY)

</ApiSignature>

设置视角边界的中心点在世界坐标系（以白板初始化时的中心点为原点的坐标系）中的 Y 轴坐标。

<ParameterList title="参数">
<Parameter name="centerY">

视角边界的中心点在世界坐标系中的 Y 轴坐标。默认值为 0.0。

</Parameter>
</ParameterList>

<a id="a2959924ced012f75c8f7af2e2385ab8a"></a>

### getWidth() [#getwidth]

<ApiSignature>

Double getWidth()

</ApiSignature>

获取视角边界的宽度。

<h4 data-toc-hidden="true" id={"返回值-2"}>返回值</h4>

视角边界的宽度，单位为像素。

<a id="a9d516aef8b71282fcfe9bf0512767373"></a>

### setWidth() [#setwidth]

<ApiSignature>

void setWidth(Double width)

</ApiSignature>

设置视角边界的宽度。

<ParameterList title="参数">
<Parameter name="width">

视角边界的宽度，单位为像素。如果不填，则表示无限制。

</Parameter>
</ParameterList>

<a id="ac9f6023ff209476e7dad1421f32e6099"></a>

### getHeight() [#getheight]

<ApiSignature>

Double getHeight()

</ApiSignature>

获取视角边界的宽度。

<h4 data-toc-hidden="true" id={"返回值-3"}>返回值</h4>

视角边界的宽度，单位为像素。

<a id="a9359ae034e2dc924d686604d4d1a42a3"></a>

### setHeight() [#setheight]

<ApiSignature>

void setHeight(Double height)

</ApiSignature>

设置视角边界的高度。

<ParameterList title="参数">
<Parameter name="height">

视角边界的高度，单位为像素。如果不填，则表示无限制。

</Parameter>
</ParameterList>

<a id="a3f86f60880e9462b8a64775972aa6cdf"></a>

### getMaxContentMode() [#getmaxcontentmode]

<ApiSignature>

ContentModeConfig getMaxContentMode()

</ApiSignature>

获取视角边界的缩放模式和最大缩放比例。

<h4 data-toc-hidden="true" id={"返回值-4"}>返回值</h4>

视角边界的缩放模式和最大缩放比例，详见 [`ContentModeConfig`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-content-mode-config)。

<a id="ab00400e0704e141608d676e058c7806b"></a>

### setMaxContentMode() [#setmaxcontentmode]

<ApiSignature>

void setMaxContentMode(ContentModeConfig maxContentMode)

</ApiSignature>

设置视角边界的缩放模式和最大缩放比例。

<ParameterList title="参数">
<Parameter name="maxContentMode">

视角边界的最大缩放比例，详见 [`ContentModeConfig`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-content-mode-config)。

</Parameter>
</ParameterList>

<a id="aa40a670d489a70de4b9e903d69e3c465"></a>

### getMinContentMode() [#getmincontentmode]

<ApiSignature>

ContentModeConfig getMinContentMode()

</ApiSignature>

获取视角边界的缩放模式和最小缩放比例。

<h4 data-toc-hidden="true" id={"返回值-5"}>返回值</h4>

视角边界的缩放模式和最小缩放比例，详见 [`ContentModeConfig`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-content-mode-config)。

<a id="a4237cf9e50393447e59a23b54e352735"></a>

### setMinContentMode() [#setmincontentmode]

<ApiSignature>

void setMinContentMode(ContentModeConfig minContentMode)

</ApiSignature>

设置视角边界的缩放模式和最小缩放比例。

<ParameterList title="参数">
<Parameter name="minContentMode">

视角边界的缩放模式和最小缩放比例，详见 [`ContentModeConfig`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-content-mode-config)。

</Parameter>
</ParameterList>

<a id="a68edcda93e00c71ead62c96fb908a507"></a>

### getDamping() [#getdamping]

<ApiSignature>

Double getDamping()

</ApiSignature>

获取用户将视角移出视角边界时感受到的阻力。

<h4 data-toc-hidden="true" id={"返回值-6"}>返回值</h4>

用户将视角移出视角边界时感受到的阻力。返回值范围为 [0.0,1.0]。数值越大，用户感受到的阻力越大。

<a id="ac387fa1a63ff3df2a70276c8d1f52353"></a>

### setDamping() [#setdamping]

<ApiSignature>

void setDamping(Double damping)

</ApiSignature>

设置用户将视角移出视角边界时感受到的阻力。

<ParameterList title="参数">
<Parameter name="damping">

阻力大小，取值范围为 [0.0,1.0]。取值越大，用户感受到的阻力越大。

- `0.0`: 用户将视角移出视角边界时，完全感受不到阻力，但当其手指离开屏幕时，视角会恢复到原位。
- `1.0`: 用户完全无法将视角移出视角边界。

</Parameter>
</ParameterList>