ServiceState
open class ServiceState : Parcelable
| kotlin.Any | |
| ↳ | android.telephony.ServiceState | 
Contains phone state and service related information. The following phone information is included in returned ServiceState:
- Service state: IN_SERVICE, OUT_OF_SERVICE, EMERGENCY_ONLY, POWER_OFF
- Duplex mode: UNKNOWN, FDD, TDD
- Roaming indicator
- Operator name, short name and numeric id
- Network selection mode
Summary
| Constants | |
|---|---|
| static Int | Duplex mode for the phone is frequency-division duplexing. | 
| static Int | Duplex mode for the phone is time-division duplexing. | 
| static Int | Duplex mode for the phone is unknown. | 
| static Int | The phone is registered and locked. | 
| static Int | Normal operation condition, the phone is registered with an operator either in home network or in roaming. | 
| static Int | Phone is not registered with any operator, the phone can be currently searching a new operator to register to, or not searching to registration at all, or registration is denied, or radio signal is not available. | 
| static Int | Radio of telephony is explicitly powered off. | 
| static Int | Unknown ID. | 
| Inherited constants | |
|---|---|
| Public constructors | |
|---|---|
| Empty constructor | |
| ServiceState(in: Parcel!)Construct a ServiceState object from the given parcel. | |
| ServiceState(s: ServiceState!)Copy constructors | |
| Public methods | |
|---|---|
| open Int | |
| open Boolean | |
| open Int | Get the CDMA NID (Network Identification Number), a number uniquely identifying a network within a wireless system. | 
| open Int | Get the CDMA SID (System Identification Number), a number uniquely identifying a wireless system. | 
| open IntArray! | Get an array of cell bandwidths (kHz) for the current serving cells | 
| open Int | Get the channel number of the current primary serving cell, or -1 if unknown | 
| open Int | Get the current duplex mode | 
| open Boolean | Get current network selection mode. | 
| open MutableList<NetworkRegistrationInfo!> | Get all of the available network registration info. | 
| open String! | Get current registered operator name in long alphanumeric format. | 
| open String! | Get current registered operator name in short alphanumeric format. | 
| open String! | Get current registered operator numeric id. | 
| open Boolean | Get current roaming indicator of phone. | 
| open Int | getState()Get current voice service state | 
| open Int | hashCode() | 
| open Boolean | This indicates whether the device is searching for service. | 
| open Boolean | Get whether device is connected to a non-terrestrial network. | 
| open Unit | setIsManualSelection(isManual: Boolean) | 
| open Unit | setOperatorName(longName: String!, shortName: String!, numeric: String!) | 
| open Unit | setRoaming(roaming: Boolean) | 
| open Unit | |
| open Unit | |
| open Unit | |
| open String | toString() | 
| open Unit | writeToParcel(out: Parcel, flags: Int) | 
| Protected methods | |
|---|---|
| open Unit | copyFrom(s: ServiceState!) | 
| Properties | |
|---|---|
| static Parcelable.Creator<ServiceState!> | |
Constants
DUPLEX_MODE_FDD
static val DUPLEX_MODE_FDD: Int
Duplex mode for the phone is frequency-division duplexing.
Value: 1DUPLEX_MODE_TDD
static val DUPLEX_MODE_TDD: Int
Duplex mode for the phone is time-division duplexing.
Value: 2DUPLEX_MODE_UNKNOWN
static val DUPLEX_MODE_UNKNOWN: Int
Duplex mode for the phone is unknown.
Value: 0STATE_EMERGENCY_ONLY
static val STATE_EMERGENCY_ONLY: Int
The phone is registered and locked. Only emergency numbers are allowed. {@more}
Value: 2STATE_IN_SERVICE
static val STATE_IN_SERVICE: Int
Normal operation condition, the phone is registered with an operator either in home network or in roaming.
Value: 0STATE_OUT_OF_SERVICE
static val STATE_OUT_OF_SERVICE: Int
Phone is not registered with any operator, the phone can be currently searching a new operator to register to, or not searching to registration at all, or registration is denied, or radio signal is not available.
Value: 1STATE_POWER_OFF
static val STATE_POWER_OFF: Int
Radio of telephony is explicitly powered off.
Value: 3UNKNOWN_ID
static val UNKNOWN_ID: Int
Unknown ID. Could be returned by getCdmaNetworkId() or getCdmaSystemId()
Value: -1Public constructors
ServiceState
ServiceState(in: Parcel!)
Deprecated: The constructor takes parcel should not be public at the beginning. Use ServiceState() instead.
Construct a ServiceState object from the given parcel.
ServiceState
ServiceState(s: ServiceState!)
Copy constructors
| Parameters | |
|---|---|
| s | ServiceState!: Source service state | 
Public methods
describeContents
open fun describeContents(): Int
| Return | |
|---|---|
| Int | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0orandroid.os.Parcelable#CONTENTS_FILE_DESCRIPTOR | 
equals
open fun equals(other: Any?): Boolean
| Parameters | |
|---|---|
| obj | the reference object with which to compare. | 
| Return | |
|---|---|
| Boolean | trueif this object is the same as the obj argument;falseotherwise. | 
getCdmaNetworkId
open fun getCdmaNetworkId(): Int
Get the CDMA NID (Network Identification Number), a number uniquely identifying a network within a wireless system. (Defined in 3GPP2 C.S0023 3.4.8)
Require at least android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION. Otherwise return UNKNOWN_ID. 
 Requires android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION
