-
public interface Call.ListenerCall.Listener interface defines a set of callbacks for events related to call.
-
-
Method Summary
Modifier and Type Method Description abstract voidonConnectFailure(@NonNull() Call call, @NonNull() CallException callException)The call failed to connect. abstract voidonRinging(@NonNull() Call call)Emitted once before the onConnected callback. abstract voidonConnected(@NonNull() Call call)The call has connected. abstract voidonReconnecting(@NonNull() Call call, @NonNull() CallException callException)The call starts reconnecting. abstract voidonReconnected(@NonNull() Call call)The call is reconnected. abstract voidonDisconnected(@NonNull() Call call, @Nullable() CallException callException)The call was disconnected. voidonCallQualityWarningsChanged(@NonNull() Call call, @NonNull() Set<Call.CallQualityWarning> currentWarnings, @NonNull() Set<Call.CallQualityWarning> previousWarnings)Emitted when network quality warnings have changed for the Call. -
-
Method Detail
-
onConnectFailure
abstract void onConnectFailure(@NonNull() Call call, @NonNull() CallException callException)
The call failed to connect.
Calls that fail to connect will result in onConnectFailure and always return a CallException providing more informationabout what failure occurred.
- Parameters:
call- An object model representing a call that failed to connect.callException- CallException that describes why the connect failed.
-
onRinging
abstract void onRinging(@NonNull() Call call)
Emitted once before the onConnected callback. If
{@code * answerOnBridge}is true, this represents the callee being alerted of a call.The getSid is now available.
- Parameters:
call- An object model representing a call.
-
onConnected
abstract void onConnected(@NonNull() Call call)
The call has connected.
- Parameters:
call- An object model representing a call.
-
onReconnecting
abstract void onReconnecting(@NonNull() Call call, @NonNull() CallException callException)
The call starts reconnecting.
Reconnect is triggered when a network change is detected and Call is already in state. If the call is in CONNECTING or in when network change happened the SDK will continue attempting toconnect, but a reconnect event will not be raised.
- Parameters:
call- An object model representing a call.callException- CallException that describes the reconnect reason.
-
onReconnected
abstract void onReconnected(@NonNull() Call call)
The call is reconnected.
- Parameters:
call- An object model representing a call.
-
onDisconnected
abstract void onDisconnected(@NonNull() Call call, @Nullable() CallException callException)
The call was disconnected.
A call can be disconnected for the following reasons:
- A user calls `disconnect()` on the `Call` object.
- The other party disconnects or terminates the call.
- An error occurs on the client or the server that terminates the call.
If the call ends due to an error the `CallException` is non-null. If the call endsnormally `CallException` is null.
- Parameters:
call- An object model representing a call.callException- CallException that caused the call to disconnect.
-
onCallQualityWarningsChanged
void onCallQualityWarningsChanged(@NonNull() Call call, @NonNull() Set<Call.CallQualityWarning> currentWarnings, @NonNull() Set<Call.CallQualityWarning> previousWarnings)
Emitted when network quality warnings have changed for the Call.
The trigger conditions for the CallQualityWarnings are defined as below:
- WARN_HIGH_RTT - Round Trip Time (RTT) > 400 ms for 3out of last 5 samples.
- WARN_HIGH_JITTER - Jitter > 30 ms for 3 out of last 5samples.
- WARN_HIGH_PACKET_LOSS - Packet loss > 1% in 3 out oflast 5 samples.
- WARN_LOW_MOS - Mean Opinion Score (MOS) < 3.5 for 3out of last 5 samples.
- WARN_CONSTANT_AUDIO_IN_LEVEL ` - Audio input level isunchanged for 10 seconds and call is not in muted state.
-
-
-
-