# com.herewhite.sdk.CommonCallback interface 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
适用版本:**Whiteboard Android SDK 2.16.134**。
`CommonCallback`,用于 SDK 向 app 发送回调事件通知。
<p>
实时房间和回放房间都可以继承该接口下的回调方法。
@since 2.9.13
| 公开成员签名 | |
| --- | --- |
| void | [throwError](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a721b4489c52b2740f233a1742f555916) (Object args) |
| String | [urlInterrupter](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a28839222c6e4b44a001da833300991d4) (String sourceUrl) |
| void | [onPPTMediaPlay](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a695dc7abd40851cd0ffe0e573566e8f1) () |
| void | [onPPTMediaPause](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a9967d9cd3eb16c0db3024f7a6a8c7d64) () |
| void | [onMessage](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a2a843f00164c64d248143d2194beecae) (JSONObject object) |
| void | [onBackgroundImageLoad](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a88366f40f1db79a7428623bd0ee12ca3) (BackgroundImageLoadEvent event) |
| void | [onApplianceInitLoadingChange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a50b38e364a3817b1de357fe022b493bf) (ApplianceInitLoadingChangeEvent event) |
| void | [sdkSetupFail](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a0a988489c8559923f178eef3ba322704) (SDKError error) |
| void | [onLogger](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a9ccc2cfa4bf7288dd894347454eaead7) (JSONObject object) |
| void | [onLocalLogStateChange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#aa44a2e63f238617b93ec282f23d4c47e) (JSONObject state) |
## 函数说明 [#函数说明]
### throwError() [#throwerror]
void throwError(Object args)
SDK 出现未捕获的全局错误回调。
错误信息。
在 [com.herewhite.sdk.AbstractCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks#aaceb1faaeaa59ec93dce1c88bcd8e7f6) 内被实现.
### urlInterrupter() [#urlinterrupter]
String urlInterrupter(String sourceUrl)
图片拦截回调。
:::info[自从]
2.9.14
:::
该回调默认禁用。你可以在初始化白板 SDK 时,通过 [`setEnableInterrupterAPI`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#aa2e118f6e449997fbd487a5d5357745b)(true) 方法开启。
开启后,在白板中插入图片时,SDK 会触发该回调,报告图片的原 URL 地址。你可以在该回调中将原 URL 地址替换成指定的 URL 地址。
:::info[注解]
开启后,SDK 会频繁触发该回调,因此 Agora 不推荐开启该回调;在 Android 平台,你可以使用 WebView 的拦截功能进行图片拦截。
:::
原 URL 地址。
返回值
替换后的图片地址。请确保在返回值中进行传参。
在 [com.herewhite.sdk.AbstractCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks#a1a80dee592bc7f609526d317506bc563) 内被实现.
### onPPTMediaPlay() [#onpptmediaplay]
void onPPTMediaPlay()
播放动态 PPT 中的音视频回调。
:::info[自从]
2.9.13
:::
在 [com.herewhite.sdk.AbstractCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks#a21ecfcd612e98811d2a9adfc20c6564b) 内被实现.
### onPPTMediaPause() [#onpptmediapause]
void onPPTMediaPause()
暂停播放动态 PPT 中的音视频回调。
:::info[自从]
2.9.13
:::
在 [com.herewhite.sdk.AbstractCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks#a104dc982d2a8267f3d7f63e1692bc8c9) 内被实现.
### onMessage() [#onmessage]
void onMessage(JSONObject object)
接收到网页发送的消息回调。
:::info[自从]
2.11.4
:::
当本地用户收到了网页(如 iframe 插件、动态 PPT)发送的消息时会触发该回调。
:::info[注解]
不保证所有用户都能接收到该回调。
:::
JSON 格式的消息。只有当消息为 JSON 格式时,本地用户才能收到。
在 [com.herewhite.sdk.AbstractCommonCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks#a569de82a2548a7fb84c80845cae67767) 内被实现.
### onBackgroundImageLoad() [#onbackgroundimageload]
void onBackgroundImageLoad(BackgroundImageLoadEvent event)
背景图加载事件:name、state(success/failed/cancelled)、source(appliance)、resourceId、resourceUrl、viewId、scenePath。
### onApplianceInitLoadingChange() [#onapplianceinitloadingchange]
void onApplianceInitLoadingChange(ApplianceInitLoadingChangeEvent event)
教具初始化进度事件:name、loading、phase(plugin/worker/scene/ready)、status(start/success/timeout/error)。loading=false、phase=ready、status=success 表示就绪。
### sdkSetupFail() [#sdksetupfail]
void sdkSetupFail(SDKError error)
SDK 初始化失败。收到错误后重新创建/初始化 SDK,再重新入房;这不是普通房间断线重连事件。
### onLogger() [#onlogger]
void onLogger(JSONObject object)
获取 SDK 输出的本地调试日志。
:::info[自从]
2.13.22
:::
成功调用 [`setLog`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-white-sdk-configuration#af29676180672f3e54d050d591707312c)(true) 后,SDK 会触发该回调,向你发送本地调试日志。
如果你需要关闭该回调,可以设置 `setLog(false)`。
:::info[注解]
设置 `setLog(false)` 后,SDK 会停止通过 `onLogger` 回调发送本地调试日志,但仍然会通过该回调发送 [`video-js-plugin`](https://www.npmjs.com/package/@netless/video-js-plugin) 插件的日志信息。
:::
JSON 对象格式的日志消息,每条日志消息包含以下 key:
- `funName`:功能名称。
- `params`:具体的参数设置。
例如,`{"funName": "joinRoom", "params": {"isWritable": 1, "region": "cn-hz"}}`。
### onLocalLogStateChange() [#onlocallogstatechange]
void onLocalLogStateChange(JSONObject state)
WebView 内本地日志状态变更,回调参数为 JSON 状态对象。