Added in API level 29

GroupCallCallback

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
static Int

Indicates broadcast signal strength is not available for this call.
Public methods
open Unit

Broadcast Signal Strength updated.
open Unit
onError(errorCode: Int, message: String?)

Called by the middleware when it has detected an error condition in this group call.
open Unit
onGroupCallStateChanged(state: Int, reason: Int)

Called to indicate this call has changed state.

Constants

SIGNAL_STRENGTH_UNAVAILABLE

Added in API level 29
static val SIGNAL_STRENGTH_UNAVAILABLE: Int

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)

Value: -1

Public methods

onBroadcastSignalStrengthUpdated

Added in API level 29
open fun onBroadcastSignalStrengthUpdated(signalStrength: Int): Unit

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
open fun onError(
    errorCode: Int, 
    message: String?
): Unit

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 android.telephony.mbms.MbmsErrors#ERROR_NO_UNIQUE_MIDDLEWARE, android.telephony.mbms.MbmsErrors#ERROR_MIDDLEWARE_LOST, android.telephony.mbms.MbmsErrors#ERROR_MIDDLEWARE_NOT_BOUND, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_MIDDLEWARE_NOT_YET_READY, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_OUT_OF_MEMORY, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_MIDDLEWARE_TEMPORARILY_UNAVAILABLE, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_IN_E911, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_NOT_CONNECTED_TO_HOME_CARRIER_LTE, android.telephony.mbms.MbmsErrors.GeneralErrors#ERROR_UNABLE_TO_READ_SIM, or android.telephony.mbms.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.

onGroupCallStateChanged

Added in API level 29
open fun onGroupCallStateChanged(
    state: Int, 
    reason: Int
): Unit

Called to indicate this call has changed state. See GroupCall.STATE_STOPPED, GroupCall.STATE_STARTED and GroupCall.STATE_STALLED.

Parameters
state Int: Value is android.telephony.mbms.GroupCall#STATE_STOPPED, android.telephony.mbms.GroupCall#STATE_STARTED, or android.telephony.mbms.GroupCall#STATE_STALLED
reason Int: Value is android.telephony.mbms.GroupCall#REASON_BY_USER_REQUEST, android.telephony.mbms.GroupCall#REASON_FREQUENCY_CONFLICT, android.telephony.mbms.GroupCall#REASON_OUT_OF_MEMORY, android.telephony.mbms.GroupCall#REASON_NOT_CONNECTED_TO_HOMECARRIER_LTE, android.telephony.mbms.GroupCall#REASON_LEFT_MBMS_BROADCAST_AREA, or android.telephony.mbms.GroupCall#REASON_NONE