NetworkRegistrationInfo
  public
  
  final
  
  class
  NetworkRegistrationInfo
  
    extends Object
  
  
  
  
  
      implements
      
        Parcelable
      
  
  
| java.lang.Object | |
| ↳ | android.telephony.NetworkRegistrationInfo | 
Description of a mobile network registration info
Summary
| Constants | |
|---|---|
| int | DOMAIN_CSCircuit switched domain | 
| int | DOMAIN_CS_PSApplicable to both CS and PS Domain | 
| int | DOMAIN_PSPacket switched domain | 
| int | DOMAIN_UNKNOWNUnknown / Unspecified domain | 
| int | NR_STATE_CONNECTEDThe 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. | 
| int | NR_STATE_NONEThe device isn't camped on an LTE cell or the LTE cell doesn't support E-UTRA-NR Dual Connectivity(EN-DC). | 
| int | NR_STATE_NOT_RESTRICTEDThe 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. | 
| int | NR_STATE_RESTRICTEDThe 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. | 
| int | SERVICE_TYPE_DATAData service | 
| int | SERVICE_TYPE_EMERGENCYEmergency service | 
| int | SERVICE_TYPE_MMSMMS service | 
| int | SERVICE_TYPE_SMSSMS service | 
| int | SERVICE_TYPE_UNKNOWNUnknown service | 
| int | SERVICE_TYPE_VIDEOVideo service | 
| int | SERVICE_TYPE_VOICEVoice service | 
| Inherited constants | 
|---|
| Fields | |
|---|---|
| 
    public
    static
    final
    Creator<NetworkRegistrationInfo> | CREATOR
 | 
| Public methods | |
|---|---|
| 
        
        
        
        
        
        int | 
      describeContents()
      Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. | 
| 
        
        
        
        
        
        boolean | 
      equals(Object o)
      Indicates whether some other object is "equal to" this one. | 
| 
        
        
        
        
        
        int | 
      getAccessNetworkTechnology()
       | 
| 
        
        
        
        
        
        List<Integer> | 
      getAvailableServices()
       | 
| 
        
        
        
        
        
        CellIdentity | 
      getCellIdentity()
      Require  | 
| 
        
        
        
        
        
        int | 
      getDomain()
       | 
| 
        
        
        
        
        
        String | 
      getRegisteredPlmn()
      Get the PLMN-ID for this Network Registration, also known as the RPLMN. | 
| 
        
        
        
        
        
        int | 
      getRejectCause()
      Get the 3GPP/3GPP2 reason code indicating why registration failed. | 
| 
        
        
        
        
        
        int | 
      getTransportType()
       | 
| 
        
        
        
        
        
        int | 
      hashCode()
      Returns a hash code value for the object. | 
| 
        
        
        
        
        
        boolean | 
      isNetworkRegistered()
       | 
| 
        
        
        
        
        
        boolean | 
      isNetworkRoaming()
       | 
| 
        
        
        
        
        
        boolean | 
      isNetworkSearching()
       | 
| 
        
        
        
        
        
        boolean | 
      isNonTerrestrialNetwork()
      Get whether the network is a non-terrestrial network. | 
| 
        
        
        
        
        
        boolean | 
      isRegistered()
      
      This method was deprecated
      in API level 34.
    Use  | 
| 
        
        
        
        
        
        boolean | 
      isRoaming()
      
      This method was deprecated
      in API level 34.
    Use  | 
| 
        
        
        
        
        
        boolean | 
      isSearching()
      
      This method was deprecated
      in API level 34.
    Use  | 
| 
        
        
        
        
        
        String | 
      toString()
      Returns a string representation of the object. | 
| Inherited methods | |
|---|---|
Constants
DOMAIN_CS
public static final int DOMAIN_CS
Circuit switched domain
Constant Value: 1 (0x00000001)
DOMAIN_CS_PS
public static final int DOMAIN_CS_PS
Applicable to both CS and PS Domain
Constant Value: 3 (0x00000003)
DOMAIN_PS
public static final int DOMAIN_PS
Packet switched domain
Constant Value: 2 (0x00000002)
DOMAIN_UNKNOWN
public static final int DOMAIN_UNKNOWN
Unknown / Unspecified domain
Constant Value: 0 (0x00000000)
NR_STATE_CONNECTED
public static final int NR_STATE_CONNECTED
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.
Constant Value: 3 (0x00000003)
NR_STATE_NONE
public static final int NR_STATE_NONE
The device isn't camped on an LTE cell or the LTE cell doesn't support E-UTRA-NR Dual Connectivity(EN-DC).
Constant Value: 0 (0x00000000)
NR_STATE_NOT_RESTRICTED
public static final int NR_STATE_NOT_RESTRICTED
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.
Constant Value: 2 (0x00000002)
NR_STATE_RESTRICTED
public static final int NR_STATE_RESTRICTED
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.
Constant Value: 1 (0x00000001)
SERVICE_TYPE_DATA
public static final int SERVICE_TYPE_DATA
Data service
Constant Value: 2 (0x00000002)
SERVICE_TYPE_EMERGENCY
public static final int SERVICE_TYPE_EMERGENCY
Emergency service
Constant Value: 5 (0x00000005)
SERVICE_TYPE_MMS
public static final int SERVICE_TYPE_MMS
MMS service
Constant Value: 6 (0x00000006)
SERVICE_TYPE_SMS
public static final int SERVICE_TYPE_SMS
SMS service
Constant Value: 3 (0x00000003)
SERVICE_TYPE_UNKNOWN
public static final int SERVICE_TYPE_UNKNOWN
Unknown service
Constant Value: 0 (0x00000000)
SERVICE_TYPE_VIDEO
public static final int SERVICE_TYPE_VIDEO
Video service
Constant Value: 4 (0x00000004)
SERVICE_TYPE_VOICE
public static final int SERVICE_TYPE_VOICE
Voice service
Constant Value: 1 (0x00000001)
Fields
Public methods
describeContents
public int describeContents ()
Describe the kinds of special objects contained in this Parcelable
 instance's marshaled representation. For example, if the object will
 include a file descriptor in the output of writeToParcel(android.os.Parcel, int),
 the return value of this method must include the
 CONTENTS_FILE_DESCRIPTOR bit.
