# com.herewhite.sdk.RoomListener接口 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/interfacecom-1-1herewhite-1-1sdk-1-1-room-listener)

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

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

![com.herewhite.sdk.RoomListener接口 参考 图示](https://web-cdn.agora.io/docs-portal/img/api-center-generated/92595244b275-interfacecom_1_1herewhite_1_1sdk_1_1_room_listener.png)

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

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

房间事件回调接口。

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

<a id="a435c4e0371cf97bb4f60af1bb950a354"></a>

### onPhaseChanged() [#onphasechanged]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onPhaseChanged([RoomPhase](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-room-phase) *phase*)

</ApiSignature>

房间连接状态变化回调。

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

房间的连接状态，详见 [`RoomPhase`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/enumcom-1-1herewhite-1-1sdk-1-1domain-1-1-room-phase)。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#a99cd28c3beb26991d82667046ba580c4) 内被实现.

<a id="a27be03d9afa099e6fea594cf459fb5ad"></a>

### onDisconnectWithError() [#ondisconnectwitherror]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onDisconnectWithError(Exception *e*)

</ApiSignature>

白板 SDK 与白板服务器连接中断回调。

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

错误信息。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#a7e9b52c6a9b5ed4f2be40002f519e99d) 内被实现.

<a id="a7671d2258528ecaaadb5718854cd8964"></a>

### onKickedWithReason() [#onkickedwithreason]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onKickedWithReason(String *reason*)

</ApiSignature>

用户被服务器移出房间回调。

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

用户被移除房间的原因。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#af133346a411515cc0dd52b07765a7f48) 内被实现.

<a id="a48ebcd9188489a05226fe00c963f857b"></a>

### onRoomStateChanged() [#onroomstatechanged]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onRoomStateChanged([RoomState](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-room-state) *modifyState*)

</ApiSignature>

房间状态属性发生变化回调。

该回调仅返回发生变化的房间状态属性，未发生变化的房间状态字段，均未空。

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

发生变化的房间状态属性，详见 [`RoomState`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1domain-1-1-room-state)。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#a250e6883fbe05965dbe72c0d9b1a2bf9) 内被实现.

<a id="a45494cc4c33779d052d8662424e7690c"></a>

### onCanUndoStepsUpdate() [#oncanundostepsupdate]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onCanUndoStepsUpdate(long *canUndoSteps*)

</ApiSignature>

可撤销次数发生变化回调。

当本地用户调用 [`undo`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-room#a0cd3966f1df8de10f2bb5759fa28998b) 撤销上一步操作时，会触发该回调，报告剩余的可撤销次数。

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

剩余的可撤销次数。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#aae420ad231b354677f4516d67e67d52c) 内被实现.

<a id="adaa02e554b0b5c3bce169122e5dcc18a"></a>

### onCanRedoStepsUpdate() [#oncanredostepsupdate]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onCanRedoStepsUpdate(long *canRedoSteps*)

</ApiSignature>

可重做次数发生变化回调。

当本地用户调用 [`redo`](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-room#a9ad047897d74af1590316cc5d338408c) 重做上一步操作时，会触发该回调，报告剩余的可重做次数。

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

剩余的可重做次数。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#a176bd3ba52faf404434191aa0e54e5fb) 内被实现.

<a id="a8fa461f4b6c4891481fa11c8c0392368"></a>

### onCatchErrorWhenAppendFrame() [#oncatcherrorwhenappendframe]

<ApiSignature>

void com.herewhite.sdk.RoomListener.onCatchErrorWhenAppendFrame(long *userId*, Exception *error*)

</ApiSignature>

同步用户操作发生错误回调。

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

用户 ID，表明在同步哪个用户的操作时发生了错误。

</Parameter>
<Parameter name="error">

错误原因。

</Parameter>
</ParameterList>

在 [com.herewhite.sdk.AbstractRoomCallbacks](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/classcom-1-1herewhite-1-1sdk-1-1-abstract-room-callbacks#a9ed51525a523c043a2b955622d8f3c02) 内被实现.