AgoraEduUserHandler

onRemoteUserJoined

远端用户加入房间回调。

Objective-C

void onRemoteUserJoined(AgoraEduContextUserInfo userInfo)

参数

参数名	描述
userInfo	加入房间的用户的信息，详见 AgoraEduContextUserInfo。

onRemoteUserLeft

远端用户离开房间回调。

Objective-C

void onRemoteUserLeft(AgoraEduContextUserInfo user,
                      AgoraEduContextUserInfo operator,
                      AgoraEduContextUserLeaveReason reason)

参数

参数名	描述
user	离开房间的用户的信息，详见 AgoraEduContextUserInfo。
operator	操作者 AgoraEduContextUserInfo。如果远端用户是被踢出房间，则返回该参数。
reason	离开房间的原因，详见 AgoraEduContextUserLeaveReason。默认为 normal。

onUserUpdated

用户信息更新回调。

Objective-C

void onUserUpdated(AgoraEduContextUserInfo user,
                   AgoraEduContextUserInfo operator)

参数

参数名	描述
userInfo	信息发生变化的用户的 AgoraEduContextUserInfo。
operator	操作者 AgoraEduContextUserInfo，可为空。

onCoHostUserListAdded

用户成功上讲台回调。

Objective-C

void onCoHostUserListAdded(Array<AgoraEduContextUserInfo> userList,
                           AgoraEduContextUserInfo operator))

参数

参数名	描述
userList	上讲台用户列表，为 AgoraEduContextUserInfo 数组。
operator	操作者 AgoraEduContextUserInfo，可为空。

onCoHostUserListRemoved

用户离开讲台回调。

Objective-C

void onCoHostUserListRemoved(Array<AgoraEduContextUserInfo> userList,
                             AgoraEduContextUserInfo operator)

参数

参数名	描述
userList	上讲台用户列表，为 AgoraEduContextUserInfo 数组。
operator	操作者 AgoraEduContextUserInfo，可为空。

onUserPropertiesUpdated

自定义用户属性更新回调。

Objective-C

void onUserPropertiesUpdated(AgoraEduContextUserInfo user,
                             Map<String, String> changedProperties,
                             Map<String, String> cause,
                             AgoraEduContextUserInfo operator)

参数

参数名	描述
user	用户信息 AgoraEduContextUserInfo。
changedProperties	已更新的用户属性。
cause	更新原因。
operator	操作者 AgoraEduContextUserInfo，可为空。

onUserPropertiesDeleted

自定义用户属性删除回调。

Objective-C

void onUserPropertiesDeleted(AgoraEduContextUserInfo user,
                             Array<String> deletedProperties,
                             Map<String, String> cause,
                             AgoraEduContextUserInfo operator)

参数

参数名	描述
user	用户信息 AgoraEduContextUserInfo。
deletedProperties	被删除的属性。
cause	删除原因。
operator	操作者 AgoraEduContextUserInfo，可为空。

onUserRewarded

用户奖励数量变更回调。

Objective-C

void onUserRewarded(AgoraEduContextUserInfo user,
                    int rewardCount,
                    AgoraEduContextUserInfo operator)

参数

参数名	描述
user	用户信息 AgoraEduContextUserInfo。
rewardCount	奖励数量。
operator	操作者 AgoraEduContextUserInfo，可为空。

onLocalUserKickedOut

本地用户被踢出房间回调。

Objective-C

void onLocalUserKickedOut()

当本地用户被踢出房间时，SDK 会触发此回调。

onHandsWaveEnabled

举手功能是否启用回调。

Objective-C

void onHandsWaveEnabled(Bool enabled)

提示举手申请上讲台功能是否已启用。

参数

参数名	描述
enabled	用户是否能举手。

onUserHandsWave

用户举手回调。

Objective-C

void onUserHandsWave(String userUuid,
                     Int duration,
                     Map<String, Any> payload)

用户举手时，SDK 会触发此回调。

参数

参数名	描述
fromUser	举手的用户 AgoraEduContextUserInfo。
duration	举手时长，单位为秒。

onUserHandsDown

用户手放下回调。

Objective-C

void onUserHandsDown(AgoraEduContextUserInfo user)

SDK 会在以下两种情况下触发此回调：

• 用户取消举手申请。

• 用户取消申请被老师接受。

参数

参数名	描述
user	手放下的用户 AgoraEduContextUserInfo。