Event Callback

Callback List

• HMR.StateListener

Public Callback Function	Method Signature
void	onUpdateHummerState(State fromState, State toState)

• HMR.TokenInvalidListener

Public Callback Function	Method Signature
void	onHummerTokenInvalid(TokenInvalidCode code, String desc)

• ChannelStateService.ChannelStateListener

Public Callback Function	Method Signature
void	onUpdateChannelState(ChannelState fromState, ChannelState toState)

• ChatRoomService.ChatRoomListener

Public Callback Function	Method Signature
void	onChatRoomDismissed(ChatRoom chatRoom, User member)
void	onBasicInfoChanged(ChatRoom chatRoom, Map<ChatRoomInfo.BasicInfoType, String> propInfo)

• ChatRoomService.MemberListener

Public Callback Function	Method Signature
void	onMemberJoined(ChatRoom chatRoom, List members)
void	onMemberLeaved(ChatRoom chatRoom, List members, int type, String reason)
void	onMemberCountChanged(ChatRoom chatRoom, int count)
void	onMemberKicked(ChatRoom chatRoom, User admin, List member, String reason)
void	onRoleAdded(ChatRoom chatRoom, String role, NonNull User admin, User fellow)
void	onRoleRemoved(ChatRoom chatRoom, String role, User admin, User fellow)
void	onMemberMuted(ChatRoom chatRoom, User operator, Set members, String reason)
void	onMemberUnmuted(ChatRoom chatRoom, User operator, Set members, String reason)
void	onUserInfoSet(ChatRoom chatRoom, User user, Map<String, String> infoMap)

• ChatService.MessageListener

Public Callback Function	Function Name
void	beforeSendingMessage( Message message)
void	afterSendingMessage(Message message)
void	beforeReceivingMessage(Message message)
void	afterReceivingMessage(Message message)

Callback Details

HMR.StateListener

StateListener.onUpdateHummerState

void onUpdateHummerState(State fromState, State toState)

Callback of Hummer SDK status changes

Parameters

Parameter	Description
fromState	Pre-change status. See details in HMR.State.
toState	Current status

---

HMR.TokenInvalidListener

TokenInvalidListener.onHummerTokenInvalid

void onHummerTokenInvalid(TokenInvalidCode code, String desc)

Notification of invalid authentication token

Parameters

Parameter	Description
code	An invalid type. See details in HMR.TokenInvalidCode.
desc	Invalidation reasons

---

HMR.TokenInvalidCode

public enum TokenInvalidCode {
    EXPIRED(1);
}

Token invalid type

Bit operation	Description
EXPIRED(1)	Expired

---

ChannelStateService.ChannelStateListener

ChannelStateListener.onUpdateChannelState

void onUpdateChannelState(ChannelState fromState, ChannelState toState);

Notification of change in SDK connection status

Parameters

Parameter	Description
fromState	Pre-change status. See details in ChannelState.
toState	Current status

---

ChatRoomService.ChatRoomListener

ChatRoomListener.onChatRoomDismissed

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

Callback notification upon chatroom closure

Note:

• Call dismissChatRoom to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
member	An administrator closing the chatroom

---

ChatRoomListener.onBasicInfoChanged

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

Callback of changes to basic chatroom information

Note:

• Call changeBasicInfo to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
propInfo	A changed key-value pair. See BasicInfoType for reference enumeration of key values.

---

ChatRoomService.MemberListener

MemberListener.onMemberJoined

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

Callback of members joining the chatroomm

Note:

• Call joinChatRoom to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
members	Members joining the chatroom

---

MemberListener.onMemberLeaved

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

Callback of members exiting the chatroom

Note:

• Call leaveChatRoom to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
members	Members exiting the chatroom
type	Operation types for exiting the chatroom 0: LEAVING, 1: DISCONNECTED
reason	Reasons for exiting the chatroom

---

MemberListener.onMemberCountChanged

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

Callback of changes to chatroom member count

Note:

• Call joinChatRoom and leaveChatRoom to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
count	A changed count

---

MemberListener.onMemberKicked

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

Callback of chatroom members removal

Note:

• Call kick perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
admin	An administrator executing member removal
members	Members removed from channel
reason	Reasons for member removal

---

MemberListener.onRoleAdded

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

Callback of role adding to chatroom members

Note:

• Call addRole to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
role	An added role
admin	An administrator adding a role
fellow	Member to whom role was added

---

MemberListener.onRoleRemoved

void onRoleRemoved(@NonNull ChatRoom chatRooA request context object, callback pass-through to extract context from listenerm,
                   @NonNull String role,
                   @NonNull User admin,
                   @NonNull User fellow);

Callback of role removal from chatroom members

Note:

• Call removeRole to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
role	A removed role
admin	An administrator removing a role
fellow	Member from whom role was removed

---

MemberListener.onMemberMuted

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

Callback of chatroom member muted

Note:

• Call muteMember to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
operator	An administrator for muting
members	Muted members
reason	Reason for muting

---

MemberListener.onMemberUnmuted

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

Callback of chatroom members unmuted

Note:

• Call unmuteMember to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
operator	An administrator for unmuting
members	Unmuted members
reason	Reason

---

MemberListener.onUserInfoSet

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

Callback of setting information of a chatroom member

Note:

• Call setUserInfo to perform callback.

Parameters

Parameter	Description
chatRoom	Chatroom ID
user	The user whose information changed
infoMap	Set user information

---

ChatService.MessageListener

MessageListener.beforeSendingMessage

void beforeSendingMessage(@NonNull Message message);

This callback precedes your calling ChatService.send(Message, HMR.Completion) to send a message.

It is commonly used to add the message to a session rendering interface before sending or to store the message in a database.

Parameters

Parameter	Description
message	Message sent

MessageListener.afterSendingMessage

void afterSendingMessage(@NonNull Message message);

This callback occurs after you call ChatService.send(Message, HMR.Completion) to send a message (regardless of message sending success or failure).

Parameters

Parameter	Description
message	Message sent

MessageListener.beforeReceivingMessage

void beforeReceivingMessage(@NonNull Message message);

Perform this callback before message receiving and processing.

Parameters

Parameter	Description
message	Message received

MessageListener.afterReceivingMessage

void afterReceivingMessage(@NonNull Message message);

Callback will be performed by this method when a new message is received.

Parameters

Parameter	Description
message	Message received