MQTTchat SDKs
MQTTchat Cloud Web
Chat events
Events Litener.
Interaction with library is possible essentially through three listeners:
MqttChatListener, MqttChatUiListener and MqttChatFCMListener. MqttChatListener and MqttChatUiListener events : are called when application is in foreground or is still in task list.MqttChatFCMListener events : are called by google play firebase services when application is closed and FCM feature is activated. Click here to see how to activate FCM in Mqttchat android library.MQTTChat listener
Is used to get all MQTT chat events :
1
MqttChatListener listener= new MqttChatListener() {
2
3
@Override
4
public void onLoadComplete() {
5
Log.i(Tag,"MQTT Chat load complete");
6
}
7
8
@Override
9
public void onUserPresenceUpdate(int i, String s, boolean b, boolean b1, String s1) {
10
Log.i(Tag,"User presence update : userId:"+i +"; new status:"+s+" ;voice capacity:"+b +" ;video capacity:"+b1+"; timestamp:"+s1);
11
}
12
13
@Override
14
public void onSendMessage(int i, Message message) {
15
Log.i(Tag,"Logged user send message to userId :"+i +"; message:"+message.toString());
16
}
17
18
@Override
19
public void onAckMessage(int i, Ack ack, Message message) {
20
Log.i(Tag,"Logged user received Ack from server for message sent to userId :"+i +"; ack :"+ack.toString()+"; message:"+message.toString());
21
}
22
23
@Override
24
public void onRejectMessage(int i, String s, Message message) {
25
Log.i(Tag,"Logged user has sent message to userId:"+i+"; message was rejected by server because of :"+s+"; and message content :"+message.toString());
26
}
27
28
@Override
29
public void onIncomingMessage(int i, Message message) {
30
Log.i(Tag,"Logged user received new message from userId:"+i+"; message content:"+message.toString());
31
}
32
33
@Override
34
void onReceiveNotification(Notification notification){
35
Log.i(Tag,"Logged user received MQTT chat notification:"+notification.toString());
36
}
37
38
@Override
39
public void onUserTyping(int i, boolean b) {
40
Log.i(Tag,"A user userId:"+i+" is currently typing to logged user; is typing :"+b);
41
}
42
43
@Override
44
public void onReadingMessage(int i, int i1, String s) {
45
Log.i(Tag,"A user userId:"+i+"; is reading message id:"+i1+" ; reading date :"+s);
46
}
47
48
@Override
49
public void onNotReadMessagesCountUpdate(int i) {
50
Log.i(Tag,"Number of unread messages is changed for logged user, new number is :"+i);
51
}
52
53
54
@Override
55
public void onError(int i, String s) {
56
Log.e(Tag,"MQTTCHAT error code :"+i+";message :"+s);
57
}
58
};
Copied!
To add
listener to MQTT chat:1
MqttChat.getInstance().addMqttchatListener(listener);
Copied!
And to remove
listener :1
MqttChat.getInstance().removeMqttchatListener(listener);
Copied!
You can add many listeners in differents activities or fragments. So you can catch events where you need.
void onLoadComplete();
When chat is completely loaded.
void onUserPresenceUpdate(int userId, String status, boolean audioCap, boolean videoCAP, String timestamp);
When a contact in contacts list or friend user in friends list has changed status.
void onSendMessage(int toUserId, Message message);
When logged user send a message.
void onAckMessage(int toUserId, Ack ack,Message message);
When ACK is received from server. that mean that the message is successfully sent and will be delivered.
void onRejectMessage(int toUserId,String why,Message message);
When message is rejected from server. because user is locked by toUserid user.
void onIncomingMessage(int fromUserId,Message message);
When logged user receive new message.
void onReceiveNotification(Notification notification);
When logged user receive new Notification.
void onUserTyping(int fromUserId,boolean on);
When a contact or friend is typing.
void onReadingMessage(int fromUserId,int messageId,String readDate);
When a contact or friend read a sent message.
void onNotReadMessagesCountUpdate(int n);
When a number or unreaded message change.
void onError(int code,String error);
When error occured.
MqttChat UI listener
MqttChat UI listenerIs used to get events performed by users on the main chat UI.
1
MqttChatUiListener listener= new MqttChatUiListener() {
2
3
@Override
4
public void onRemoveFriendSuccess(int i) {
5
Log.i(Tag,"user has removed friend with userId:"+i);
6
}
7
8
@Override
9
public void onRemoveFriendFail(int i, String s) {
10
Log.e(Tag,"an error "+s+" has occured when user try to remove friend with userId:"+i);
11
}
12
13
@Override
14
public void onLockUserSuccess(int i) {
15
Log.i(Tag,"user has locked user with userId:"+i);
16
}
17
18
@Override
19
public void onLockUserFail(int i, String s) {
20
Log.e(Tag,"an error "+s+" has occured when user try to lock user with userId:"+i);
21
}
22
23
@Override
24
public void onUnLockUserSuccess(int i) {
25
Log.i(Tag,"user has unlocked user with userId:"+i);
26
}
27
28
@Override
29
public void onUnLockUserFail(int i, String s) {
30
Log.e(Tag,"an error "+s+" has occured when user try to unlock user with userId:"+i);
31
}
32
33
@Override
34
public void onDeleteConversationSuccess(int i) {
35
Log.i(Tag,"user has deleted conversation with user having userId:"+i);
36
}
37
38
@Override
39
public void onDeleteConversationFail(int i, String s) {
40
Log.e(Tag,"an error "+s+" has occured when user try to remove conversation with user having userId:"+i);
41
}
42
43
}
44
Copied!
To add
listener to MQTT chat:1
MqttChat.getInstance().addMqttchatUiListener(listener);
Copied!
And to remove
listener :1
MqttChat.getInstance().removeMqttchatUiListener(listener);
Copied!
MQTTChat FCM listener
Two types of FCM events are provided by the listener: events following an MQTT Chat notification received. Or else an FCM notification message received by FCM service that can be sent by your server or another library.
1
MqttChat.getInstance().addMqttchatFCMListener(new MqttChatFCMListener() {
2
@Override
3
public void onReceiveFCMNotification(boolean notificationsSettingEnabled, int toUserId, Notification notification) {
4
5
}
6
7
@Override
8
public void onReceiveOtherFCMData(com.google.firebase.messaging.RemoteMessage message) {
9
10
}
11
});
12
Copied!
Event
Description
void onReceiveFCMNotification(boolean notificationsSettingEnabled, int toUserId, Notification notification);
When MQTT Chat server send notification to FCM. That means logged user received a notification when application is closed.
void onReceiveOtherFCMData(RemoteMessage message);
When an FCM notification message not sent by MQTT Chat is received by FCM service and then delivered to you through this event.
For more details about MQTT advanced notifications management in android library please see this section.
Last modified 1mo ago
Copy link