WhiteCommonCallbackDelegate Protocol Reference

throwError:

- (void)throwError:(NSError *)error

SDK 出现未捕获的全局错误回调。

参数

参数名	描述
error	错误信息。

urlInterrupter:

- (NSString *)urlInterrupter:(NSString *)url

图片拦截回调。

参数

参数名	描述
url	图片原地址。

返回值

替换后的图片地址。

讨论

Note:

• 要触发该回调，必须在初始化白板 SDK 时，设置 enableInterrupterAPI(YES) 开启图片拦截替换功能。详见 WhiteSdkConfiguration。

• 开启图片拦截替换功能后，在白板中插入图片或场景时，会触发该回调。

pptMediaPlay

- (void)pptMediaPlay

播放动态 PPT 中的音视频回调。

pptMediaPause

- (void)pptMediaPause

暂停播放动态 PPT 中的音视频回调。

sdkSetupFail:

- (void)sdkSetupFail:(NSError *)error

SDK 初始化失败回调。

参数

参数名	描述
error	错误信息。

可用性

2.9.13
如果 SDK 初始化失败，调用加入实时房间或回放房间时会处于一直无响应状态，需要重新初始化 SDK。
SDK 初始化失败可能由以下原因导致：

• 初始化 SDK 时候，网络异常，导致获取配置信息失败。

• 传入了不合法的 App Identifier。

customMessage:

- (void)customMessage:(NSDictionary *)dict

接收到网页发送的消息回调。

参数

参数名	描述
dict	字典格式的消息。只有当消息为字典格式时，本地用户才能收到。

讨论

消息回调包括：

• 字典格式的 iframe 数据

• 图片加载失败信息

• ppt 播放/暂停回调信息

当本地用户收到了网页（如 iframe 插件、动态 PPT）发送的消息时会触发该回调。

logger:

- (void)logger:(NSDictionary *)dict

获取 SDK 输出的本地调试日志。

参数

参数名	描述
dict	字典结构的日志消息，每条日志消息包含以下 key： funName：功能名称。 params：具体的参数设置。 例如，{"funName": "joinRoom", "params": {"isWritable": 1, "region": "cn-hz"}}。

可用性

v2.13.19
将 WhiteSdkConfiguration 类中 log 设为 YES 后，SDK 会触发该回调，返回 SDK 输出的本地调试日志。
如果你需要关闭该回调，可以将 log 设为 NO。

startRecoveringFromMemoryIssues

- (void)startRecoveringFromMemoryIssues

白板 SDK 即将开始恢复回调。

讨论

当白板 SDK 因内存不足而崩溃时会触发该回调。 目前只有实时房间会触发该回调。该回调最多会触发三次，超过三次会收到 -500 错误码。

endRecoveringFromMemoryIssues:

- (void)endRecoveringFromMemoryIssues:(BOOL)success

白板 SDK 完成了一次恢复回调。

参数

参数名	描述
success	本次恢复是否成功。

讨论

当白板 SDK 因内存不足而崩溃后，SDK 完成了一次恢复操作后会触发该回调。 如果恢复失败，SDK 不会主动继续重连。