HMR.StateListener

StateListener.onUpdateHummerState

void onUpdateHummerState(State fromState, State toState)

Hummer SDK 状态变更回调

参数

参数	描述
fromState	变更前状态，详见 HMR.State
toState	当前状态

---

HMR.TokenInvalidListener

TokenInvalidListener.onHummerTokenInvalid

void onHummerTokenInvalid(TokenInvalidCode code, String desc)

废弃

注意：

该方法已弃用，请改用 onHummerPreviousTokenExpired。

鉴权 Token 无效通知

参数

参数	描述
code	无效类型，详见HMR.TokenInvalidCode
desc	无效原因

---

TokenInvalidListener.onHummerPreviousTokenExpired

void onHummerPreviousTokenExpired()

Token 过期时候的通知，仅在断线重连时触发，收到该通知后，请调用refreshToken(String token, HMR.Completion completion)接口更新Token

---

HMR.TokenInvalidCode

public enum TokenInvalidCode {
    EXPIRED(1);
}

Token 无效类型

位运算	含义
EXPIRED(1)	过期

---

ChannelStateService.ChannelStateListener

ChannelStateListener.onUpdateChannelState

void onUpdateChannelState(ChannelState fromState, ChannelState toState);

SDK 连接状态变更通知

参数

参数	描述
fromState	变更前状态，详见 ChannelState
toState	当前状态

---

ChatRoomService.ChatRoomListener

ChatRoomListener.onChatRoomDismissed

void onChatRoomDismissed(@NonNull ChatRoom chatRoom, @NonNull User member);

当聊天室被解散时发生的回调通知

注意：

该方法通过调用 dismissChatRoom 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
member	解散聊天室的管理员

---

ChatRoomListener.onBasicInfoChanged

void onBasicInfoChanged(@NonNull ChatRoom chatRoom,
                        @NonNull Map<ChatRoomInfo.BasicInfoType, String> propInfo);

当聊天室基础信息发生变化时的回调

注意：

该方法通过调用 changeBasicInfo 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
propInfo	变化的键值对，其中key值参见枚举详见：BasicInfoType

---

ChatRoomListener.onRoomInfoAddedOrUpdated

void onRoomInfoAddedOrUpdated(@NonNull ChatRoom chatRoom,
                              @NonNull User operator,
                              @NonNull Map<String, String> propInfo);

当聊天室信息新增或更新时发生的回调

注意：

该方法通过调用 addOrUpdateChatRoomInfo 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
operator	修改聊天室信息的管理员
propInfo	变化的键值对

---

ChatRoomService.MemberListener

MemberListener.onMemberJoined

void onMemberJoined(@NonNull ChatRoom chatRoom, @NonNull List<User> members);

当有成员进入聊天室时的回调

注意：

该方法通过调用 joinChatRoom 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
members	进入聊天室的成员

---

MemberListener.onMemberLeaved

void onMemberLeaved(@NonNull ChatRoom chatRoom,
                    @NonNull List<User> members,
                    int type,
                    @NonNull String reason);

废弃

注意：

该方法已弃用，请改用 onChatRoomMemberOffline 或 onChatRoomMemberLeave

当有成员离开聊天室时的回调

注意：

该方法通过调用 leaveChatRoom 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
members	离开聊天室的成员
type	离开聊天室的操作类型 0:LEAVING，1:DISCONNECTED
reason	离开聊天室的原因

---

MemberListener.onChatRoomMemberOffline

void onChatRoomMemberOffline(@NonNull ChatRoom chatRoom);

当前用户因为断网超时离开聊天室时的回调

注意：

该方法仅在当前用户本地断网超时发生回调。

参数

参数	描述
chatRoom	聊天室的标识

---

MemberListener.onChatRoomMemberLeave

void onChatRoomMemberLeave(@NonNull ChatRoom chatRoom, @NonNull List<User> members);

当有成员离开聊天室时的回调

注意：

该方法通过调用 leaveChatRoom 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
members	离开聊天室的成员

---

MemberListener.onMemberCountChanged

void onMemberCountChanged(@NonNull ChatRoom chatRoom, int count);

当聊天室成员数量发生变化时的回调

注意：

该方法通过调用 joinChatRoom 以及 leaveChatRoom 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
count	变化后的数量

---

MemberListener.onMemberKicked

void onMemberKicked(@NonNull ChatRoom chatRoom,
                    @NonNull User admin,
                    @NonNull List<User> members,
                    @NonNull String reason);

