Handling call events

Listening to the call events

In order to listen to the call events you need to set listener to the call sdk using the below method

Argument	Type	Description
CALLBACK	CallEventsListener	listener to observe all the call events

Java

CallManager.setCallEventsListener(new CallEventsListener() {

@Override

public void onCallStatusUpdated(@NonNull String callStatus, @NonNull String userJid) {

}

@Override

public void onCallAction(@NonNull String callAction, @NonNull String userJid) {

}

@Override

public void onVideoTrackAdded(@NonNull String userJid) {

}

@Override

public void onMuteStatusUpdated(@NonNull String muteEvent, @NonNull String userJid) {

}

@Override

public void onUserSpeaking(@NonNull String userJid, int audioLevel) {

}

@Override

public void onUserStoppedSpeaking(@NonNull String userJid) {

}

@Override

public void onLocalVideoTrackAdded() {

}

});

Kotlin

CallManager.setCallEventsListener(object :CallEventsListener{

override fun onCallStatusUpdated(callStatus: String, userJid: String) {

TODO("Not yet implemented")

}

override fun onCallAction(callAction: String, userJid: String) {

TODO("Not yet implemented")

}

override fun onVideoTrackAdded(userJid: String) {

TODO("Not yet implemented")

}

override fun onMuteStatusUpdated(muteEvent: String, userJid: String) {

TODO("Not yet implemented")

}

override fun onUserSpeaking(userJid: String, audioLevel: Int) {

TODO("Not yet implemented")

}

override fun onUserStoppedSpeaking(userJid: String) {

TODO("Not yet implemented")

}

override fun onLocalVideoTrackAdded() {

TODO("Not yet implemented")

}

})

})

Inorder to remove the call events listener call the method below:

Argument	Type	Description
listener	CallEventsListener	listener to observe all the call events

Java

CallManager.removeCallEventsListener(listener);

Kotlin

CallManager.removeCallEventsListener(listener)

Handling mute events

Whenever call end user mute/unmute video or audio, the below callback will be triggered.

Java

@Override

public void onMuteStatusUpdated(@NotNull String muteEvent, @NotNull String userJid) {

switch (muteEvent){

case MuteEvent.ACTION_REMOTE_VIDEO_MUTE:

break;

case MuteEvent.ACTION_REMOTE_VIDEO_UN_MUTE:

break;

case MuteEvent.ACTION_REMOTE_AUDIO_MUTE:

break;

case MuteEvent.ACTION_REMOTE_AUDIO_UN_MUTE:

break;

}

}

Kotlin

