Callback listeners
Add all following callback methods while initializing the SDK. Callback listeners are functions that will be called whenever the specified event happens.
#
Example RequestNote: Callback Listener name should be the same as described below.
#
Connection ListenerHandles Connection Status, triggered whenever connection status changes.
Sample Response:
Possible Status:
Status | Description |
---|---|
CONNECTED | Connection Established |
DISCONNECTED | Disconnected |
CONNECTIONTIMEOUT | Connection Timeout |
CONNECTIONFAILED | Connection Failed |
AUTHENTICATIONFAILED | Authentication Failed |
ERROROCCURED | Error |
#
Presence ListenerHandles Presence Status of Friends, triggered whenever users online/offline status changes.
Sample Response:
#
FriendsList ListenerHandles Friends List (Contacts) Stanzas, triggered when Get Friends method called. Receives an array of object values.
Sample Response:
#
User Profile ListenerHandles User Profile Stanzas, used to get the profile detail of the user. Triggered when Get User Profile method called. Receives object values.
Sample Response:
#
Message ListenerHandles Message Stanzas, triggered whenever new message related events are received in single/group chat.
#
Receive MessageHandles when new message received.
Sample Response for Single Chat:
Sample Response for Group Chat:
For group, message status will be updated only if all the participants sent the delivery/seen status.
#
AcknowledgementAn acknowledgement will be sent from the server whenever you sent a message stanzas to the server. For example, when you sent a delivery status to the message that you received, you will get an acknowledgment from the same.
Sample Response:
#
Delivered StatusHandles delivery status received from receipient user.
#
Seen StatusHandles seen status received from receipient user.
#
Typing/Gone StatusReceived when user starts/stops typing text message.
Sample Response:
#
Deleted MessageReceived when message is delete (Delete For Me).
Received when message is delete (Delete For Everyone).
#
Clear/Delete ChatReceived when clear/delete chat method is called.
#
Clear/Delete All ChatReceived when clear all/delete all chat method is called.
#
Delete Group ChatReceived when delete group method is called.
#
LogoutWhen user tries to log in with another device using same credentials, then the 1st user receives logout message. (In order to logout the user).
Note: This is applicable for Same resource (Web) only. User can log in simultaneously with Web and Mobile.
#
Carbon MessagesWhen user is connected to more than one device, Mobile
and Web
resources. In order to keep all messages upto date, carbon messsages are used. If the target user is online with multiple resources when the original message is sent, the device with highest priority receives the message and sends a carbon message to other resources. By default carbon will be enabled when SDK
is initialized
Carbon Receive Message Sample Response:
Carbon Sent Acknowledgment Sample Response:
Carbon Typing/Gone Status Sample Response:
Carbon Delivered Sample Response:
Carbon Seen Sample Response:
Carbon Sent Message Sample Response:
Carbon Clear/Delete Message Sample Response:
Carbon Clear/Delete All Sample Response:
Carbon Delete Message Sample Response: (Delete For Me)
Carbon Delete Message Sample Response: (Delete For Everyone)
Carbon Group Delete Sample Response:
Carbon SentSeen Sample Response:
Carbon SentRecall Sample Response:
#
Reply Message ListenerHandles Reply Message IQs, triggered when Get Reply Message method called. Receives an array of object values.
Sample Response:
#
Favourite Message ListenerHandles Favourites Message lists, triggered when favourites status updated. Receives an array of object values.
Sample Response:
#
Group Profile ListenerHandles Group Profile Listener, triggered when group activities are requested/updated.
#
Group Message Info ListenerHandles Group Msg Info Listener, triggered when get group message info method triggered.
#
New Participant AddedWhenever new participant is added to group, groupProfileListener callback will be triggered and the following response will be received.
Sample Response:
#
Group Profile UpdatedHandles Group Profile Data Stanzas, triggered when Set Group Profile method called or new group created. Receives an object values.
Sample Response:
#
Participant RemovedWhenever new participant is removed from group, groupProfileListener callback will be triggered and the following response will be received.
Same response will be handled for Exit Group method as well.
Sample Response:
#
Make AdminReceived when an member becomes admin of the group.
Sample Response:
#
Group DeletedReceived when an user deletes the group.
Sample Response:
#
Media Upload ListenerHandles Media Message upload progress, triggered when media message is sent. Receives an object values.
Also handles the cancel request. Whenever you would like to cancel upload of a media message, you can use source.cancel()
method to cancel the media content upload. Each cancel source is unique mapped to message id.
Sample Response:
#
Block User ListenerHandles User Block/Unblock Status, when user connected with 2 resource if one of the resource blocking/unblocking the user, other resource will be notified with this event.
Sample Response:
#
Single Message Data ListenerHandles User Block/Unblock Status, when user connected with 2 resource if one of the resource blocking/unblocking the user, other resource will be notified with this event.
#
Mute Chat ListenerHandles Chat Mute Status, triggered when the particular single/group chat is muted/unmuted.
Sample Response:
#
Archive Chat ListenerHandles Chat Archive Status, triggered when the particular single/group chat is archived/unarchived.
Sample Response:
#
User Deleted ListenerHandles User Deleted Status, triggered when the particular user deleted his/her account.
#
Admin User/Group Block/Unblock ListenerThis feature is used to get the users/groups admin blocked status. So that you can check the user/group avail status and communicate them.
Sample Response:
#
Own User Blocked/UnblockedThe block/unblock status of own user (Logged In) by Admin will be received, so that you can navigate the user to show stopper screen. Once user blocked by admin, they cannot use the application.
#
Contact User Blocked/UnblockedThe block/unblock status of other user by Admin will be received, so that you can show the status as user not available. And you cannot send messages to the blocked users.
#
Group Chat Blocked/UnblockedThe block/unblock status of group chat by Admin will be received, so that you will be notified the group profile status. So that we cannot restrict the access to the group.