废弃

注意：

该方法已弃用，请改用新的 onMemberKicked 。

当聊天室成员被踢出聊天室时的回调

注意：

该方法通过调用 kick 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
admin	执行踢出操作的管理员
members	被踢出聊天室的成员
reason	被踢出聊天室的原因

---

[New]MemberListener.onMemberKicked

void onMemberKicked(@NonNull ChatRoom chatRoom,
                    @NonNull User admin,
                    @NonNull List<User> members,
                    @NonNull KickOff kickOff);

当聊天室成员被踢出聊天室时的回调

注意：

该方法通过调用 kick 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
admin	执行踢出操作的管理员
members	被踢出聊天室的成员
kickOff	被踢出聊天室的原因，详见 KickOff

---

MemberListener.onRoleAdded

void onRoleAdded(@NonNull ChatRoom chatRoom,
                 @NonNull String role,
                 @NonNull User admin,
                 @NonNull User fellow);

当聊天室成员被赋予角色时的回调

注意：

该方法通过调用 addRole 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
role	被赋予的角色
admin	赋予角色的管理员
fellow	被赋予角色的成员

---

MemberListener.onRoleRemoved

void onRoleRemoved(@NonNull ChatRoom chatRoom,
                   @NonNull String role,
                   @NonNull User admin,
                   @NonNull User fellow);

当聊天室成员被移除角色时的回调

注意：

该方法通过调用 removeRole 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
role	被移除的角色
admin	移除角色的管理员
fellow	被移除角色的成员

---

MemberListener.onMemberMuted

void onMemberMuted(@NonNull ChatRoom chatRoom,
                   @NonNull User operator,
                   @NonNull Set<User> members,
                   @Nullable String reason);

当聊天室成员被禁言时的回调

注意：

该方法通过调用 muteMember 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
operator	禁言的管理员
members	被禁言的成员
reason	禁言原因

---

MemberListener.onMemberUnmuted

void onMemberUnmuted(@NonNull ChatRoom chatRoom,
                     @NonNull User operator,
                     @NonNull Set<User> members,
                     @Nullable String reason);

当聊天室成员被解除禁言时的回调

注意：

该方法通过调用 unmuteMember 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
operator	解除禁言的管理员
members	被解除禁言的成员
reason	原因

---

MemberListener.onUserInfoSet

void onUserInfoSet(@NonNull ChatRoom chatRoom,
                   @NonNull User user,
                   @NonNull Map<String, String> infoMap);

当聊天室成员信息被设置时的回调

注意：

该方法通过调用 setUserInfo 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
user	信息变更的成员
infoMap	设置后的用户信息

---

MemberListener.onUserInfoDeleted

void onUserInfoDeleted(@NonNull ChatRoom chatRoom,
                       @NonNull User user,
                       @NonNull Map<String, String> infoMap);

当聊天室成员信息被删除时的回调

注意：

该方法通过调用 deleteUserInfoByKeys 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
user	信息变更的成员
infoMap	被删除的用户信息

---

MemberListener.onUserInfoAddedOrUpdated

void onUserInfoAddedOrUpdated(@NonNull ChatRoom chatRoom,
                              @NonNull User user,
                              @NonNull Map<String, String> infoMap);

当添加或更新聊天室成员信息时的回调

注意：

该方法通过调用 addOrUpdateUserInfo 发生回调。

参数

参数	描述
chatRoom	聊天室的标识
user	信息变更的成员
infoMap	添加或更新的信息

---

ChatService.MessageListener

MessageListener.beforeSendingMessage

void beforeSendingMessage(@NonNull Message message);

该回调发生于用户调用ChatService.send(Message, HMR.Completion)方法进行消息发送前

它一般用于在发送消息前将其添加到会话渲染界面，或者是消息入库等

参数

参数	描述
message	发送的消息

MessageListener.afterSendingMessage

void afterSendingMessage(@NonNull Message message);

该回调发生于用户调用ChatService.send(Message, HMR.Completion)方法进行消息发送完成（无论成功或失败）后

参数

参数	描述
message	发送的消息

MessageListener.beforeReceivingMessage

void beforeReceivingMessage(@NonNull Message message);

在消息接收、处理前，会执行该回调。

参数

参数	描述
message	接收的消息

MessageListener.afterReceivingMessage

void afterReceivingMessage(@NonNull Message message);

当接收到新的消息时，会通过该方法进行回调。

参数

参数	描述
message	接收的消息