| Returns | |
|---|---|
| int | a bitmask indicating the set of special object types marshaled
 by this Parcelable object instance.
 Value is either 0orCONTENTS_FILE_DESCRIPTOR | 
equals
public boolean equals (Object o)
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 returntrue.
- It is symmetric: for any non-null reference values
     xandy,x.equals(y)should returntrueif and only ify.equals(x)returnstrue.
- It is transitive: for any non-null reference values
     x,y, andz, ifx.equals(y)returnstrueandy.equals(z)returnstrue, thenx.equals(z)should returntrue.
- It is consistent: for any non-null reference values
     xandy, multiple invocations ofx.equals(y)consistently returntrueor consistently returnfalse, provided no information used inequalscomparisons on the objects is modified.
- For any non-null reference value x,x.equals(null)should returnfalse.
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 | |
|---|---|
| o | Object: This value may benull. | 
| Returns | |
|---|---|
| boolean | trueif this object is the same as the obj
          argument;falseotherwise. | 
getAccessNetworkTechnology
public int getAccessNetworkTechnology ()
getAvailableServices
public List<Integer> getAvailableServices ()
| Returns | |
|---|---|
| List<Integer> | List of available service types.
 This value cannot be null.
 Value isSERVICE_TYPE_UNKNOWN,SERVICE_TYPE_VOICE,SERVICE_TYPE_DATA,SERVICE_TYPE_SMS,SERVICE_TYPE_VIDEO,SERVICE_TYPE_EMERGENCY, orSERVICE_TYPE_MMS | 
getCellIdentity
public CellIdentity getCellIdentity ()
Require Manifest.permission.ACCESS_FINE_LOCATION, otherwise return null.
| Returns | |
|---|---|
| CellIdentity | The cell information. | 
getDomain
public int getDomain ()
| Returns | |
|---|---|
| int | The network domain.
 Value is DOMAIN_UNKNOWN,DOMAIN_CS,DOMAIN_PS, orDOMAIN_CS_PS | 
getRegisteredPlmn
public String getRegisteredPlmn ()
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.
| Returns | |
|---|---|
| String | the registered PLMN-ID or null. | 
getRejectCause
public int getRejectCause ()
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.
| Returns | |
|---|---|
| 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
public int getTransportType ()
| Returns | |
|---|---|
| int | The transport type.
 Value is android.telephony.AccessNetworkConstants.TRANSPORT_TYPE_INVALID, AccessNetworkConstants.TRANSPORT_TYPE_WWAN, orAccessNetworkConstants.TRANSPORT_TYPE_WLAN | 
hashCode
public int hashCode ()
Returns a hash code value for the object. This method is
 supported for the benefit of hash tables such as those provided by
 HashMap.
 
 The general contract of hashCode is:
 
- Whenever it is invoked on the same object more than once during
     an execution of a Java application, the hashCodemethod must consistently return the same integer, provided no information used inequalscomparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
- If two objects are equal according to the equalsmethod, then calling thehashCodemethod on each of the two objects must produce the same integer result.
- It is not required that if two objects are unequal
     according to the equalsmethod, then calling thehashCodemethod on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
| Returns | |
|---|---|
| int | a hash code value for this object. | 
isNetworkRegistered
public boolean isNetworkRegistered ()
| Returns | |
|---|---|
| boolean | trueif registered on roaming or home network,falseotherwise. (This
 value is not affected by any carrier config or resource overlay override). | 
isNetworkRoaming
public boolean isNetworkRoaming ()
| Returns | |
|---|---|
| boolean | trueif registered on roaming network. (This value is not affected by any
 carrier config or resource overlay override). | 
isNetworkSearching
public boolean isNetworkSearching ()
| Returns | |
|---|---|
| boolean | trueif searching for service,falseotherwise. (This value is not
 affected by any carrier config or resource overlay override). | 
isNonTerrestrialNetwork
public boolean isNonTerrestrialNetwork ()
Get whether the network is a non-terrestrial network.
| Returns | |
|---|---|
| boolean | trueif network is a non-terrestrial network elsefalse. | 
isRegistered
public boolean isRegistered ()
      This method was deprecated
      in API level 34.
    Use isNetworkRegistered(), which is not affected by any carrier config or
 resource overlay, instead.
  
| Returns | |
|---|---|
| boolean | trueif registered on roaming or home network. Note this value can be
 affected by the carrier config override. | 
isRoaming
public boolean isRoaming ()
      This method was deprecated
      in API level 34.
    Use TelephonyDisplayInfo.isRoaming instead.
  
| Returns | |
|---|---|
| boolean | trueif registered on roaming network overridden by config. Note this value
 can be affected by the carrier config override. | 
isSearching
public boolean isSearching ()
      This method was deprecated
      in API level 34.
    Use isNetworkRegistered(), which is not affected by any carrier config or
 resource overlay, instead.
  
| Returns | |
|---|---|
| boolean | trueif searching for service,falseotherwise. | 
toString
public String toString ()
Returns a string representation of the object.
| Returns | |
|---|---|
| String | This value cannot be null. | 
