Added in API level 29

GroupCallCallback

public interface GroupCallCallback

android.telephony.mbms.GroupCallCallback


A callback class for use when the application is in a group call. The middleware will provide updates on the status of the call via this callback.

Summary

Constants

int SIGNAL_STRENGTH_UNAVAILABLE

Indicates broadcast signal strength is not available for this call.

Public methods

default void onBroadcastSignalStrengthUpdated(int signalStrength)

Broadcast Signal Strength updated.

default void onError(int errorCode, String message)

Called by the middleware when it has detected an error condition in this group call.

default void onGroupCallStateChanged(int state, int reason)

Called to indicate this call has changed state.

Constants

SIGNAL_STRENGTH_UNAVAILABLE

Added in API level 29
public static final int SIGNAL_STRENGTH_UNAVAILABLE

Indicates broadcast signal strength is not available for this call. This may be due to the call no longer being available due to geography or timing (end of service)

Constant Value: -1 (0xffffffff)

Public methods

onBroadcastSignalStrengthUpdated

Added in API level 29
public void onBroadcastSignalStrengthUpdated (int signalStrength)

Broadcast Signal Strength updated. This signal strength is the BROADCAST signal strength which, depending on technology in play and it's deployment, may be stronger or weaker than the traditional UNICAST signal strength. It a simple int from 0-4 for valid levels or SIGNAL_STRENGTH_UNAVAILABLE if broadcast is not available for this call due to timing, geography or popularity.

Parameters
signalStrength int: Value is between -1 and 4 inclusive

onError

Added in API level 29
public void onError (int errorCode, 
                String message)

Called by the middleware when it has detected an error condition in this group call. The possible error codes are listed in MbmsErrors.

Parameters
errorCode int: The error code. Value is MbmsErrors.ERROR_NO_UNIQUE_MIDDLEWARE, MbmsErrors.ERROR_MIDDLEWARE_LOST, MbmsErrors.ERROR_MIDDLEWARE_NOT_BOUND, MbmsErrors.GeneralErrors.ERROR_MIDDLEWARE_NOT_YET_READY, MbmsErrors.GeneralErrors.ERROR_OUT_OF_MEMORY, MbmsErrors.GeneralErrors.ERROR_MIDDLEWARE_TEMPORARILY_UNAVAILABLE, MbmsErrors.GeneralErrors.ERROR_IN_E911, MbmsErrors.GeneralErrors.ERROR_NOT_CONNECTED_TO_HOME_CARRIER_LTE, MbmsErrors.GeneralErrors.ERROR_UNABLE_TO_READ_SIM, or MbmsErrors.GeneralErrors.ERROR_CARRIER_CHANGE_NOT_ALLOWED

message String: A human-readable message generated by the middleware for debugging purposes. This value may be null.