接口列表

• HummerEventListener

Public 回调函数	函数名
void	onHummerStateChanged
void	onHummerKicked
void	onHummerPreviousTokenExpired

• EventListener

Public 回调函数	函数名
void	onPeerMessageReceived

• RoomEventListener

Public 回调函数	函数名
void	onRoomMessageReceived
void	onRoomAttributesSet
void	onRoomAttributesAddedOrUpdated
void	onRoomAttributesDeleted
void	onRoomAttributesCleared

• MemberEventListener

Public 回调函数	函数名
void	onRoomMemberJoined
void	onRoomMemberLeft
void	onRoomMemberOffline
void	onRoomMemberCountChanged
void	onRoomMemberAttributesSet
void	onRoomMemberAttributesAddedOrUpdated
void	onRoomMemberAttributesDeleted
void	onRoomMemberAttributesCleared

回调详细说明

HummerEventListener

HummerEventListener.onHummerStateChanged

void onHummerStateChanged(State fromState, State toState, String reason);

Hummer SDK 状态变更回调

参数

参数	描述
fromState	变更前状态,详见 HMR.State
toState	当前状态
reason	变更理由

---

HummerEventListener.onHummerKicked

void onHummerKicked(int code, String description);

SDK收到多端登录被踢的回调方法

参数

参数	描述
code	用户被踢下线的原因
description	用户被踢下线的具体描述

HummerEventListener.onHummerPreviousTokenExpired

void onHummerPreviousTokenExpired();

token过期失效，SDK给予业务层的回调通知

注意：

• 只有在 SDK 断线重连时token过期才会触发，收到该回调时，请调用 refreshToken 方法刷新Token

---

EventListener

EventListener.onPeerMessageReceived

void onPeerMessageReceived(long fromUserId, Message message);

当收到点对点信令消息时，会收到该事件的通知回调

注意：

• 该方法通过调用 sendMessage 发生回调。

参数

参数	描述
fromUserId	发送者标识
message	收到的信令消息

---

RoomEventListener

RoomEventListener.onRoomMessageReceived

void onRoomMessageReceived(@NonNull RoomId roomId,
                           long fromUserId,
                           Message message);

当有一个用户往房间内发一条信令消息时，房间内所有的成员都会收到该事件的通知回调

注意：

• 该方法通过调用 sendMessage 发生回调。

参数

参数	描述
roomId	房间标识
fromUserId	发送者标识
message	收到的信令消息

---

RoomEventListener.onRoomAttributesSet

void onRoomAttributesSet(@NonNull RoomId roomId,
                         long userId,
                         @NonNull Map<String, String> attributes);

房间属性设置通知

注意：

• 该方法通过调用 setRoomAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	操作者标识
attributes	设置的属性

---

RoomEventListener.onRoomAttributesAddedOrUpdated

void onRoomAttributesAddedOrUpdated(@NonNull RoomId roomId,
                                    long userId,
                                    @NonNull Map<String, String> attributes);

房间属性新增或更新通知

注意：

• 该方法通过调用 addOrUpdateRoomAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	操作者标识
attributes	添加或更新的属性

---

RoomEventListener.onRoomAttributesDeleted

void onRoomAttributesDeleted(@NonNull RoomId roomId,
                             long userId,
                             @NonNull Map<String, String> attributes);

房间属性删除通知

注意：

• 该方法通过调用 deleteRoomAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	操作者标识
attributes	删除的属性

---

RoomEventListener.onRoomAttributesCleared

void onRoomAttributesCleared(@NonNull RoomId roomId,
                             long userId,
                             @NonNull Map<String, String> attributes);

房间属性清空通知

注意：

• 该方法通过调用 clearRoomAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	操作者标识
attributes	清空的属性

---

MemberEventListener

MemberEventListener.onRoomMemberJoined

void onRoomMemberJoined(@NonNull RoomId roomId, @NonNull Set<Long> joinMembers);

成员进入房间通知

注意：

• 该方法通过调用 join 发生回调。
• 当房间人数超过500人时，将不会有该通知

参数

参数	描述
roomId	房间标识
joinMembers	成员标识列表

---

MemberEventListener.onRoomMemberLeft

void onRoomMemberLeft(@NonNull RoomId roomId, @NonNull Set<Long> leftMembers);

成员离开房间通知

注意：

• 该方法通过调用 leave 发生回调。
• 用户自己主动调用leaveRoom方法离开房间，不一定能收到该通知
• 同房间内其他成员离开房间都能收到该通知
• 当房间人数超过500人时，将不会有该通知

参数

参数	描述
roomId	房间标识
leftMembers	成员标识列表

---

MemberEventListener.onRoomMemberOffline

void onRoomMemberOffline(Set<RoomId> roomIds);

当前用户断线超时离开房间通知

注意：

• 只有当前用户因本地断线超时离开房间时才会触发该通知

参数

参数	描述
roomIds	房间标识列表

---

MemberEventListener.onRoomMemberCountChanged

void onRoomMemberCountChanged(@NonNull RoomId roomId, Integer count);

房间人数变更通知

注意：

• 该方法通过调用 join 以及 leave发生回调。

参数

参数	描述
roomId	房间标识
count	房间成员总数

---

MemberEventListener.onRoomMemberAttributesSet

void onRoomMemberAttributesSet(@NonNull RoomId roomId,
                               long userId,
                               @NonNull Map<String, String> attributes);

房间成员属性设置回调通知

注意：

• 该方法通过调用 setMemberAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	房间成员标识
attributes	设置的属性

---

MemberEventListener.onRoomMemberAttributesAddedOrUpdated

void onRoomMemberAttributesAddedOrUpdated(@NonNull RoomId roomId,
                                          long userId,
                                          @NonNull Map<String, String> attributes);

房间成员属性新增或更新回调通知

注意：

• 该方法通过调用 addOrUpdateMemberAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	房间成员标识
attributes	添加或更新的属性

---

MemberEventListener.onRoomMemberAttributesDeleted

void onRoomMemberAttributesDeleted(@NonNull RoomId roomId,
                                   long userId,
                                   @NonNull Map<String, String> attributes);

房间成员属性删除回调通知

注意：

• 该方法通过调用 deleteMemberAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	房间成员标识
attributes	删除的属性

---

MemberEventListener.onRoomMemberAttributesCleared

void onRoomMemberAttributesCleared(@NonNull RoomId roomId,
                                   long userId,
                                   @NonNull Map<String, String> attributes);

房间成员属性清空回调通知

注意：

• 该方法通过调用 clearMemberAttributes 发生回调。

参数

参数	描述
roomId	房间标识
userId	房间成员标识
attributes	清空的属性

---