Added in API level 17

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