override fun onMuteStatusUpdated(muteEvent: String, userJid: String) {

when (muteEvent) {

MuteEvent.ACTION_REMOTE_VIDEO_MUTE -> {}

MuteEvent.ACTION_REMOTE_VIDEO_UN_MUTE -> {}

MuteEvent.ACTION_REMOTE_AUDIO_MUTE -> {}

MuteEvent.ACTION_REMOTE_AUDIO_UN_MUTE -> {}

}

muteEvent value will be anyone of the values of annotation class MuteEvent.

muteEvent Value	Call event
MuteEvent.ACTION_REMOTE_VIDEO_MUTE	when the remote user muted his video
MuteEvent.ACTION_REMOTE_VIDEO_UN_MUTE	when the remote user unmuted his video
MuteEvent.ACTION_REMOTE_AUDIO_MUTE	when the remote user muted his audio
MuteEvent.ACTION_REMOTE_AUDIO_UN_MUTE	when the remote user unmuted his video

Handling call status events

Whenever call status changed in video or audio call, the below callback will be triggered.

Java

@Override

public void onCallStatusUpdated(@NotNull String callStatus, @NotNull String userJid) {

}

Kotlin

override fun onCallStatusUpdated(callStatus: String, userJid: String) {

}

callStatus value will be anyone of the values of annotation class CallStatus.

callStatus Value	Call event
CallStatus.CALLING	the initial state of the call
CallStatus.CONNECTING	The current call is in connecting state
CallStatus.RINGING	the remote user is having internet and acknowledged the call
CallStatus.CONNECTED	the call is successfully connected and audio/video tracks transmission is about to start
CallStatus.DISCONNECTED	the call is disconnected and call UI can be closed
CallStatus.RECONNECTING	the call is in reconnecting state
CallStatus.RECONNECTED	the call is connected back after a reconnecting state
CallStatus.ON_HOLD	the remote user has put your call on hold, it will happedn when the remote user attended gsm call
CallStatus.ON_RESUME	the remote user has resumed your call after a on hold, it will happen when the remote user disconnected gsm call
CallStatus.OUTGOING_CALL_TIME_OUT	when we don't receive ack for the outgoing call from the remote user within 30 seconds
CallStatus.INCOMING_CALL_TIME_OUT	When we don't receive ack for the incoming call from the caller within 30 seconds
CallStatus.USER_JOINED	user is joined to the call
CallStatus.USER_LEFT	user is left from the call
CallStatus.INVITE_CALL_TIME_OUT	When we don't receive ack for the call invite from the invited user within 30 seconds

Handling call action events

Whenever call action received in video or audio call, the below callback will be triggered.

Java

@Override

public void onCallAction(@NotNull String callAction, @NotNull String userJid) {

}

Kotlin

override fun onCallAction(callAction: String, userJid: String) {

}

callAction value will be anyone of the values of annotation class CallAction.

callAction Value	Call event
CallAction.ACTION_LOCAL_HANGUP	whenever you disconnect the call, the action will be received
CallAction.ACTION_DENY_CALL	when you decline the incoming call, the action will be received for callee
CallAction.ACTION_PERMISSION_DENIED	when you attend the incoming call without required permissions, the action will be received for the callee
CallAction.ACTION_REMOTE_HANGUP	when the remote user disconnect the connected call, the action will be received for caller
CallAction.ACTION_REMOTE_ENGAGED	when the remote user is engaged in the another call, the action will be received for the caller
CallAction.ACTION_REMOTE_BUSY	when the remote user declines incoming the call, the action will be received for the caller
CallAction.ACTION_AUDIO_DEVICE_CHANGED	whenever the audio device changed in call, update the audio device UI
CallAction.ACTION_REMOTE_OTHER_BUSY	When any one of users is busy in group call
CallAction.ACTION_INVITE_USERS	When you invite users to the call, this will be triggered so that you can update your UI
CallAction.ACTION_VIDEO_CALL_CONVERSION_REJECTED	When remote user declined our video call switch request
CallAction.ACTION_VIDEO_CALL_CONVERSION_ACCEPTED	When remote user accepted our video call switch request
CallAction.ACTION_VIDEO_CALL_CANCEL_CONVERSION	When remote user cancels the video call switch request made by them
CallAction.ACTION_REMOTE_VIDEO_STATUS	When user pause/resume video in group call
CallAction.ACTION_CAMERA_SWITCH_SUCCESS	When camera switch done successfully, the action will be received
CallAction.ACTION_CAMERA_SWITCH_FAILURE	When camera switch error occurs, the action will be received
CallAction.CHANGE_TO_AUDIO_CALL	When ui needs to be changed as audio call ui this action will be received

Handling the video track events

For the video call you need to set your local surface view to the below sdk method:

Argument	Type	Description
LOCAL_VIDEO_VIEW	SurfaceViewRenderer	surface view for showing local video

Java

CallManager.getLocalProxyVideoSink().setTarget(LOCAL_VIDEO_VIEW);

Kotlin

CallManager.getLocalProxyVideoSink()?.setTarget(LOCAL_VIDEO_VIEW)

Whenever video tack is received in video call, the below callback will be triggered.

Java

@Override

public void onVideoTrackAdded(@NotNull String userJid) {

}

Kotlin

override fun onVideoTrackAdded(userJid: String) {

}

userJid value will be the end user JID who has sent the video track.

You can get the remote video sink using the code below:

Argument	Type	Description
USER_JID	String	Jid of the remote user
REMOTE_VIDEO_VIEW	SurfaceViewRenderer	surface view for showing remote user video

Java

CallManager.getRemoteProxyVideoSink(USER_JID).setTarget(REMOTE_VIDEO_VIEW);

Kotlin

CallManager.getRemoteProxyVideoSink(USER_JID)?.setTarget(REMOTE_VIDEO_VIEW)