# WhiteSDK Class Reference (/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
Whiteboard iOS SDK 2.16.147 公开接口。
@interface WhiteSDK (Replayer)
## 成员 [#成员]
- [createReplayerWithConfig\:callbacks\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/createReplayerWithConfig:callbacks:completionHandler:)
- [isPlayable\:result:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/isPlayable:result:)
- [joinRoomWithConfig\:callbacks\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/joinRoomWithConfig:callbacks:completionHandler:)
- [version](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/version)
- [initWithWhiteBoardView\:config\:commonCallbackDelegate\:effectMixerBridgeDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/initWithWhiteBoardView:config:commonCallbackDelegate:effectMixerBridgeDelegate:)
- [initWithWhiteBoardView\:config\:commonCallbackDelegate\:pcmDataDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/initWithWhiteBoardView:config:commonCallbackDelegate:pcmDataDelegate:)
- [initWithWhiteBoardView\:config\:commonCallbackDelegate\:audioMixerBridgeDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/initWithWhiteBoardView:config:commonCallbackDelegate:audioMixerBridgeDelegate:)
- [initWithWhiteBoardView\:config\:commonCallbackDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/initWithWhiteBoardView:config:commonCallbackDelegate:)
- [initWithWhiteBoardView\:config:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/initWithWhiteBoardView:config:)
- [prepareWhiteConnectionForAppId\:region\:expireSeconds\:attachingSuperView:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/prepareWhiteConnectionForAppId:region:expireSeconds:attachingSuperView:)
- [effectMixer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/effectMixer)
- [setupFontFaces:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/setupFontFaces:)
- [loadFontFaces\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/loadFontFaces:completionHandler:)
- [updateTextFont:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/updateTextFont:)
- [getSlideVolumeWithCompletionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/getSlideVolumeWithCompletionHandler:)
- [updateSlideVolume:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/updateSlideVolume:)
- [recoverSlide\:slideIndex:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/recoverSlide:slideIndex:)
- [recoverSlide:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/recoverSlide:)
- [setCommonCallbackDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/setCommonCallbackDelegate:)
- [setSlideDelegate:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/setSlideDelegate:)
- [registerAppWithParams\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/registerAppWithParams:completionHandler:)
- [requestSlideLogToFilePath\:result:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/requestSlideLogToFilePath:result:)
- [getLocalLogStateWithCompletionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/getLocalLogStateWithCompletionHandler:)
- [collectLocalLogsWithCompletionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/collectLocalLogsWithCompletionHandler:)
- [flushLocalLogsWithCompletionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/flushLocalLogsWithCompletionHandler:)
- [uploadLocalLogsWithCompletionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/uploadLocalLogsWithCompletionHandler:)
- [reloadBackgroundImage\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/reloadBackgroundImage:completionHandler:)
- [hasBackgroundImage\:completionHandler:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/hasBackgroundImage:completionHandler:)
- [setParameters:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk#//api/name/setParameters:)
### `– createReplayerWithConfig:callbacks:completionHandler:` [#-createreplayerwithconfigcallbackscompletionhandler]
\- (void)createReplayerWithConfig:(WhitePlayerConfig *)config callbacks:(nullable id<WhitePlayerEventDelegate>)eventCallbacks completionHandler:(void (^) (BOOL success, WhitePlayer * _Nullable player, NSError * _Nullable error))completionHandler;
创建互动白板回放房间。
Declared in Replayer/WhiteSDK+Replayer.h
#### 参数 [#参数]
| `config` | 白板回放的参数配置,详见 [WhitePlayerConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player-config)。 |
| --- | --- |
| `eventCallbacks` | [api-center-table-0 details](#table-slot-api-center-table-0) |
| `completionHandler` | [api-center-table-1 details](#table-slot-api-center-table-1) |
**api-center-table-0 details**
白板回放事件的回调。详见 [WhitePlayerEventDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-player-event-delegate)。
**api-center-table-1 details**
你可以通过该接口获取 `createReplayerWithConfig` 的调用结果:
- 如果方法调用成功,将返回新创建的回放房间对象,详见 [WhitePlayer](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-player)。
- 如果方法调用失败,将返回错误信息。
### `– isPlayable:result:` [#-isplayableresult]
\- (void)isPlayable:(WhitePlayerConfig *)config result:(void (^)(BOOL isPlayable))result;
主动查询给定回放配置对应的房间是否能够回放。调用不会创建播放器或启动回放。
Declared in Replayer/WhiteSDK+Replayer.h
#### 参数 [#参数-1]
| `config` | WhitePlayerConfig 回放配置。 |
| --- | --- |
| `result` | [api-center-table-2 details](#table-slot-api-center-table-2) |
**api-center-table-2 details**
查询完成回调,BOOL isPlayable:YES 表示可回放,NO 表示不可回放。此方法自身返回 void。
### `– joinRoomWithConfig:callbacks:completionHandler:` [#-joinroomwithconfigcallbackscompletionhandler]
\- (void)joinRoomWithConfig:(WhiteRoomConfig *)config callbacks:(nullable id<WhiteRoomCallbackDelegate>)callbacks completionHandler:(void (^) (BOOL success, WhiteRoom * _Nullable room, NSError * _Nullable error))completionHandler;
设置房间参数和事件回调并加入互动白板实时房间。
Declared in Room/WhiteSDK+Room.h
#### 参数 [#参数-2]
| `config` | 互动白板实时房间的参数配置,详见 [WhiteRoomConfig](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-room-config)。 |
| --- | --- |
| `callbacks` | [api-center-table-3 details](#table-slot-api-center-table-3) |
| `completionHandler` | [api-center-table-4 details](#table-slot-api-center-table-4) |
**api-center-table-3 details**
房间事件回调,详见 [WhiteRoomCallbackDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-room-callback-delegate)。
**api-center-table-4 details**
调用结果:
- 如果方法调用成功,将返回房间对象,详见 [WhiteRoom](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-room)。
- 如果方法调用失败,将返回错误信息,详见 NSError。
### `+ version` [#-version]
\+ (NSString *)version;
```text
白板 SDK 版本号。
```
Declared in SDK/WhiteSDK.h
### `– initWithWhiteBoardView:config:commonCallbackDelegate:effectMixerBridgeDelegate:` [#-initwithwhiteboardviewconfigcommoncallbackdelegateeffectmixerbridgedelegate]
\- (instancetype)initWithWhiteBoardView:(WhiteBoardView *)boardView config:(WhiteSdkConfiguration *)config commonCallbackDelegate:(nullable id<WhiteCommonCallbackDelegate>)callback effectMixerBridgeDelegate:(nullable id<WhiteAudioEffectMixerBridgeDelegate>)effectMixer;
设置 RTC 混音并初始化 `WhiteSDK` 对象。
请确保在调用其他 API 前先调用该方法创建并初始化白板 SDK 对象。
Declared in SDK/WhiteSDK.h
#### 返回 [#返回]
初始化的 `WhiteSDK` 对象。
#### 参数 [#参数-3]
| `boardView` | 白板界面,详见 [WhiteBoardView](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-board-view)。 |
| --- | --- |
| `config` | [api-center-table-5 details](#table-slot-api-center-table-5) |
| `callback` | [api-center-table-6 details](#table-slot-api-center-table-6) |
| `effectMixer` | [api-center-table-7 details](#table-slot-api-center-table-7) |
**api-center-table-5 details**
白板 SDK 对象配置,详见 [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk-configuration)。
**api-center-table-6 details**
通用回调事件,详见 [WhiteCommonCallbackDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate)。
**api-center-table-7 details**
RTC 混音设置,详见 [WhiteAudioEffectMixerBridge](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-audio-effect-mixer-bridge)。当你同时使用 Agora RTC SDK 和互动白板 SDK, 且互动白板中展示的动态 PPT 中包含音频文件时,你可以调用 `WhiteAudioEffectMixerBridge` 接口,将动态 PPT 中的所有音频交给 Agora RTC SDK 进行混音播放。
### `– initWithWhiteBoardView:config:commonCallbackDelegate:pcmDataDelegate:` [#-initwithwhiteboardviewconfigcommoncallbackdelegatepcmdatadelegate]
\- (instancetype)initWithWhiteBoardView:(WhiteBoardView *)boardView config:(WhiteSdkConfiguration *)config commonCallbackDelegate:(nullable id<WhiteCommonCallbackDelegate>)callback pcmDataDelegate:(nullable id<WhiteAudioPcmDataDelegate>)pcmDataDelegate;
设置 RTC 混音并初始化 `WhiteSDK` 对象。
请确保在调用其他 API 前先调用该方法创建并初始化白板 SDK 对象。
Declared in SDK/WhiteSDK.h
#### 返回 [#返回-1]
初始化的 `WhiteSDK` 对象。
#### 参数 [#参数-4]
| `boardView` | 白板界面,详见 [WhiteBoardView](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-board-view)。 |
| --- | --- |
| `config` | [api-center-table-8 details](#table-slot-api-center-table-8) |
| `callback` | [api-center-table-9 details](#table-slot-api-center-table-9) |
| `pcmDataDelegate` | [api-center-table-10 details](#table-slot-api-center-table-10) |
**api-center-table-8 details**
白板 SDK 对象配置,详见 [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk-configuration)。
**api-center-table-9 details**
通用回调事件,详见 [WhiteCommonCallbackDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate)。
**api-center-table-10 details**
PCM 裸数据回调,详见 [WhiteAudioPcmDataDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-audio-pcm-data-delegate)。设置该对象之后,白板中的所有音频会以 pcm data 的形式传出。
### `– initWithWhiteBoardView:config:commonCallbackDelegate:audioMixerBridgeDelegate:` [#-initwithwhiteboardviewconfigcommoncallbackdelegateaudiomixerbridgedelegate]
\- (instancetype)initWithWhiteBoardView:(WhiteBoardView *)boardView config:(WhiteSdkConfiguration *)config commonCallbackDelegate:(nullable id<WhiteCommonCallbackDelegate>)callback audioMixerBridgeDelegate:(nullable id<WhiteAudioMixerBridgeDelegate>)mixer DEPRECATED_MSG_ATTRIBUTE("use initWithWhiteBoardView\:config: commonCallbackDelegate\:effectMixerBridgeDelegate: instead");
@deprecated 已废弃,请使用 initWithWhiteBoardView\:config: commonCallbackDelegate\:effectMixerBridgeDelegate:。
Declared in SDK/WhiteSDK.h
### `– initWithWhiteBoardView:config:commonCallbackDelegate:` [#-initwithwhiteboardviewconfigcommoncallbackdelegate]
\- (instancetype)initWithWhiteBoardView:(WhiteBoardView *)boardView config:(WhiteSdkConfiguration *)config commonCallbackDelegate:(nullable id<WhiteCommonCallbackDelegate>)callback;
初始化 `WhiteSDK` 对象。
请确保在调用其他 API 前先调用该方法创建并初始化白板 SDK 对象。
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-5]
| `boardView` | 白板界面,详见 [WhiteBoardView](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-board-view)。 |
| --- | --- |
| `config` | [api-center-table-11 details](#table-slot-api-center-table-11) |
| `callback` | [api-center-table-12 details](#table-slot-api-center-table-12) |
**api-center-table-11 details**
白板 SDK 对象配置,详见 [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk-configuration)。
**api-center-table-12 details**
通用回调事件,详见 [WhiteCommonCallbackDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate)。
### `– initWithWhiteBoardView:config:` [#-initwithwhiteboardviewconfig]
\- (instancetype)initWithWhiteBoardView:(WhiteBoardView *)boardView config:(WhiteSdkConfiguration *)config DEPRECATED_MSG_ATTRIBUTE("initWithWhiteBoardView\:config\:commonCallbackDelegate");
@deprecated 该方法已废弃。请使用 initWithWhiteBoardView\:config\:commonCallbackDelegate: 和 initWithWhiteBoardView\:config\:commonCallbackDelegate\:audioMixerBridgeDelegate: 方法。
Declared in SDK/WhiteSDK.h
### `+ prepareWhiteConnectionForAppId:region:expireSeconds:attachingSuperView:` [#-preparewhiteconnectionforappidregionexpiresecondsattachingsuperview]
\+ (void)prepareWhiteConnectionForAppId:(NSString *)appId region:(WhiteRegionKey)region expireSeconds:(NSNumber * _Nullable)expireSeconds attachingSuperView: (UIView * _Nullable)superView;
提前选择最佳接入域名,用于加快用户首次连接速度。
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-6]
| `appId` | SDK 的 appId |
| --- | --- |
| `region` | [api-center-table-13 details](#table-slot-api-center-table-13) |
| `expireSeconds` | [api-center-table-14 details](#table-slot-api-center-table-14) |
| `superView` | [api-center-table-15 details](#table-slot-api-center-table-15) |
**api-center-table-13 details**
需要选择的数据中心
**api-center-table-14 details**
数据缓存时间,单位为秒,可为空,默认为 24 小时
**api-center-table-15 details**
挂载的父视图,可为空,默认为 UIApplication.shared.keyWindow
### `effectMixer` [#effectmixer]
@property (nonatomic, strong, readonly, nullable) WhiteAudioEffectMixerBridge *effectMixer;
```text
Play effect 混音设置。
```
Declared in SDK/WhiteSDK.h
### `– setupFontFaces:` [#-setupfontfaces]
\- (void)setupFontFaces:(NSArray <WhiteFontFace *>*)fontFaces;
声明在本地白板中可用的字体。
Declared in SDK/WhiteSDK.h
#### 版本 [#版本]
2.11.3
调用该方法声明的字体可用于显示 PPT 中的文字和工具输入的文字。
该方法和 [loadFontFaces](#//api/name/loadFontFaces:completionHandler:) 都可以声明在本地白板中可用的字体,区别是 [setupFontFaces](#//api/name/setupFontFaces:) 没有回调,因为无法判断字体声明是否正确;loadFontFaces 会触发回调,报告每一种的预加载结果。
*Note:**
- 该方法只对本地白板生效,不影响远端白板的字体显示。
- 通过该方法声明的字体,只有当被使用时,才会触发下载。
- 不同的字体在不同设备上的渲染可能不同,例如,在某些设备上,要等字体加载完成后,才会渲染文字;而在另外一些设备上,会先使用默认的字体渲染文字,等指定的字体加载完毕后,再整体刷新。
- 每次调用该方法都会覆盖原来的字体声明。
- 请勿同时调用该方法和 [loadFontFaces](#//api/name/loadFontFaces:completionHandler:) 方法。否则,无法预期行为。
#### 参数 [#参数-7]
| `fontFaces` | 字体配置文件,详见 [WhiteFontFace](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-font-face)。 |
| --- | --- |
### `– loadFontFaces:completionHandler:` [#-loadfontfacescompletionhandler]
\- (void)loadFontFaces:(NSArray <WhiteFontFace *>*)fontFaces completionHandler:(void (^)(BOOL success, WhiteFontFace *fontFace, NSError * _Nullable error))completionHandler;
声明在本地白板中可用的字体并预加载。
Declared in SDK/WhiteSDK.h
#### 版本 [#版本-1]
2.11.3
调用该方法预加载的字体可以用于显示 PPT 中的文字和工具输入的文字。
该方法和 [setupFontFaces](#//api/name/setupFontFaces:) 都可以声明在本地白板中可用的字体,区别是 [setupFontFaces](#//api/name/setupFontFaces:) 没有回调,因为无法判断字体声明是否正确;[loadFontFaces](#//api/name/loadFontFaces:completionHandler:) 会触发回调,报告每一种的预加载结果。
*Note:**
- 该方法只对本地白板生效,不影响远端白板的字体显示。
- 使用该方法预加载的字体,只有当该字体被使用时,才会触发下载。
- 不同的字体在不同设备上的渲染可能不同,例如,在某些设备上,要等字体加载完成后,才会渲染文字;而在另外一些设备上,会先使用默认的字体渲染文字,等指定的字体加载完毕后,再整体刷新。
- 通过该方法预加载的字体无法删除,每次调用都会在原来的基础上新增。
- 请勿同时调用该方法和 setupFontFaces 方法。否则,无法预期行为。
#### 参数 [#参数-8]
| `fontFaces` | WhiteFontFace 对象,详见 WhiteFontFace。 |
| --- | --- |
| `completionHandler` | [api-center-table-16 details](#table-slot-api-center-table-16) |
**api-center-table-16 details**
调用结果:
- 如果方法调用成功,则返回 `FontFace` 对象
- 如果方法调用失败,则返回错误信息,详见 NSError。
每加载完成一种字体,会触发一个回调,报告该字体是否加载成功。传入的 [WhiteFontFace](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-font-face) 对象中有多少种字体,就会有多少个回调。
### `– updateTextFont:` [#-updatetextfont]
\- (void)updateTextFont:(NSArray <NSString *>*)fonts;
设置文字工具在本地白板中使用的字体。
Declared in SDK/WhiteSDK.h
#### 版本 [#版本-2]
2.11.3
*Note:**
- 该方法只对本地白板生效,不影响远端白板的字体显示。
- 该方法只能设置文字工具使用的字体,不能用于 PPT 中的文字显示。
#### 参数 [#参数-9]
| `fonts` | 字体名称。如果用户系统中不存在该字体,则文字工具无法使用该字体。请确保你已经调用 [setupFontFaces](#//api/name/setupFontFaces:) 或 [loadFontFaces](#//api/name/loadFontFaces:completionHandler:) 将指定字体加载到本地白板中。 |
| --- | --- |
### `– getSlideVolumeWithCompletionHandler:` [#-getslidevolumewithcompletionhandler]
\- (void)getSlideVolumeWithCompletionHandler:(void(^)(CGFloat volume, NSError *error))completionHandler;
获取当前 slide 音量
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-10]
| `completionHandler` | 调用结果 - 如果调用成功: volume 返回值为 0-1 之间的值,error 为 nil - 如果调用失败: volume 返回值为0,error 会返回详细信息 |
| --- | --- |
### `– updateSlideVolume:` [#-updateslidevolume]
\- (void)updateSlideVolume:(CGFloat)volume;
更新当前 slide 音量
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-11]
| `volume` | 音量值,0-1 |
| --- | --- |
### `– recoverSlide:slideIndex:` [#-recoverslideslideindex]
\- (void)recoverSlide:(NSString *)slideId slideIndex:(NSInteger)slideIndex;
恢复 Slide, 跳转到其他页, RESOURCE_ERROR 和 RUNTIME_ERROR 可以用这种方式恢复
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-12]
| `slideId` | 使用错误消息里告知的 slideId |
| --- | --- |
| `slideIndex` | [api-center-table-17 details](#table-slot-api-center-table-17) |
**api-center-table-17 details**
指定要跳转到哪一页, 如果想要跳转到下一页可以使用错误消息里告知的报错页码 + 1
### `– recoverSlide:` [#-recoverslide]
\- (void)recoverSlide:(NSString *)slideId;
恢复 Slide, RESOURCE_ERROR 可以用这种方式恢复
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-13]
| `slideId` | 使用错误消息里告知的 slideId |
| --- | --- |
### `– setCommonCallbackDelegate:` [#-setcommoncallbackdelegate]
\- (void)setCommonCallbackDelegate:(nullable id<WhiteCommonCallbackDelegate>)callbackDelegate;
设置通用回调事件。
SDK 通过 [WhiteCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-common-callbacks) 类向 app 报告 SDK 运行时的各项事件。
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-14]
| `callbackDelegate` | 通用回调事件,详见 [WhiteCommonCallbackDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate)。 |
| --- | --- |
### `– setSlideDelegate:` [#-setslidedelegate]
\- (void)setSlideDelegate:(nullable id<WhiteSlideDelegate>)slideDelegate;
设置 多窗口 Slide 回调事件。
SDK 通过 [WhiteSlideDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-slide-delegate) 类处理 Slide 的回调。
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-15]
| `slideDelegate` | Slide 回调事件,详见 [WhiteSlideDelegate](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-slide-delegate)。 |
| --- | --- |
### `– registerAppWithParams:completionHandler:` [#-registerappwithparamscompletionhandler]
\- (void)registerAppWithParams:(WhiteRegisterAppParams *)params completionHandler:(void (^)(NSError * _Nullable error))completionHandler;
注册自定义App
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-16]
| `params` | 注册参数,详见 [WhiteRegisterAppParams](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-register-app-params) |
| --- | --- |
### `– requestSlideLogToFilePath:result:` [#-requestslidelogtofilepathresult]
\- (void)requestSlideLogToFilePath:(NSString *)path result:(void(^)(BOOL success, NSError *error))result;
将 Slide 日志写入到指定的文件路径。
Declared in SDK/WhiteSDK.h
#### 参数 [#参数-17]
| `path` | 将要写入文件的 path,如果文件不存在,会直接创建。如果已存在,会在文件末尾下继续写入日志。 |
| --- | --- |
| `result` | [api-center-table-18 details](#table-slot-api-center-table-18) |
**api-center-table-18 details**
日志写入结果
### `– getLocalLogStateWithCompletionHandler:` [#-getlocallogstatewithcompletionhandler]
\- (void)getLocalLogStateWithCompletionHandler:(WhiteLocalLogCompletionHandler)completionHandler;
```text
获取 WebView 内本地日志状态。
```
Declared in SDK/WhiteSDK.h
### `– collectLocalLogsWithCompletionHandler:` [#-collectlocallogswithcompletionhandler]
\- (void)collectLocalLogsWithCompletionHandler:(WhiteLocalLogCompletionHandler)completionHandler;
```text
收集 WebView 内本地日志。该接口主要用于诊断。
```
Declared in SDK/WhiteSDK.h
### `– flushLocalLogsWithCompletionHandler:` [#-flushlocallogswithcompletionhandler]
\- (void)flushLocalLogsWithCompletionHandler:(WhiteLocalLogCompletionHandler)completionHandler;
```text
将 WebView 内本地日志刷新到持久化存储。
```
Declared in SDK/WhiteSDK.h
### `– uploadLocalLogsWithCompletionHandler:` [#-uploadlocallogswithcompletionhandler]
\- (void)uploadLocalLogsWithCompletionHandler:(WhiteLocalLogCompletionHandler)completionHandler;
```text
触发 WebView 内本地日志上传。
```
Declared in SDK/WhiteSDK.h
### `– reloadBackgroundImage:completionHandler:` [#-reloadbackgroundimagecompletionhandler]
\- (void)reloadBackgroundImage:(WhiteReloadBackgroundImageParams *)params completionHandler:(WhiteReloadBackgroundImageCompletionHandler)completionHandler;
重载当前聚焦场景此前失败的插件背景图;source 填 appliance。accepted 表示接收,reloadedCount 表示触发重载数量,不表示加载成功。
```text
重新加载当前聚焦场景中此前加载失败的背景图片。
```
Declared in SDK/WhiteSDK.h
### `– hasBackgroundImage:completionHandler:` [#-hasbackgroundimagecompletionhandler]
\- (void)hasBackgroundImage:(WhiteHasBackgroundImageParams *)params completionHandler:(WhiteHasBackgroundImageCompletionHandler)completionHandler;
按 viewId、scenePath、imageUrl 和 sources 查询插件背景图;当前来源填 appliance。需要启用多窗口和教具插件。
```text
查询指定白板、场景和 URL 是否已有任一来源的背景图。
```
Declared in SDK/WhiteSDK.h
### `– setParameters:` [#-setparameters]
\- (void)setParameters:(NSDictionary *)parameters;
Declared in SDK/WhiteSDK.h
## 动态配置与生命周期 [#动态配置与生命周期]
### `– leaveRoomWithCompletionHandler:` [#-leaveroomwithcompletionhandler]
\- (void)leaveRoomWithCompletionHandler:(void (^_Nullable)(NSError * _Nullable error))completionHandler;
等待所属 Room 完成清理;error 为空表示成功。不返回房间全局状态快照。等待完成后再继续入房或销毁宿主。