Added in API level 30

NetworkRegistrationInfo


class NetworkRegistrationInfo : Parcelable
kotlin.Any
   ↳ android.telephony.NetworkRegistrationInfo

Description of a mobile network registration info

Summary

Constants
static Int

Circuit switched domain

static Int

Applicable to both CS and PS Domain

static Int

Packet switched domain

static Int

Unknown / Unspecified domain

static Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) and also connected to at least one 5G cell as a secondary serving cell.

static Int

The device isn't camped on an LTE cell or the LTE cell doesn't support E-UTRA-NR Dual Connectivity(EN-DC).

static Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) and both the use of dual connectivity with NR(DCNR) is not restricted and NR is supported by the selected PLMN.

static Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) but either the use of dual connectivity with NR(DCNR) is restricted or NR is not supported by the selected PLMN.

static Int

Data service

static Int

Emergency service

static Int

MMS service

static Int

SMS service

static Int

Unknown service

static Int

Video service

static Int

Voice service

Inherited constants
Public methods
Int

Boolean
equals(other: Any?)

Indicates whether some other object is "equal to" this one.

Int

MutableList<Int!>

CellIdentity?

Require android.Manifest.permission#ACCESS_FINE_LOCATION, otherwise return null.

Int

String?

Get the PLMN-ID for this Network Registration, also known as the RPLMN.

Int

Get the 3GPP/3GPP2 reason code indicating why registration failed.

Int

Int

Boolean

Boolean

Boolean

Boolean

Get whether the network is a non-terrestrial network.

Boolean

Boolean

Boolean

String

Returns a string representation of the object.

Properties
static Parcelable.Creator<NetworkRegistrationInfo!>

Constants

DOMAIN_CS

Added in API level 30
static val DOMAIN_CS: Int

Circuit switched domain

Value: 1

DOMAIN_CS_PS

Added in API level 30
static val DOMAIN_CS_PS: Int

Applicable to both CS and PS Domain

Value: 3

DOMAIN_PS

Added in API level 30
static val DOMAIN_PS: Int

Packet switched domain

Value: 2

DOMAIN_UNKNOWN

Added in API level 30
static val DOMAIN_UNKNOWN: Int

Unknown / Unspecified domain

Value: 0

NR_STATE_CONNECTED

Added in API level 30
static val NR_STATE_CONNECTED: Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) and also connected to at least one 5G cell as a secondary serving cell.

Value: 3

NR_STATE_NONE

Added in API level 30
static val NR_STATE_NONE: Int

The device isn't camped on an LTE cell or the LTE cell doesn't support E-UTRA-NR Dual Connectivity(EN-DC).

Value: 0

NR_STATE_NOT_RESTRICTED

Added in API level 30
static val NR_STATE_NOT_RESTRICTED: Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) and both the use of dual connectivity with NR(DCNR) is not restricted and NR is supported by the selected PLMN.

Value: 2

NR_STATE_RESTRICTED

Added in API level 30
static val NR_STATE_RESTRICTED: Int

The device is camped on an LTE cell that supports E-UTRA-NR Dual Connectivity(EN-DC) but either the use of dual connectivity with NR(DCNR) is restricted or NR is not supported by the selected PLMN.

Value: 1

SERVICE_TYPE_DATA

Added in API level 30
static val SERVICE_TYPE_DATA: Int

Data service

Value: 2

SERVICE_TYPE_EMERGENCY

Added in API level 30
static val SERVICE_TYPE_EMERGENCY: Int

Emergency service

Value: 5

SERVICE_TYPE_MMS

Added in API level 35
static val SERVICE_TYPE_MMS: Int

MMS service

Value: 6

SERVICE_TYPE_SMS

Added in API level 30
static val SERVICE_TYPE_SMS: Int

SMS service

Value: 3

SERVICE_TYPE_UNKNOWN

Added in API level 30
static val SERVICE_TYPE_UNKNOWN: Int

Unknown service

Value: 0

SERVICE_TYPE_VIDEO

Added in API level 30
static val SERVICE_TYPE_VIDEO: Int

Video service

Value: 4

SERVICE_TYPE_VOICE

