CellInfo

Kotlin |Java

abstract class CellInfo : Parcelable

kotlin.Any
↳	android.telephony.CellInfo

Known Direct Subclasses

CellInfoCdma, CellInfoGsm, CellInfoLte, CellInfoNr, CellInfoTdscdma, CellInfoWcdma

CellInfoCdma	A `CellInfo` representing a CDMA cell that provides identity and measurement info.
CellInfoGsm	A `CellInfo` representing a GSM cell that provides identity and measurement info.
CellInfoLte	A `CellInfo` representing an LTE cell that provides identity and measurement info.
CellInfoNr	A `CellInfo` representing an 5G NR cell that provides identity and measurement info.
CellInfoTdscdma	A `CellInfo` representing a TD-SCDMA cell that provides identity and measurement info.
CellInfoWcdma	A `CellInfo` representing a WCDMA cell that provides identity and measurement info.

Immutable cell information from a point in time.

Summary

Constants
static Int	`CONNECTION_NONE` Cell is not a serving cell.
static Int	`CONNECTION_PRIMARY_SERVING` UE is connected to cell for signalling and possibly data (3GPP 36.331, 25.331).
static Int	`CONNECTION_SECONDARY_SERVING` UE is connected to cell for data (3GPP 36.331, 25.331).
static Int	`CONNECTION_UNKNOWN` Connection status is unknown.
static Int	`UNAVAILABLE` This value indicates that the integer field is unreported.
static Long	`UNAVAILABLE_LONG` This value indicates that the long field is unreported.

Inherited constants

From class Parcelable

Int

CONTENTS_FILE_DESCRIPTOR

Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor.

Int

PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public methods
open Int	`describeContents()` Implement the Parcelable interface
open Boolean	`equals(other: Any?)`
open Int	`getCellConnectionStatus()` Gets the connection status of this cell.
abstract CellIdentity	`getCellIdentity()`
abstract CellSignalStrength	`getCellSignalStrength()`
open Long	`getTimeStamp()` Approximate time this cell information was received from the modem.
open Long	`getTimestampMillis()` Approximate time this cell information was received from the modem.
open Int	`hashCode()`
open Boolean	`isRegistered()` True if the phone is registered to a mobile network that provides service on this cell and this cell is being used or would be used for network signaling.
open String	`toString()`
abstract Unit	`writeToParcel(dest: Parcel, flags: Int)` Implement the Parcelable interface

Properties
static Parcelable.Creator<CellInfo!>	`CREATOR` Implement the Parcelable interface

Constants

CONNECTION_NONE

Added in API level 28

static val CONNECTION_NONE: Int

Cell is not a serving cell.

The cell has been measured but is neither a camped nor serving cell (3GPP 36.304).

Value: 0

CONNECTION_PRIMARY_SERVING

Added in API level 28

static val CONNECTION_PRIMARY_SERVING: Int

UE is connected to cell for signalling and possibly data (3GPP 36.331, 25.331).

Value: 1

CONNECTION_SECONDARY_SERVING

Added in API level 28

static val CONNECTION_SECONDARY_SERVING: Int

UE is connected to cell for data (3GPP 36.331, 25.331).

Value: 2

CONNECTION_UNKNOWN

Added in API level 28

static val CONNECTION_UNKNOWN: Int

Connection status is unknown.

Value: 2147483647

UNAVAILABLE

Added in API level 29

static val UNAVAILABLE: Int

This value indicates that the integer field is unreported.

Value: 2147483647

UNAVAILABLE_LONG

Added in API level 29

static val UNAVAILABLE_LONG: Long

This value indicates that the long field is unreported.

Value: 9223372036854775807L

Public methods

describeContents

Added in API level 17

open fun describeContents(): Int

Implement the Parcelable interface

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 17

open fun equals(other: Any?): Boolean

Parameters
`obj`	the reference object with which to compare.

Return
`Boolean`	`true` if this object is the same as the obj argument; `false` otherwise.

getCellConnectionStatus

Added in API level 28

open fun getCellConnectionStatus(): Int

Gets the connection status of this cell.

Return
`Int`	The connection status of the cell. Value is `android.telephony.CellInfo#CONNECTION_NONE`, `android.telephony.CellInfo#CONNECTION_PRIMARY_SERVING`, `android.telephony.CellInfo#CONNECTION_SECONDARY_SERVING`, or `android.telephony.CellInfo#CONNECTION_UNKNOWN`

See Also

#CONNECTION_NONE
#CONNECTION_PRIMARY_SERVING
#CONNECTION_SECONDARY_SERVING
#CONNECTION_UNKNOWN

getCellIdentity

Added in API level 30

abstract fun getCellIdentity(): CellIdentity

Return
`CellIdentity`	a `CellIdentity` instance. This value cannot be `null`.

getCellSignalStrength

Added in API level 30

abstract fun getCellSignalStrength(): CellSignalStrength

Return
`CellSignalStrength`	a `CellSignalStrength` instance. This value cannot be `null`.

getTimeStamp

Added in API level 17
Deprecated in API level 30

open fun getTimeStamp(): Long

Deprecated: Use getTimestampMillis instead.

Approximate time this cell information was received from the modem.

Return
`Long`	a time stamp in nanos since boot.

getTimestampMillis

Added in API level 30

open fun getTimestampMillis(): Long

Approximate time this cell information was received from the modem.
Value is a non-negative timestamp in the android.os.SystemClock#elapsedRealtime() time base.

Return
`Long`	a time stamp in millis since boot. Value is a non-negative timestamp in the `android.os.SystemClock#elapsedRealtime()` time base.

hashCode

Added in API level 17

open fun hashCode(): Int

Return
`Int`	a hash code value for this object.

isRegistered

Added in API level 17

open fun isRegistered(): Boolean

True if the phone is registered to a mobile network that provides service on this cell and this cell is being used or would be used for network signaling.

toString

Added in API level 17

open fun toString(): String

Return
`String`	a string representation of the object.

writeToParcel

Added in API level 17

abstract fun writeToParcel(
    dest: Parcel, 
    flags: Int
): Unit

Implement the Parcelable interface

Parameters
`dest`	Parcel: 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 either `0` or a combination of `android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE`, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 17

static val CREATOR: Parcelable.Creator<CellInfo!>

Implement the Parcelable interface