| Return | |
|---|---|
| Int | UNKNOWN_IDas CDMA is no longer supported. | 
getCdmaSystemId
open fun getCdmaSystemId(): Int
Get the CDMA SID (System Identification Number), a number uniquely identifying a wireless system. (Defined in 3GPP2 C.S0023 3.4.8)
Require at least android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION. Otherwise return UNKNOWN_ID. 
 Requires android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION
| Return | |
|---|---|
| Int | UNKNOWN_IDas CDMA is no longer supported. | 
getCellBandwidths
open fun getCellBandwidths(): IntArray!
Get an array of cell bandwidths (kHz) for the current serving cells
| Return | |
|---|---|
| IntArray! | Current serving cell bandwidths | 
getChannelNumber
open fun getChannelNumber(): Int
Get the channel number of the current primary serving cell, or -1 if unknown
This is NRARFCN for NR, EARFCN for LTE, UARFCN for UMTS, and ARFCN for GSM.
| Return | |
|---|---|
| Int | Channel number of primary serving cell | 
getDuplexMode
open fun getDuplexMode(): Int
Get the current duplex mode
| Return | |
|---|---|
| Int | Current DuplexModefor the phone Value isandroid.telephony.ServiceState#DUPLEX_MODE_UNKNOWN,android.telephony.ServiceState#DUPLEX_MODE_FDD, orandroid.telephony.ServiceState#DUPLEX_MODE_TDD | 
getIsManualSelection
open fun getIsManualSelection(): Boolean
Get current network selection mode.
| Return | |
|---|---|
| Boolean | true if manual mode, false if automatic mode | 
getNetworkRegistrationInfoList
open fun getNetworkRegistrationInfoList(): MutableList<NetworkRegistrationInfo!>
Get all of the available network registration info.
| Return | |
|---|---|
| MutableList<NetworkRegistrationInfo!> | List of NetworkRegistrationInfoThis value cannot benull. | 
getOperatorAlphaLong
open fun getOperatorAlphaLong(): String!
Get current registered operator name in long alphanumeric format. In GSM/UMTS, long format can be up to 16 characters long. In CDMA, returns the ERI text, if set. Otherwise, returns the ONS. Require at least android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION. Otherwise return null if the caller does not hold neither android.Manifest.permission#ACCESS_FINE_LOCATION nor android.Manifest.permission#ACCESS_COARSE_LOCATION. 
 Requires android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION
| Return | |
|---|---|
| String! | long name of operator, null if unregistered or unknown | 
getOperatorAlphaShort
open fun getOperatorAlphaShort(): String!
Get current registered operator name in short alphanumeric format. In GSM/UMTS, short format can be up to 8 characters long. Require at least android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION. Otherwise return null if the caller does not hold neither android.Manifest.permission#ACCESS_FINE_LOCATION nor android.Manifest.permission#ACCESS_COARSE_LOCATION. 
 Requires android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION
| Return | |
|---|---|
| String! | short name of operator, null if unregistered or unknown | 
getOperatorNumeric
open fun getOperatorNumeric(): String!
Get current registered operator numeric id. In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit network code. Require at least android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION. Otherwise return null if the caller does not hold neither android.Manifest.permission#ACCESS_FINE_LOCATION nor android.Manifest.permission#ACCESS_COARSE_LOCATION. 
 Requires android.Manifest.permission#ACCESS_FINE_LOCATION or android.Manifest.permission#ACCESS_COARSE_LOCATION
| Return | |
|---|---|
| String! | numeric format of operator, null if unregistered or unknown | 
getRoaming
open fun getRoaming(): Boolean
Get current roaming indicator of phone. This roaming state could be overridden by the carrier config. (note: not just decoding from TS 27.007 7.2)
| Return | |
|---|---|
| Boolean | true if TS 27.007 7.2 roaming is true and ONS is different from SPN | 
See Also
- android.telephony.TelephonyDisplayInfo#isRoaming()
- android.telephony.CarrierConfigManager#KEY_FORCE_HOME_NETWORK_BOOL
- android.telephony.CarrierConfigManager#KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY
- android.telephony.CarrierConfigManager#KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY
- android.telephony.CarrierConfigManager#KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
- android.telephony.CarrierConfigManager#KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY
hashCode
open fun hashCode(): Int
| Return | |
|---|---|
| Int | a hash code value for this object. | 
isSearching
open fun isSearching(): Boolean
This indicates whether the device is searching for service. This API reports the modem searching status for AccessNetworkConstants.TRANSPORT_TYPE_WWAN (cellular) service in either NetworkRegistrationInfo.DOMAIN_CS or NetworkRegistrationInfo.DOMAIN_PS. This API will not report searching status for AccessNetworkConstants.TRANSPORT_TYPE_WLAN.
| Return | |
|---|---|
| Boolean | truewhenever the modem is searching for service. | 
isUsingNonTerrestrialNetwork
open fun isUsingNonTerrestrialNetwork(): Boolean
Get whether device is connected to a non-terrestrial network.
| Return | |
|---|---|
| Boolean | trueif device is connected to a non-terrestrial network elsefalse. | 
setOperatorName
open fun setOperatorName(
longName: String!,
shortName: String!,
numeric: String!
): Unit
toString
open fun toString(): String
| Return | |
|---|---|
| String | a string representation of the object. | 
writeToParcel
open fun writeToParcel(
out: Parcel,
flags: Int
): Unit
| Parameters | |
|---|---|
| dest | The Parcel in which the object should be written. This value cannot be null. | 
| flags | Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either0or a combination ofandroid.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES | 
