# com.herewhite.sdk.domain.FontFace class 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face)

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

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

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

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

字体配置文件，与 CSS 中的 FontFace 属性对应。

@since 2.11.2

父类：[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。初值包含字段声明及无参构造中的直接赋值；其他构造参数以签名为准。

| 字段 | 声明 | 源码初值 | 说明 |
| --- | --- | --- | --- |
| [fontStyle](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#ad4158c1a9c77a5db0fe16bcdd13d0fd4) | `String fontStyle` | 未显式赋值 | [api-center-table-0 details](#table-slot-api-center-table-0) |
| [fontWeight](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#aea28be0320403e6e1988594e3c08d967) | `String fontWeight` | 未显式赋值 | [api-center-table-1 details](#table-slot-api-center-table-1) |
| [unicodeRange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#ad9fb6e44d45ca575dd98fda75e026399) | `String unicodeRange` | 未显式赋值 | [api-center-table-2 details](#table-slot-api-center-table-2) |

<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 访问。

| 公开成员签名 |  |
| --- | --- |
|  | [FontFace](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a48ed64a608bba4db25828caa3dbff8f0) (String name, String src) |
| String | [getFontStyle](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a37ca89dae1d4e960d0f6e9a65579c3fa) () |
| void | [setFontStyle](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a41293fe1125f886054e0e1c56f1b991a) (String fontStyle) |
| String | [getFontWeight](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a55327d829a14b4f69b6738d919e327a2) () |
| void | [setFontWeight](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a403eb10a186b43d00822fa20e00557f0) (String fontWeight) |
| String | [getUnicodeRange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a200e0a6bccafb002d3d4dcad79a8fd81) () |
| void | [setUnicodeRange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-font-face#a033cd9a8448c1d12378834c84074a35b) (String unicodeRange) |

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

<a id="ad4158c1a9c77a5db0fe16bcdd13d0fd4"></a>

### fontStyle [#fontstyle]

```text
String fontStyle
```

源码初值：未显式赋值

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

<a id="aea28be0320403e6e1988594e3c08d967"></a>

### fontWeight [#fontweight]

```text
String fontWeight
```

源码初值：未显式赋值

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

<a id="ad9fb6e44d45ca575dd98fda75e026399"></a>

### unicodeRange [#unicoderange]

```text
String unicodeRange
```

源码初值：未显式赋值

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

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

<a id="a48ed64a608bba4db25828caa3dbff8f0"></a>

### FontFace() [#fontface]

<ApiSignature>

FontFace(String name, String src)

</ApiSignature>

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

字体名称，需要和 CSS 中 `font-family` 字段的值对应。

</Parameter>
<Parameter name="src">

字体文件的地址，需要和 CSS 中 `src` 字段的值对应。支持的格式为 `url()`，表示指向远程字体文件位置，例如，`url("https://white-pan.oss-cn-shanghai.aliyuncs.com/Pacifico-Regular.ttf")`。

</Parameter>
</ParameterList>

<a id="a37ca89dae1d4e960d0f6e9a65579c3fa"></a>

### getFontStyle() [#getfontstyle]

<ApiSignature>

String getFontStyle()

</ApiSignature>

获取字体样式。

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

字体样式。

<a id="a41293fe1125f886054e0e1c56f1b991a"></a>

### setFontStyle() [#setfontstyle]

<ApiSignature>

void setFontStyle(String fontStyle)

</ApiSignature>

设置字体样式。

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

字体样式，需要和 CSS 中 `font-style` 字段的值对应，取值包括：

- `normal`：（默认）常规。
- `italic`：斜体。

</Parameter>
</ParameterList>

<a id="a55327d829a14b4f69b6738d919e327a2"></a>

### getFontWeight() [#getfontweight]

<ApiSignature>

String getFontWeight()

</ApiSignature>

获取字体粗细。

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

字体粗细。

<a id="a403eb10a186b43d00822fa20e00557f0"></a>

### setFontWeight() [#setfontweight]

<ApiSignature>

void setFontWeight(String fontWeight)

</ApiSignature>

设置字体粗细。

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

字体粗细，需要和 CSS 中 `font-weight` 字段的值对应。

</Parameter>
</ParameterList>

<a id="a200e0a6bccafb002d3d4dcad79a8fd81"></a>

### getUnicodeRange() [#getunicoderange]

<ApiSignature>

String getUnicodeRange()

</ApiSignature>

获取字体的字符编码范围。

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

字体的字符编码范围

<a id="a033cd9a8448c1d12378834c84074a35b"></a>

### setUnicodeRange() [#setunicoderange]

<ApiSignature>

void setUnicodeRange(String unicodeRange)

</ApiSignature>

设置字体的字符编码范围。

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

字体的字符编码范围，需要和 CSS 中 `unicode-range` 字段的值对应。

</Parameter>
</ParameterList>