# com.herewhite.sdk.WhiteSdkConfiguration class 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
适用版本:**Whiteboard Android SDK 2.16.134**。
`WhiteSdk` 实例的配置。
@note 成功初始化 `WhiteSdk` 后,无法再调用 `WhiteSdkConfiguration` 类中的任何方法修改 `WhiteSdk` 的配置。
父类:[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。初值包含字段声明及无参构造中的直接赋值;其他构造参数以签名为准。
| 字段 | 声明 | 源码初值 | 说明 |
| --- | --- | --- | --- |
| [backgroundImageLoadOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#afee878f0541f31202bbd14cbe226b5b4) | `com.herewhite.sdk.domain.BackgroundImageLoadOptions backgroundImageLoadOptions` | 未显式赋值 | [api-center-table-0 details](#table-slot-api-center-table-0) |
| [region](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a667353b38a2bfc14147c24a9e784844c) | `Region region` | 未显式赋值 | [api-center-table-1 details](#table-slot-api-center-table-1) |
| [log](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a36de6bdaa33c1342da8248192bafd8a0) | `boolean log` | false | [api-center-table-2 details](#table-slot-api-center-table-2) |
| [renderEngine](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a680694b7d7575da69f18bd6cd1a1cf22) | `RenderEngineType renderEngine` | RenderEngineType.canvas | [api-center-table-3 details](#table-slot-api-center-table-3) |
| [enableInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a77a4548d1d4a62274c25a3d8e3b4efd7) | `boolean enableInterrupterAPI` | false | [api-center-table-4 details](#table-slot-api-center-table-4) |
| [enableSlideInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a3de3fcd861845a9ad986775f4bc6265e) | `boolean enableSlideInterrupterAPI` | false | [api-center-table-5 details](#table-slot-api-center-table-5) |
| [preloadDynamicPPT](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa8a862e26387a87f72013f54be49467b) | `boolean preloadDynamicPPT` | false | [api-center-table-6 details](#table-slot-api-center-table-6) |
| [userCursor](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a5bfdee2e39b447a0ca57471d9d6f46ec) | `boolean userCursor` | false | [api-center-table-7 details](#table-slot-api-center-table-7) |
| [onlyCallbackRemoteStateModify](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a5924ea6899dab6caede613112ac70bed) | `boolean onlyCallbackRemoteStateModify` | false | [api-center-table-8 details](#table-slot-api-center-table-8) |
| [enableIFramePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a6c93c8c7a6b9f233867b3b9e6e68980a) | `boolean enableIFramePlugin` | false | [api-center-table-9 details](#table-slot-api-center-table-9) |
| [enableRtcAudioEffectIntercept](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a11982650384a33d9a5604bbc58bfea76) | `boolean enableRtcAudioEffectIntercept` | false | [api-center-table-10 details](#table-slot-api-center-table-10) |
| [enableSyncedStore](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a77793d360e752054520bde56297915c6) | `boolean enableSyncedStore` | false | [api-center-table-11 details](#table-slot-api-center-table-11) |
| [enableAppliancePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a7f10a09bafaf53a2798abed4b5113256) | `boolean enableAppliancePlugin` | false | [api-center-table-12 details](#table-slot-api-center-table-12) |
| [disableNewPencilStroke](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a3012d639a5a85703e10b4d8256a33d0b) | `boolean disableNewPencilStroke` | false | [api-center-table-13 details](#table-slot-api-center-table-13) |
| [loggerOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa0e11a5de4d3690939bc27c3acf426dc) | `LoggerOptions loggerOptions` | 未显式赋值 | [api-center-table-14 details](#table-slot-api-center-table-14) |
| [pptParams](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ab230d2bbd28af5f9dac17aaeec1b1e7f) | `PptParams pptParams` | new PptParams(...) | [api-center-table-15 details](#table-slot-api-center-table-15) |
| [slideAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a79647087cc200679ed0cdbe20346cff8) | `SlideAppOptions slideAppOptions` | new SlideAppOptions(...) | [api-center-table-16 details](#table-slot-api-center-table-16) |
| [presentationAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aead886fe6012608f90cc7b272eebccd2) | `PresentationAppOptions presentationAppOptions` | 未显式赋值 | [api-center-table-17 details](#table-slot-api-center-table-17) |
| [fonts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#abddd71b82802051a76375cdaa88aed21) | `HashMap fonts` | 未显式赋值 | [api-center-table-18 details](#table-slot-api-center-table-18) |
| [enableImgErrorCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a17ca63184cb30738946bae208116aafb) | `boolean enableImgErrorCallback` | 未显式赋值 | [api-center-table-19 details](#table-slot-api-center-table-19) |
| [useMultiViews](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ab7e3f18c4f865c73e07105e2c7424fd0) | `Boolean useMultiViews` | false | [api-center-table-20 details](#table-slot-api-center-table-20) |
| [apiHosts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a82b82ea774ef5b1a1166463585265e67) | `List apiHosts` | 未显式赋值 | [api-center-table-21 details](#table-slot-api-center-table-21) |
**api-center-table-0 details**
背景图片加载重试和超时配置,见 BackgroundImageLoadOptions。
**api-center-table-1 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-2 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-3 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-4 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-5 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-6 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-7 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-8 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-9 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-10 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-11 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-12 details**
启用内嵌高性能绘制插件,默认 false;Android/Harmony 无需单独安装 npm 插件,同房间各端应一致开启。
**api-center-table-13 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-14 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-15 details**
pptParams 动态 ppt 专用参数
**api-center-table-16 details**
SlideApp 的配置项
**api-center-table-17 details**
本地内置 Presentation 配置,初始化 SDK 前传入。
**api-center-table-18 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-19 details**
模型属性;通过对应 getter/setter 访问。
**api-center-table-20 details**
多窗口支持
**api-center-table-21 details**
配置白板的 API 服务器域名列表,可以用于服务器代理。配置后,白板不再使用 sdk 自带配置。
@example [api.example.com]
| 公开成员签名 | |
| --- | --- |
| | [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a1bdc84ab8acbe9f4732f07a62f429a3d) (String appIdentifier, boolean log) |
| | [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#adefcf4cfce48f523164941ca1e2859a5) (String appIdentifier) |
| boolean | [isEnableIFramePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a3d6c7edc68f7143f7b045c89e5ce2d26) () |
| void | [setEnableIFramePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a5983a2cd7a0fa6e51ce8ff7a78ef7c02) (boolean enableIFramePlugin) |
| Region | [getRegion](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a8acd28da7ca8b16197e36b46f51fd2ea) () |
| void | [setRegion](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a26095c960c0c25f4e5d07ac7dcea3b9d) (Region region) |
| boolean | [isEnableRtcAudioEffectIntercept](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a0832d96d6dcd2fb6736f8cab85d0a4ee) () |
| void | [setEnableRtcAudioEffectIntercept](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ac1ccb3a7cccdb4960b48b9f173e7b37b) (boolean enableRtcAudioEffectIntercept) |
| boolean | [isDisableNewPencilStroke](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aea5543307dfdda534d09dc3fa609bbc8) () |
| void | [setDisableNewPencilStroke](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a9145cf669a6de058fa0fd53dc1f2ff8b) (boolean disableNewPencilStroke) |
| RenderEngineType | [getRenderEngine](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a8f4ae303b78245fa3820ada74c1cecd3) () |
| void | [setRenderEngine](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ae74760b5bbf80d908566a35d0146252b) (RenderEngineType renderEngine) |
| PptParams | [getPptParams](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a0cf413fba8c882bd85d3525f39868494) () |
| void | [setPptParams](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a18fb497bc4386158c0e20f7f7f778780) (PptParams pptParams) |
| HashMap<String, String> | [getFonts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a56a503cb128959dda43df21d3274e467) () |
| void | [setFonts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ae27b638d67a38871ebb59dc800fc6411) (HashMap<String, String> fonts) |
| boolean | [isPreloadDynamicPPT](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a0e0f16c7abeef7ce60ae8c8537688999) () |
| void | [setPreloadDynamicPPT](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a7a06793aeeade42d1e539765b27f2642) (boolean preloadDynamicPPT) |
| void | [addNativeTag](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a23220ca8298da2d2f321dc2fd59cb9e3) (String tag, String value) |
| LoggerOptions | [getLoggerOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ad9538a651c2d1a5a59592d9642d7ab06) () |
| void | [setLoggerOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a54bb35b0fecf880950fa8cb8e6026098) (LoggerOptions loggerOptions) |
| List<String> | [getNetlessUA](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a0bb1c190bfb05a93ded803e0e7323dc9) () |
| void | [setNetlessUA](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ab6f5ff9718db061a7bd76a075552c1e9) (List<String> netlessUA) |
| boolean | [isUserCursor](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#af1dc5d8e78cec31cdc7d70e6431a9fca) () |
| void | [setUserCursor](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a58d1cff22044c385de34a7e239b34ca4) (boolean userCursor) |
| boolean | [isOnlyCallbackRemoteStateModify](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ac3ec01e31aa709a3a62b40528c3045a8) () |
| void | [setOnlyCallbackRemoteStateModify](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a86641862170f62dbaed5e9b2548fc296) (boolean onlyCallbackRemoteStateModify) |
| boolean | [isLog](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a35e6de1283b312c6c8720bdc0b18b2d8) () |
| void | [setLog](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#af29676180672f3e54d050d591707312c) (boolean log) |
| boolean | [isEnableInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a04a8a5e4f6e942e1fadd061cb6cd27f8) () |
| void | [setEnableInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa2e118f6e449997fbd487a5d5357745b) (boolean enableInterrupterAPI) |
| boolean | [isEnableImgErrorCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a1b0ac65018c580328b68c52af6793f35) () |
| void | [setEnableImgErrorCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ac84ef5bcce300c954e05eace8b18c36b) (boolean enableImgErrorCallback) |
| com.herewhite.sdk.domain.BackgroundImageLoadOptions | [getBackgroundImageLoadOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a7cefc9a048561233206e9de78218a1f5) () |
| void | [setBackgroundImageLoadOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a30016236b68a3bd9dd244eb0ebc8e8c5) (com.herewhite.sdk.domain.BackgroundImageLoadOptions options) |
| boolean | [isEnableSyncedStore](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aca115dec8e4845b14adc728806e9fe31) () |
| void | [setEnableSyncedStore](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa568ec1caabbb457d3ed342242bcda7a) (boolean enableSyncedStore) |
| Boolean | [getUseMultiViews](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ad9a248a0071ab6d53050fa42cd92268b) () |
| void | [setUseMultiViews](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#afc8be74170b3377d3fe830d6b8e93466) (Boolean useMultiViews) |
| SlideAppOptions | [getSlideAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a3484b5774a99a0aac4f048e1d1cad393) () |
| void | [setSlideAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a8c91c61059e628d467aee6c2f54a66a4) (SlideAppOptions slideAppOptions) |
| PresentationAppOptions | [getPresentationAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a34234ac94fbea20a3966d2da3743269d) () |
| void | [setPresentationAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#acb9eedc3b38c315ddc452565852c5668) (PresentationAppOptions presentationAppOptions) |
| boolean | [isEnableSlideInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a10342ae9c7b48b3c5a9634461ecaa8c4) () |
| void | [setEnableSlideInterrupterAPI](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa056117366231f9c6a94e4c3c8e69ebe) (boolean enableSlideInterrupterAPI) |
| List<String> | [getApiHosts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aede0a2d191b0dfc5c54c8ea5364392c5) () |
| void | [setApiHosts](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#ac600c7ef3c6ac6c6973230d9d201a32b) (List<String> apiHosts) |
| boolean | [isEnableAppliancePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a38ec00b67242c2df696027e7f7b856fa) () |
| void | [setEnableAppliancePlugin](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a826074833f28c8b49a8c475eb1a162d5) (boolean enableAppliancePlugin) |
| [setDynamicConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a46b649f96b291b8d415d613b549d9120) | `public void setDynamicConfig(Map dynamicConfig)` |
| [getDynamicConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#a0b3c09124190d94c2d2140f7324fbaa1) | `public Map getDynamicConfig()` |
## 变量说明 [#变量说明]
### backgroundImageLoadOptions [#backgroundimageloadoptions]
```text
com.herewhite.sdk.domain.BackgroundImageLoadOptions backgroundImageLoadOptions
```
源码初值:未显式赋值
背景图片加载重试和超时配置,见 BackgroundImageLoadOptions。
### region [#region]
```text
Region region
```
源码初值:未显式赋值
模型属性;通过对应 getter/setter 访问。
### log [#log]
```text
boolean log
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### renderEngine [#renderengine]
```text
RenderEngineType renderEngine
```
源码初值:RenderEngineType.canvas
模型属性;通过对应 getter/setter 访问。
### enableInterrupterAPI [#enableinterrupterapi]
```text
boolean enableInterrupterAPI
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### enableSlideInterrupterAPI [#enableslideinterrupterapi]
```text
boolean enableSlideInterrupterAPI
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### preloadDynamicPPT [#preloaddynamicppt]
```text
boolean preloadDynamicPPT
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### userCursor [#usercursor]
```text
boolean userCursor
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### onlyCallbackRemoteStateModify [#onlycallbackremotestatemodify]
```text
boolean onlyCallbackRemoteStateModify
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### enableIFramePlugin [#enableiframeplugin]
```text
boolean enableIFramePlugin
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### enableRtcAudioEffectIntercept [#enablertcaudioeffectintercept]
```text
boolean enableRtcAudioEffectIntercept
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### enableSyncedStore [#enablesyncedstore]
```text
boolean enableSyncedStore
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### enableAppliancePlugin [#enableapplianceplugin]
```text
boolean enableAppliancePlugin
```
源码初值:false
启用内嵌高性能绘制插件,默认 false;Android/Harmony 无需单独安装 npm 插件,同房间各端应一致开启。
### disableNewPencilStroke [#disablenewpencilstroke]
```text
boolean disableNewPencilStroke
```
源码初值:false
模型属性;通过对应 getter/setter 访问。
### loggerOptions [#loggeroptions]
```text
LoggerOptions loggerOptions
```
源码初值:未显式赋值
模型属性;通过对应 getter/setter 访问。
### pptParams [#pptparams]
```text
PptParams pptParams
```
源码初值:new PptParams(...)
pptParams 动态 ppt 专用参数
### slideAppOptions [#slideappoptions]
```text
SlideAppOptions slideAppOptions
```
源码初值:new SlideAppOptions(...)
SlideApp 的配置项
### presentationAppOptions [#presentationappoptions]
```text
PresentationAppOptions presentationAppOptions
```
源码初值:未显式赋值
本地内置 Presentation 配置,初始化 SDK 前传入。
### fonts [#fonts]
```text
HashMap fonts
```
源码初值:未显式赋值
模型属性;通过对应 getter/setter 访问。
### enableImgErrorCallback [#enableimgerrorcallback]
```text
boolean enableImgErrorCallback
```
源码初值:未显式赋值
模型属性;通过对应 getter/setter 访问。
### useMultiViews [#usemultiviews]
```text
Boolean useMultiViews
```
源码初值:false
多窗口支持
### apiHosts [#apihosts]
```text
List apiHosts
```
源码初值:未显式赋值
配置白板的 API 服务器域名列表,可以用于服务器代理。配置后,白板不再使用 sdk 自带配置。
@example [api.example.com]
## 函数说明 [#函数说明]
### WhiteSdkConfiguration() [#whitesdkconfiguration]
WhiteSdkConfiguration(String appIdentifier, boolean log)
初始化互动白板 SDK 配置。
白板项目的唯一标识。详见[获取白板项目的 App Identifier](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/setup-and-access/enable-service)。
是否开启调试日志回调:
- `true`:开启。
- `false`:(默认)关闭。 调试日志仅包含调用初始化互动白板 SDK、加入房间和开始回放等方法的回调。
### WhiteSdkConfiguration() [#whitesdkconfiguration-1]
WhiteSdkConfiguration(String appIdentifier)
初始化互动白板 SDK 配置。
白板项目的唯一标识。详见[获取白板项目的 App Identifier](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/setup-and-access/enable-service)。
### isEnableIFramePlugin() [#isenableiframeplugin]
boolean isEnableIFramePlugin()
获取是否启用 iframe 插件。
返回值
是否启用 iframe 插件:
- `true`:开启。
- `false`:未启用。
### setEnableIFramePlugin() [#setenableiframeplugin]
void setEnableIFramePlugin(boolean enableIFramePlugin)
启用/禁用 iframe 插件。
iframe 插件的功能,详见 [iframe-bridge](https://github.com/netless-io/netless-iframe-bridge)。
是否启用 iframe 插件:
- `true`:开启。
- `false`:(默认)不启用。
### getRegion() [#getregion]
Region getRegion()
获取设置的数据中心。
返回值
数据中心,详见 [`Region`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-region)。
### setRegion() [#setregion]
void setRegion(Region region)
设置数据中心。
:::info[注解]
该方法设置的数据中心必须与要加入的互动白板实时房间所在数据中心一致;否则,SDK 将无法连接到房间 。
:::
数据中心,详见 [`Region`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-region)。
### isEnableRtcAudioEffectIntercept() [#isenablertcaudioeffectintercept]
boolean isEnableRtcAudioEffectIntercept()
isEnableRtcAudioEffectIntercept:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setEnableRtcAudioEffectIntercept() [#setenablertcaudioeffectintercept]
void setEnableRtcAudioEffectIntercept(boolean enableRtcAudioEffectIntercept)
设置是否启用 RTC SDK 的音效方法播放动态 PPT 中的音频。
#### 参数 [#参数]
:::info[自此版本]
2.16.75 当同时使用 Agora RTC SDK 和互动白板 SDK, 且互动白板中展示的动态 PPT 中包含音频文件时,你可以调用 RTC SDK 的音效方法播放动态 PPT 中的音频,以保证音频正常播放。
:::
:::info[注意]
初始化 `WhiteSdk` 时,如果你实现并传入 AudioEffectBridge 类,SDK 会自动设置 `setEnableRtcAudioEffectIntercept(true)`。你无需主动调用该方法。
:::
### isDisableNewPencilStroke() [#isdisablenewpencilstroke]
boolean isDisableNewPencilStroke()
获取新铅笔工具的笔锋效果是否关闭。
返回值
新铅笔工具的笔锋效果是否关闭:
- `true`:关闭笔锋效果。
- `false`:开启笔锋效果。
### setDisableNewPencilStroke() [#setdisablenewpencilstroke]
void setDisableNewPencilStroke(boolean disableNewPencilStroke)
开启/关闭新铅笔工具的笔锋效果。
:::info[注解]
该方法仅在调用 [`setDisableNewPencil(false)`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-room-params#a49c41b2dfd21f764d6e3ff63ca09f19d) 后生效。
:::
是否关闭新铅笔工具的笔锋效果:
- `true`:关闭笔锋效果。
- `false`:(默认)开启笔锋效果。
### getRenderEngine() [#getrenderengine]
RenderEngineType getRenderEngine()
获取绘图的渲染模式。
返回值
绘图的渲染模式,详见 [`RenderEngineType`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration-1-1-render-engine-type)。
### setRenderEngine() [#setrenderengine]
void setRenderEngine(RenderEngineType renderEngine)
设置绘图的渲染模式。
:::info[自从]
2.8.0
:::
为优化白板上绘图的渲染,自 2.8.0 版本起,白板 SDK 新增 `canvas` 渲染模式,并从 2.9.0 版本起,将 `canvas` 渲染模式作为默认的渲染模式。
:::info[注解]
由于部分 Android 6.1 至 Android 8.1 设备无法支持 `canvas` 渲染模式,SDK 会自动将默认的渲染模式切换为 `svg` 渲染模式。
:::
绘图的渲染模式,详见 [`RenderEngineType`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration-1-1-render-engine-type)。
### getPptParams() [#getpptparams]
PptParams getPptParams()
获取设置的动态 PPT 参数。
返回值
设置的动态 PPT 参数,详见 [`PptParams`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration-1-1-ppt-params)。
### setPptParams() [#setpptparams]
void setPptParams(PptParams pptParams)
设置动态 PPT 参数。
动态 PPT 参数,详见 [`PptParams`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration-1-1-ppt-params)。
### getFonts() [#getfonts]
HashMap<String, String> getFonts()
获取自定义字体。
返回值
自定义字体名称和地址。
### setFonts() [#setfonts]
void setFonts(HashMap<String, String> fonts)
设置自定义字体。
:::info[自从]
2.2.0
:::
为正常显示动态 PPT 中的非常规字体,在初始化 [`WhiteSdk`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk) 实例时,你可以调用该方法传入该字体文件的 URL 地址。
:::info[注解]
调用该方法前,你需要将字体文件上传至你的 app 服务器或第三方云存储,并生成一个 URL 地址。
:::
自定义字体,为 `key-value` 键值对,`key` 为字体名称,`value` 为字体的 URL 地址,例如 `"Calibri", "https://your-cdn.com/Calibri.ttf"`。
### isPreloadDynamicPPT() [#ispreloaddynamicppt]
boolean isPreloadDynamicPPT()
获取是否开启一次性加载动态 PPT 中的所有图片资源。
返回值
一次性加载动态 PPT 中的所有图片资源开启状态:
- `true`:开启。
- `false`: 未开启。
### setPreloadDynamicPPT() [#setpreloaddynamicppt]
void setPreloadDynamicPPT(boolean preloadDynamicPPT)
设置是否在加载动态 PPT 首页时,一次性加载动态 PPT 中的所有图片资源。
:::info[注解]
Agora 不推荐设置 `setPreloadDynamicPPT(true)`,这样会使 PPT 显示缓慢。
:::
是否在加载动态 PPT 首页时,一次性加载动态 PPT 中的所有图片资源:
- `true`:一次性加载所有动态 PPT。
- `false`: (默认)不一次性加载所有动态 PPT。
### addNativeTag() [#addnativetag]
void addNativeTag(String tag, String value)
addNativeTag:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### getLoggerOptions() [#getloggeroptions]
LoggerOptions getLoggerOptions()
获取设置的日志选项。
返回值
设置的日志选项,详见 [`LoggerOptions`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-logger-options)。
### setLoggerOptions() [#setloggeroptions]
void setLoggerOptions(LoggerOptions loggerOptions)
设置日志选项。
:::info[自从]
2.4.2
:::
日志选择,详见 [`LoggerOptions`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-logger-options)。
### getNetlessUA() [#getnetlessua]
List<String> getNetlessUA()
getNetlessUA:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setNetlessUA() [#setnetlessua]
void setNetlessUA(List<String> netlessUA)
setNetlessUA:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### isUserCursor() [#isusercursor]
boolean isUserCursor()
获取是否显示用户头像。
返回值
是否显示用户头像:
- `true`:显示。
- `false`:不显示。
### setUserCursor() [#setusercursor]
void setUserCursor(boolean userCursor)
设置是否显示用户头像。
要显示用户头像,请确保你在 `userPayload` 对象中传入了头像的键值对, 并在调用 [`setUserPayload`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-room-params#a17c8130727ea71cdeca6c3c2362cc0b7)。
是否显示用户头像:
- `true`:显示。
- `false`:(默认)不显示。
### isOnlyCallbackRemoteStateModify() [#isonlycallbackremotestatemodify]
boolean isOnlyCallbackRemoteStateModify()
获取是否开启仅接收远端用户状态改变的回调。
返回值
是否开启仅接收远端用户状态改变回调:
- `true`:开启。开启该功能后,本地用户仅会接收到远端用户状态改变的回调,自身状态的改变不会触发回调。
- `false`:关闭。关闭该功能后,本地用户会接收到远端用户状态改变的回调,也会接收到自身状态改变的回调。
### setOnlyCallbackRemoteStateModify() [#setonlycallbackremotestatemodify]
void setOnlyCallbackRemoteStateModify(boolean onlyCallbackRemoteStateModify)
开启/关闭仅接收远端用户状态改变的回调。
开启该功能后,本地用户仅会接收到远端用户状态改变的回调,自身状态的改变不会触发回调;关闭该功能后,本地用户会接收到远端用户状态改变的回调,也会接收到自身状态改变的回调。
是否开启仅接收远端用户状态改变回调:
- `true`:开启。
- `false`:(默认)关闭。
### isLog() [#islog]
boolean isLog()
获取是否开启调试日志打印。
返回值
是否开启调试日志打印:
- `true`:开启。
- `false`:关闭。
### setLog() [#setlog]
void setLog(boolean log)
开启/关闭调试日志打印。
调试日志仅包含调用初始化互动白板 SDK、加入房间和开始回放等方法的回调。
是否开启调试日志打印:
- `true`:开启。
- `false`:(默认)关闭。
### isEnableInterrupterAPI() [#isenableinterrupterapi]
boolean isEnableInterrupterAPI()
获取是否开启图片拦截和替换功能。
返回值
是否开启图片拦截和替换功能:
- `true`:开启。
- `false`:关闭。
### setEnableInterrupterAPI() [#setenableinterrupterapi]
void setEnableInterrupterAPI(boolean enableInterrupterAPI)
开启/关闭图片拦截替换功能。
该方法可以开启或关闭图片拦截功能。 如果开启,在图片实际插入白板前,SDK 会拦截图片并触发 [`urlInterrupter`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a28839222c6e4b44a001da833300991d4) 回调,你可以在该回调中替换图片的地址。
:::info[注解]
Agora 建议不要开启图片拦截功能,否则会频繁触发回调。
:::
是否开启图片拦截和替换功能:
- `true`:开启。
- `false`:(默认)关闭。
### isEnableImgErrorCallback() [#isenableimgerrorcallback]
boolean isEnableImgErrorCallback()
获取是否开启对图片加载失败事件的监听。
返回值
是否监听图片加载失败事件:
- `true`:开启监听。
- `false`:关闭监听。
### setEnableImgErrorCallback() [#setenableimgerrorcallback]
void setEnableImgErrorCallback(boolean enableImgErrorCallback)
开启/关闭对图片加载失败事件的监听。
是否开启对图片加载失败事件的监听:
- `true`:开启。开启后,所有 `img` 标签加载事件都会在 [`onMessage`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a2a843f00164c64d248143d2194beecae) 中回调。
- `false`:(默认)关闭。
### getBackgroundImageLoadOptions() [#getbackgroundimageloadoptions]
com.herewhite.sdk.domain.BackgroundImageLoadOptions getBackgroundImageLoadOptions()
背景图片加载重试和超时配置,见 BackgroundImageLoadOptions。
### setBackgroundImageLoadOptions() [#setbackgroundimageloadoptions]
void setBackgroundImageLoadOptions(com.herewhite.sdk.domain.BackgroundImageLoadOptions options)
背景图片加载重试和超时配置,见 BackgroundImageLoadOptions。
### isEnableSyncedStore() [#isenablesyncedstore]
boolean isEnableSyncedStore()
isEnableSyncedStore:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setEnableSyncedStore() [#setenablesyncedstore]
void setEnableSyncedStore(boolean enableSyncedStore)
setEnableSyncedStore:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### getUseMultiViews() [#getusemultiviews]
Boolean getUseMultiViews()
getUseMultiViews:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setUseMultiViews() [#setusemultiviews]
void setUseMultiViews(Boolean useMultiViews)
setUseMultiViews:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### getSlideAppOptions() [#getslideappoptions]
SlideAppOptions getSlideAppOptions()
getSlideAppOptions:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setSlideAppOptions() [#setslideappoptions]
void setSlideAppOptions(SlideAppOptions slideAppOptions)
setSlideAppOptions:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### getPresentationAppOptions() [#getpresentationappoptions]
PresentationAppOptions getPresentationAppOptions()
本地内置 Presentation 配置,初始化 SDK 前传入。
### setPresentationAppOptions() [#setpresentationappoptions]
void setPresentationAppOptions(PresentationAppOptions presentationAppOptions)
本地内置 Presentation 配置,初始化 SDK 前传入。
### isEnableSlideInterrupterAPI() [#isenableslideinterrupterapi]
boolean isEnableSlideInterrupterAPI()
isEnableSlideInterrupterAPI:com.herewhite.sdk.WhiteSdkConfiguration 的公开成员。参数和返回类型见下方签名。
### setEnableSlideInterrupterAPI() [#setenableslideinterrupterapi]
void setEnableSlideInterrupterAPI(boolean enableSlideInterrupterAPI)
开启/关闭 PPT 拦截替换功能。
该方法可以开启或关闭 PPT 资源的拦截功能。 如果开启,在加载 URL 资源时会拦截资源并触发 `com.herewhite.sdk.window.SlideListener#slideUrlInterrupter(String, ResultCaller)` 回调,你可以在该回调中替换资源的地址。
是否开启 PPT 资源拦截和替换功能:
- `true`:开启。
- `false`:(默认)关闭。
### getApiHosts() [#getapihosts]
List<String> getApiHosts()
获取白板的 API 服务器域名列表。
### setApiHosts() [#setapihosts]
void setApiHosts(List<String> apiHosts)
配置白板的 API 服务器域名列表。 可以用于配置服务器代理。配置后,白板不再使用 SDK 自带配置。
白板的 API 服务器域名列表。例如 [api.example.com]。
### isEnableAppliancePlugin() [#isenableapplianceplugin]
boolean isEnableAppliancePlugin()
获取是否启用高性能白板绘制工具插件 (appliance-plugin)。
返回值
是否启用 appliance-plugin:
- `true`:开启。
- `false`:(默认)关闭。
### setEnableAppliancePlugin() [#setenableapplianceplugin]
void setEnableAppliancePlugin(boolean enableAppliancePlugin)
启用/禁用高性能白板绘制工具插件 (appliance-plugin)。
是否启用 appliance-plugin:
- `true`:开启。
- `false`:(默认)关闭。
## 公开成员函数 [#公开成员函数]
### setDynamicConfig [#setdynamicconfig]
```text
public void setDynamicConfig(Map dynamicConfig)
```
设置 region 到平台配置 HTTPS URL 的映射。创建 SDK 前设置;每次入房前按实际 region 加载,默认超时 5 秒,读取失败使用本地参数。本地显式参数优先。
## 公开成员函数 [#公开成员函数-1]
### getDynamicConfig [#getdynamicconfig]
```text
public Map getDynamicConfig()
```
返回本地配置地址映射,不是远端配置 JSON 或解析后的生效参数。