Android APIs
public class

SignalStrength

extends Object
implements Parcelable
java.lang.Object
   ↳ android.telephony.SignalStrength

Class Overview

Contains phone signal strength related information.

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
int describeContents()
boolean equals(Object o)
Compares this instance with the specified object and indicates if they are equal.
int getCdmaDbm()
Get the CDMA RSSI value in dBm
int getCdmaEcio()
Get the CDMA Ec/Io value in dB*10
int getEvdoDbm()
Get the EVDO RSSI value in dBm
int getEvdoEcio()
Get the EVDO Ec/Io value in dB*10
int getEvdoSnr()
Get the signal to noise ratio.
int getGsmBitErrorRate()
Get the GSM bit error rate (0-7, 99) as defined in TS 27.007 8.5
int getGsmSignalStrength()
Get the GSM Signal Strength, valid values are (0-31, 99) as defined in TS 27.007 8.5
int getLevel()
Retrieve an abstract level value for the overall signal strength.
int hashCode()
Returns an integer hash code for this object.
boolean isGsm()
String toString()
Returns a string containing a concise, human-readable description of this object.
void writeToParcel(Parcel out, int flags)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Public Methods

public int describeContents ()

Added in API level 7

describeContents()

Returns
int a bitmask indicating the set of special object types marshalled by the Parcelable.

public boolean equals (Object o)

Added in API level 7

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o. See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Parameters
o Object: the object to compare this instance with.
Returns
boolean true if the signal strengths are the same

public int getCdmaDbm ()

Added in API level 7

Get the CDMA RSSI value in dBm

Returns
int

public int getCdmaEcio ()

Added in API level 7

Get the CDMA Ec/Io value in dB*10

Returns
int

public int getEvdoDbm ()

Added in API level 7

Get the EVDO RSSI value in dBm

Returns
int

public int getEvdoEcio ()

Added in API level 7

Get the EVDO Ec/Io value in dB*10

Returns
int

public int getEvdoSnr ()

Added in API level 7

Get the signal to noise ratio. Valid values are 0-8. 8 is the highest.

Returns
int

public int getGsmBitErrorRate ()

Added in API level 7

Get the GSM bit error rate (0-7, 99) as defined in TS 27.007 8.5

Returns
int

public int getGsmSignalStrength ()

Added in API level 7

Get the GSM Signal Strength, valid values are (0-31, 99) as defined in TS 27.007 8.5

Returns
int

public int getLevel ()

Added in API level 23

Retrieve an abstract level value for the overall signal strength.

Returns
int a single integer from 0 to 4 representing the general signal quality. This may take into account many different radio technology inputs. 0 represents very poor signal strength while 4 represents a very strong signal strength.

public int hashCode ()

Added in API level 7

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Returns
int hash code

public boolean isGsm ()

Added in API level 7

Returns
boolean true if this is for GSM

public String toString ()

Added in API level 7

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Returns
String string representation.

public void writeToParcel (Parcel out, int flags)

Added in API level 7

writeToParcel(Parcel, int)

Parameters
out Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.