# com.herewhite.sdk.AbstractCommonCallbacks类 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-common-callbacks)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

类 com.herewhite.sdk.AbstractCommonCallbacks 继承关系图:

![com.herewhite.sdk.AbstractCommonCallbacks类 参考 图示](https://web-cdn.agora.io/docs-portal/img/api-center-generated/d1b12d0ea36f-classcom_1_1herewhite_1_1sdk_1_1_abstract_common_callbacks.png)

<a id="details"></a>

## 详细描述 [#详细描述]

[`CommonCallbacks`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callbacks) 接口的缺省（空）实现。详见 [`CommonCallbacks`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callbacks)。

<a id="弃用"></a>

:::error[弃用:]
已废弃。空实现类由用户应用处理
:::

## 成员函数说明 [#成员函数说明]

<a id="aaceb1faaeaa59ec93dce1c88bcd8e7f6"></a>

### throwError() [#throwerror]

<ApiSignature>

void com.herewhite.sdk.AbstractCommonCallbacks.throwError(Object *args*)

</ApiSignature>

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

<ParameterList title="参数">
<Parameter name="args">

错误信息。

</Parameter>
</ParameterList>

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a721b4489c52b2740f233a1742f555916).

<a id="a1a80dee592bc7f609526d317506bc563"></a>

### urlInterrupter() [#urlinterrupter]

<ApiSignature>

String com.herewhite.sdk.AbstractCommonCallbacks.urlInterrupter(String *sourceUrl*)

</ApiSignature>

图片 URL 拦截回调。

:::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 拦截。
:::

<ParameterList title="参数">
<Parameter name="sourceUrl">

原 URL 地址。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值"}>返回值</h4>

替换后的 URL 地址。请确保在返回值中进行传参。

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a28839222c6e4b44a001da833300991d4).

<a id="a21ecfcd612e98811d2a9adfc20c6564b"></a>

### onPPTMediaPlay() [#onpptmediaplay]

<ApiSignature>

void com.herewhite.sdk.AbstractCommonCallbacks.onPPTMediaPlay()

</ApiSignature>

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

:::info[自从]
2.9.13
:::

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a695dc7abd40851cd0ffe0e573566e8f1).

<a id="a104dc982d2a8267f3d7f63e1692bc8c9"></a>

### onPPTMediaPause() [#onpptmediapause]

<ApiSignature>

void com.herewhite.sdk.AbstractCommonCallbacks.onPPTMediaPause()

</ApiSignature>

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

:::info[自从]
2.9.13
:::

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a9967d9cd3eb16c0db3024f7a6a8c7d64).

<a id="a569de82a2548a7fb84c80845cae67767"></a>

### onMessage() [#onmessage]

<ApiSignature>

void com.herewhite.sdk.AbstractCommonCallbacks.onMessage(JSONObject *message*)

</ApiSignature>

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

:::info[自从]
2.11.4
:::

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

:::info[注解]
不保证所有用户都能接收到该回调。
:::

<ParameterList title="参数">
<Parameter name="message">

JSON 格式的消息。只有当消息为 JSON 格式时，本地用户才能收到。

</Parameter>
</ParameterList>

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a2a843f00164c64d248143d2194beecae).

<a id="abbcf9b3946c0bf5ff20f1d3ba9cebdce"></a>

### sdkSetupFail() [#sdksetupfail]

<ApiSignature>

void com.herewhite.sdk.AbstractCommonCallbacks.sdkSetupFail(SDKError *error*)

</ApiSignature>

SDK 初始化失败回调。

:::info[自从]
2.9.14
:::

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

- 初始化 SDK 时候，网络异常，导致获取配置信息失败。
- 传入了不合法的 App Identifier。

实现了 [com.herewhite.sdk.CommonCallback](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-common-callback#a0a988489c8559923f178eef3ba322704).