ZegoRangeSceneTeamEventHandler
ZegoRangeSceneTeamEventHandler
Declared in ZegoExpressEventHandler.h
方法
onTeamStateUpdate:state:errorCode:teamID:
onTeamStateUpdate:state:errorCode:teamID:
- (void)onTeamStateUpdate:(ZegoRangeScene *) rangeScene state:(ZegoTeamState) state errorCode:(int) errorCode teamID:(unsigned int) teamID;小队状态变化通知
Declared in
ZegoExpressEventHandler.h参数
| 名称 | 类型 | 描述 |
|---|---|---|
| rangeScene | ZegoRangeScene * | 触发此次回调的范围场景实例。 |
| state | ZegoTeamState | 变化后的小队状态。 |
| errorCode | int | 错误码,详情请参考 常见错误码。 |
| teamID | unsigned int | 小队 ID。 |
详情
当小队的连接状态改变时触发该回调,并通知改变的原因。
- 业务场景:开发者可以通过这个回调来判断小队内当前用户的状态。
- 通知时机: 1. 开发者调用 [joinTeam]、[leaveTeam] 函数时会收到此通知。
- 用户设备的网络情况变化时也可能收到此通知 (SDK 在断线重连时会自动重新加入小队,详情请参考 SDK 是否支持断线重连机制。
- 相关接口:[joinTeam]、[leaveTeam]。
- 支持版本:3.1.0 及以上。
- 使用限制:无。
- 注意事项:若长时间处于正在请求连接状态(ZegoTeamStateLogining),一般是因为用户端网络不稳定导致。
onTeamMemberUpdate:updateType:userList:teamID:
onTeamMemberUpdate:updateType:userList:teamID:
- (void)onTeamMemberUpdate:(ZegoRangeScene *) rangeScene updateType:(ZegoUpdateType) updateType userList:(NSArray<ZegoUser *> *) userList teamID:(unsigned int) teamID;小队内其他成员增加或减少的回调通知。
Declared in
ZegoExpressEventHandler.h参数
| 名称 | 类型 | 描述 |
|---|---|---|
| rangeScene | ZegoRangeScene * | 触发此次回调的范围场景实例。 |
| updateType | ZegoUpdateType | 更新类型(添加/删除)。 |
| userList | NSArray<ZegoUser *> * | 当前小队内变更的用户列表。 |
| teamID | unsigned int | 小队 ID。 |
详情
当小队内有其他用户上线或下线时,导致小队内用户列表发生变化,会通过本回调通知开发者。
- 业务场景:开发者可以通过这个回调来实时更新小队内的用户列表展示。
- 通知时机: 1. 用户首次加入小队时,如果小队内有其他用户,SDK 会触发 "updateType" 为 [ZegoUpdateTypeAdd] 的回调通知,此时 "userList" 为小队内的其他用户。 2. 用户已在小队内,如果有其他用户通过 [joinTeam] 函数加入到本小队,SDK 会触发 "updateType" 为 [ZegoUpdateTypeAdd] 的回调通知。 3. 用户已在小队内,有其他用户通过 [leaveTeam] 函数退出本小队,SDK 会触发 "updateType" 为 [ZegoUpdateTypeDelete] 的回调通知。
- 相关接口:[joinTeam]、[leaveTeam]。
- 支持版本:3.1.0 及以上。