Added in API level 30
static val SERVICE_TYPE_VOICE: Int

Voice service

Value: 1

Public methods

describeContents

Added in API level 30
fun describeContents(): Int
Return
Int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR

equals

Added in API level 30
fun equals(other: Any?): Boolean

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters
obj the reference object with which to compare.
o This value may be null.
Return
Boolean true if this object is the same as the obj argument; false otherwise.

getCellIdentity

Added in API level 30
fun getCellIdentity(): CellIdentity?

Require android.Manifest.permission#ACCESS_FINE_LOCATION, otherwise return null.

Return
CellIdentity? The cell information.

getRegisteredPlmn

Added in API level 30
fun getRegisteredPlmn(): String?

Get the PLMN-ID for this Network Registration, also known as the RPLMN.

If the device is registered, this will return the registered PLMN-ID. If registration has failed, then this will return the PLMN ID of the last attempted registration. If the device is not registered, or if is registered to a non-3GPP radio technology, then this will return null.

See 3GPP TS 23.122 for further information about the Registered PLMN.

Return
String? the registered PLMN-ID or null.

getRejectCause

Added in API level 35
fun getRejectCause(): Int

Get the 3GPP/3GPP2 reason code indicating why registration failed. Returns the reason code for non-transient registration failures. Typically this method will only return the last reason code received during a network selection procedure. The reason code is system-specific; however, the reason codes for both 3GPP and 3GPP2 systems are largely equivalent across generations.

Return
Int registration reject cause if available, otherwise 0. Depending on getAccessNetworkTechnology, the values are defined in 3GPP TS 24.008 10.5.3.6 for WCDMA/UMTS, 3GPP TS 24.301 9.9.3.9 for LTE/EPS, 3GPP 24.501 Annex A for NR/5GS, or 3GPP2 A.S0001 6.2.2.44 for CDMA.

getTransportType

Added in API level 30
fun getTransportType(): Int
Return
Int The transport type. Value is android.telephony.AccessNetworkConstants.TRANSPORT_TYPE_INVALID, android.telephony.AccessNetworkConstants#TRANSPORT_TYPE_WWAN, or android.telephony.AccessNetworkConstants#TRANSPORT_TYPE_WLAN

hashCode

Added in API level 30
fun hashCode(): Int
Return
Int a hash code value for this object.

isNetworkRegistered

Added in API level 34
fun isNetworkRegistered(): Boolean
Return
Boolean true if registered on roaming or home network, false otherwise. (This value is not affected by any carrier config or resource overlay override).

isNetworkRoaming

Added in API level 34
fun isNetworkRoaming(): Boolean
Return
Boolean true if registered on roaming network. (This value is not affected by any carrier config or resource overlay override).

isNetworkSearching

Added in API level 34
fun isNetworkSearching(): Boolean
Return
Boolean true if searching for service, false otherwise. (This value is not affected by any carrier config or resource overlay override).

isNonTerrestrialNetwork

Added in API level 35
fun isNonTerrestrialNetwork(): Boolean

Get whether the network is a non-terrestrial network.

Return
Boolean true if network is a non-terrestrial network else false.

isRegistered

Added in API level 30
Deprecated in API level 34
fun isRegistered(): Boolean

Deprecated: Use isNetworkRegistered, which is not affected by any carrier config or resource overlay, instead.

Return
Boolean true if registered on roaming or home network. Note this value can be affected by the carrier config override.

isRoaming

Added in API level 30
Deprecated in API level 34
fun isRoaming(): Boolean

Deprecated: Use TelephonyDisplayInfo#isRoaming instead.

Return
Boolean true if registered on roaming network overridden by config. Note this value can be affected by the carrier config override.

isSearching

Added in API level 30
Deprecated in API level 34
fun isSearching(): Boolean

Deprecated: Use isNetworkRegistered, which is not affected by any carrier config or resource overlay, instead.

Return
Boolean true if searching for service, false otherwise.

toString

Added in API level 30
fun toString(): String

Returns a string representation of the object.

Return
String This value cannot be null.

Properties

CREATOR

Added in API level 30
static val CREATOR: Parcelable.Creator<NetworkRegistrationInfo!>