# 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 为空表示成功。不返回房间全局状态快照。等待完成后再继续入房或销毁宿主。