RegistrationFailedListener
interface RegistrationFailedListener
android.telephony.TelephonyCallback.RegistrationFailedListener |
Interface for registration failures listener.
Summary
Public methods | |
---|---|
abstract Unit |
onRegistrationFailed(cellIdentity: CellIdentity, chosenPlmn: String, domain: Int, causeCode: Int, additionalCauseCode: Int) Report that Registration or a Location/Routing/Tracking Area update has failed. |
Public methods
onRegistrationFailed
abstract fun onRegistrationFailed(
cellIdentity: CellIdentity,
chosenPlmn: String,
domain: Int,
causeCode: Int,
additionalCauseCode: Int
): Unit
Report that Registration or a Location/Routing/Tracking Area update has failed.
Indicate whenever a registration procedure, including a location, routing, or tracking area update fails. This includes procedures that do not necessarily result in a change of the modem's registration status. If the modem's registration status changes, that is reflected in the onNetworkStateChanged() and subsequent get{Voice/Data}RegistrationState().
Because registration failures are ephemeral, this callback is not sticky. Registrants will not receive the most recent past value when registering. The calling app should have carrier privileges (see TelephonyManager#hasCarrierPrivileges
) if it does not have the android.Manifest.permission#READ_PRECISE_PHONE_STATE
and android.Manifest.permission#ACCESS_FINE_LOCATION
. If the calling app doesn't have android.Manifest.permission#ACCESS_FINE_LOCATION
, it will receive CellIdentity
without location-sensitive information included.
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE
and android.Manifest.permission#ACCESS_FINE_LOCATION
Parameters | |
---|---|
cellIdentity |
CellIdentity: the CellIdentity, which must include the globally unique identifier for the cell (for example, all components of the CGI or ECGI). This value cannot be null . |
chosenPlmn |
String: a 5 or 6 digit alphanumeric PLMN (MCC|MNC) among those broadcast by the cell that was chosen for the failed registration attempt. This value cannot be null . |
domain |
Int: DOMAIN_CS, DOMAIN_PS or both in case of a combined procedure. Value is android.telephony.NetworkRegistrationInfo#DOMAIN_UNKNOWN , android.telephony.NetworkRegistrationInfo#DOMAIN_CS , android.telephony.NetworkRegistrationInfo#DOMAIN_PS , or android.telephony.NetworkRegistrationInfo#DOMAIN_CS_PS |
causeCode |
Int: the primary failure cause code of the procedure. For GSM/UMTS (MM), values are in TS 24.008 Sec 10.5.95 For GSM/UMTS (GMM), values are in TS 24.008 Sec 10.5.147 For LTE (EMM), cause codes are TS 24.301 Sec 9.9.3.9 For NR (5GMM), cause codes are TS 24.501 Sec 9.11.3.2 Integer.MAX_VALUE if this value is unused. |
additionalCauseCode |
Int: the cause code of any secondary/combined procedure if appropriate. For UMTS, if a combined attach succeeds for PS only, then the GMM cause code shall be included as an additionalCauseCode. For LTE (ESM), cause codes are in TS 24.301 9.9.4.4. Integer.MAX_VALUE if this value is unused. |