# WhiteCommonCallbackDelegate Protocol Reference (/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). Whiteboard iOS SDK 2.16.147 公开接口。 @protocol WhiteCommonCallbackDelegate <NSObject> ## 成员 [#成员] - [throwError:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/throwError:) - [urlInterrupter:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/urlInterrupter:) - [pptMediaPlay](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/pptMediaPlay) - [pptMediaPause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/pptMediaPause) - [sdkSetupFail:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/sdkSetupFail:) - [customMessage:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/customMessage:) - [onBackgroundImageLoad:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/onBackgroundImageLoad:) - [onApplianceInitLoadingChange:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/onApplianceInitLoadingChange:) - [logger:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/logger:) - [localLogStateChange:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/localLogStateChange:) - [startRecoveringFromMemoryIssues](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/startRecoveringFromMemoryIssues) - [endRecoveringFromMemoryIssues:](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/protocols/white-common-callback-delegate#//api/name/endRecoveringFromMemoryIssues:) ### `– throwError:` [#-throwerror] \- (void)throwError:(NSError *)error; ```text SDK 出现未捕获的全局错误回调。 @param error 错误信息。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– urlInterrupter:` [#-urlinterrupter] \- (NSString *)urlInterrupter:(NSString *)url; ```text 图片拦截回调。 *Note:** - 要触发该回调,必须在初始化白板 SDK 时,设置 `enableInterrupterAPI(YES)` 开启图片拦截替换功能。详见 [WhiteSdkConfiguration](/zh-CN/api-reference/whiteboard/whiteboard-sdk/ios/classes/white-sdk-configuration)。 - 开启图片拦截替换功能后,在白板中插入图片或场景时,会触发该回调。 @param url 图片原地址。 @return 替换后的图片地址。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– pptMediaPlay` [#-pptmediaplay] \- (void)pptMediaPlay; ```text 播放动态 PPT 中的音视频回调。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– pptMediaPause` [#-pptmediapause] \- (void)pptMediaPause; ```text 暂停播放动态 PPT 中的音视频回调。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– sdkSetupFail:` [#-sdksetupfail] \- (void)sdkSetupFail:(NSError *)error; ```text SDK 初始化失败回调。 @since 2.9.13 如果 SDK 初始化失败,调用加入实时房间或回放房间时会处于一直无响应状态,需要重新初始化 SDK。 SDK 初始化失败可能由以下原因导致: - 初始化 SDK 时候,网络异常,导致获取配置信息失败。 - 传入了不合法的 App Identifier。 @param error 错误信息。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– customMessage:` [#-custommessage] \- (void)customMessage:(NSDictionary *)dict; ```text 接收到网页发送的消息回调。 消息回调包括: - 字典格式的 iframe 数据 - 图片加载失败信息 - ppt 播放/暂停回调信息 当本地用户收到了网页(如 iframe 插件、动态 PPT)发送的消息时会触发该回调。 @param dict 字典格式的消息。只有当消息为字典格式时,本地用户才能收到。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– onBackgroundImageLoad:` [#-onbackgroundimageload] \- (void)onBackgroundImageLoad:(WhiteBackgroundImageLoadEvent *)event; ```text 可见背景图片加载状态回调。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– onApplianceInitLoadingChange:` [#-onapplianceinitloadingchange] \- (void)onApplianceInitLoadingChange:(WhiteApplianceInitLoadingChangeEvent *)event; ```text Appliance 插件初始化进度回调。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– logger:` [#-logger] \- (void)logger:(NSDictionary *)dict; ```text @param dict 目前有两种日志: 1. SDK 的调用日志,{funName: string, params: id} funName 为对应 API 的名称 2. WebView 的 Console 日志, {[WhiteWKConsole]: string},该日志只有在设置 `loggerOptions.printLevelMask` 为 `WhiteSDKLoggerOptionLevelDebug` 时才会打印 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– localLogStateChange:` [#-locallogstatechange] \- (void)localLogStateChange:(NSDictionary *)state; ```text WebView 内本地日志状态变化回调。 @param state 本地日志运行状态。 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– startRecoveringFromMemoryIssues` [#-startrecoveringfrommemoryissues] \- (void)startRecoveringFromMemoryIssues; ```text 发生了内存不足问题,SDK 即将开始恢复白板 目前只有实时房间有可能触发该回调 该回调最多会触发三次 超过三次 ``` Declared in Displayer/WhiteCommonCallbacks.h ### `– endRecoveringFromMemoryIssues:` [#-endrecoveringfrommemoryissues] -(void)endRecoveringFromMemoryIssues:(BOOL)success; ```text 发生了内存不足问题,SDK 结束了一次恢复白板。 如果恢复失败,sdk 不会主动继续重连。 @param success 本次恢复是否成功 ``` Declared in Displayer/WhiteCommonCallbacks.h