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 |
Indicates whether some other object is "equal to" this one. |
Int | |
MutableList<Int!> | |
CellIdentity? |
Require |
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 |
hashCode() |
Boolean | |
Boolean | |
Boolean | |
Boolean |
Get whether the network is a non-terrestrial network. |
Boolean | |
Boolean | |
Boolean | |
String |
toString() Returns a string representation of the object. |
Properties | |
---|---|
static Parcelable.Creator<NetworkRegistrationInfo!> |
Constants
DOMAIN_CS_PS
static val DOMAIN_CS_PS: Int
Applicable to both CS and PS Domain
Value: 3
DOMAIN_UNKNOWN
static val DOMAIN_UNKNOWN: Int
Unknown / Unspecified domain
Value: 0
NR_STATE_CONNECTED
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
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
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
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_EMERGENCY
static val SERVICE_TYPE_EMERGENCY: Int
Emergency service
Value: 5
SERVICE_TYPE_UNKNOWN
static val SERVICE_TYPE_UNKNOWN: Int
Unknown service
Value: 0
Public methods
describeContents
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
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 returntrue
. - It is symmetric: for any non-null reference values
x
andy
,x.equals(y)
should returntrue
if and only ify.equals(x)
returnstrue
. - It is transitive: for any non-null reference values
x
,y
, andz
, ifx.equals(y)
returnstrue
andy.equals(z)
returnstrue
, thenx.equals(z)
should returntrue
. - It is consistent: for any non-null reference values
x
andy
, multiple invocations ofx.equals(y)
consistently returntrue
or consistently returnfalse
, provided no information used inequals
comparisons 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 | |
---|---|
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. |
getAccessNetworkTechnology
fun getAccessNetworkTechnology(): Int
getAvailableServices
fun getAvailableServices(): MutableList<Int!>
getCellIdentity
fun getCellIdentity(): CellIdentity?
Require android.Manifest.permission#ACCESS_FINE_LOCATION
, otherwise return null.
Return | |
---|---|
CellIdentity? |
The cell information. |
getDomain
fun getDomain(): Int
getRegisteredPlmn
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
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
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 |
isNetworkRegistered
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
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
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
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
funisRegistered(): 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
funisRoaming(): 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
funisSearching(): 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
fun toString(): String
Returns a string representation of the object.
Return | |
---|---|
String |
This value cannot be null . |