onRoomStateUpdate property
getter/setter pair
房间状态变化通知。
支持版本:1.1.0 及以上。 详情描述:当房间的连接状态改变时触发该回调,并通知改变的原因。2.18.0 及以上版本推荐使用 onRoomStateChanged 回调来替代 onRoomStateUpdate 回调监听房间状态变化。 业务场景:开发者可以通过这个回调来判断房间内当前用户的状态。 通知时机:
- 开发者调用
loginRoom
、logoutRoom
、switchRoom
函数时会收到此通知。 - 用户设备的网络情况变化时也可能收到此通知 (SDK 在断线时会自动重新登录房间,详情请参考 SDK 是否支持断线重连机制。
使用限制:无。
注意事项:若长时间处于正在请求连接状态(ZegoRoomStateConnecting),一般是因为用户端网络不稳定导致。
相关接口:
loginRoom
、logoutRoom
、switchRoom
。
roomID
房间 ID,最大长度为 128 字节的字符串。state
变化后的房间状态。errorCode
错误码,详情请参考 常见错误码。extendedData
状态更新附带的扩展信息。当房间登录成功时,可通过"room_session_id" key 获取每一次音视频通信唯一的 RoomSessionID,标识房间内首个用户发起音视频通信到最后一个用户结束通信的持续通信。可用于通话质量评分、通话问题诊断等场景中。
Implementation
static void Function(String roomID, ZegoRoomState state, int errorCode,
Map<String, dynamic> extendedData)? onRoomStateUpdate;