# BackgroundImageLoadOptions interface 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/interface-background-image-load-options)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
适用版本:**@shengwang/whiteboard 0.2.11**。
WhiteboardOptions.backgroundImageLoadOptions 的加载重试和超时配置。
可从 @shengwang/whiteboard 直接导入 BackgroundImageLoadOptions。仅用于类型声明,不能作为构造函数调用 new。
## 类型结构(源码声明) [#类型结构源码声明]
下方源码文件的 export 声明不等同于 SDK 包入口导出;业务导入方式以上方说明为准。
```text
export interface BackgroundImageLoadOptions
```
| [maxRetries](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/interface-background-image-load-options#add13438cf76753815480b3c747bf1d45) | `maxRetries?: number` |
| --- | --- |
| [timeoutMs](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/interface-background-image-load-options#a6a65e183f864ad6582555a4ce790face) | `timeoutMs?: number` |
| [retryIntervalMs](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/interface-background-image-load-options#a63578ce1f40db667ba209d2a9e443cdd) | `retryIntervalMs?: number` |
## 变量说明 [#变量说明]
### maxRetries [#maxretries]
```text
maxRetries?: number
```
背景图片重试次数:-1 表示无限重试,或整数 0~10;默认 3。
### timeoutMs [#timeoutms]
```text
timeoutMs?: number
```
背景图片单次加载超时,1000~120000 毫秒;默认 15000。
### retryIntervalMs [#retryintervalms]
```text
retryIntervalMs?: number
```
背景图片重试间隔,0~30000 毫秒;默认 1000。