Skip to content

Most visited

Recently visited

navigation
Added in API level 1

ServiceState

public class ServiceState
extends Object implements Parcelable

java.lang.Object
   ↳ android.telephony.ServiceState


Contains phone state and service related information. The following phone information is included in returned ServiceState:

Summary

Constants

int STATE_EMERGENCY_ONLY

The phone is registered and locked. Only emergency numbers are allowed.

int STATE_IN_SERVICE

Normal operation condition, the phone is registered with an operator either in home network or in roaming.

int STATE_OUT_OF_SERVICE

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.

int STATE_POWER_OFF

Radio of telephony is explicitly powered off.

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<ServiceState> CREATOR

Public constructors

ServiceState()

Empty constructor

ServiceState(ServiceState s)

Copy constructors

ServiceState(Parcel in)

Construct a ServiceState object from the given parcel.

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

boolean equals(Object o)

Compares this instance with the specified object and indicates if they are equal.

boolean getIsManualSelection()

Get current network selection mode.

String getOperatorAlphaLong()

Get current registered operator name in long alphanumeric format.

String getOperatorAlphaShort()

Get current registered operator name in short alphanumeric format.

String getOperatorNumeric()

Get current registered operator numeric id.

boolean getRoaming()

Get current roaming indicator of phone (note: not just decoding from TS 27.007 7.2)

int getState()

Get current voice service state

int hashCode()

Returns an integer hash code for this object.

void setIsManualSelection(boolean isManual)
void setOperatorName(String longName, String shortName, String numeric)
void setRoaming(boolean roaming)
void setState(int state)
void setStateOff()
void setStateOutOfService()
String toString()

Returns a string containing a concise, human-readable description of this object.

void writeToParcel(Parcel out, int flags)

Flatten this object in to a Parcel.

Protected methods

void copyFrom(ServiceState s)

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Constants

STATE_EMERGENCY_ONLY

Added in API level 1
int STATE_EMERGENCY_ONLY

The phone is registered and locked. Only emergency numbers are allowed.

Constant Value: 2 (0x00000002)

STATE_IN_SERVICE

Added in API level 1
int STATE_IN_SERVICE

Normal operation condition, the phone is registered with an operator either in home network or in roaming.

Constant Value: 0 (0x00000000)

STATE_OUT_OF_SERVICE

Added in API level 1
int STATE_OUT_OF_SERVICE

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.

Constant Value: 1 (0x00000001)

STATE_POWER_OFF

Added in API level 1
int STATE_POWER_OFF

Radio of telephony is explicitly powered off.

Constant Value: 3 (0x00000003)

Fields

CREATOR

Added in API level 1
Creator<ServiceState> CREATOR

Public constructors

ServiceState

Added in API level 1
ServiceState ()

Empty constructor

ServiceState

Added in API level 1
ServiceState (ServiceState s)

Copy constructors

Parameters
s ServiceState: Source service state

ServiceState

Added in API level 1
ServiceState (Parcel in)

Construct a ServiceState object from the given parcel.

Parameters
in Parcel

Public methods

describeContents

Added in API level 1
int describeContents ()

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

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

equals

Added in API level 1
boolean equals (Object o)

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 specified object is equal to this Object; false otherwise.

getIsManualSelection

Added in API level 1
boolean getIsManualSelection ()

Get current network selection mode.

Returns
boolean true if manual mode, false if automatic mode

getOperatorAlphaLong

Added in API level 1
String getOperatorAlphaLong ()

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.

Returns
String long name of operator, null if unregistered or unknown

getOperatorAlphaShort

Added in API level 1
String getOperatorAlphaShort ()

Get current registered operator name in short alphanumeric format. In GSM/UMTS, short format can be up to 8 characters long.

Returns
String short name of operator, null if unregistered or unknown

getOperatorNumeric

Added in API level 1
String getOperatorNumeric ()

Get current registered operator numeric id. In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit network code.

Returns
String numeric format of operator, null if unregistered or unknown

getRoaming

Added in API level 1
boolean getRoaming ()

Get current roaming indicator of phone (note: not just decoding from TS 27.007 7.2)

Returns
boolean true if TS 27.007 7.2 roaming is true and ONS is different from SPN

getState

Added in API level 1
int getState ()

Get current voice service state

Returns
int

hashCode

Added in API level 1
int hashCode ()

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 this object's hash code.

setIsManualSelection

Added in API level 1
void setIsManualSelection (boolean isManual)

Parameters
isManual boolean

setOperatorName

Added in API level 1
void setOperatorName (String longName, 
                String shortName, 
                String numeric)

Parameters
longName String
shortName String
numeric String

setRoaming

Added in API level 1
void setRoaming (boolean roaming)

Parameters
roaming boolean

setState

Added in API level 1
void setState (int state)

Parameters
state int

setStateOff

Added in API level 1
void setStateOff ()

setStateOutOfService

Added in API level 1
void setStateOutOfService ()

toString

Added in API level 1
String toString ()

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 a printable representation of this object.

writeToParcel

Added in API level 1
void writeToParcel (Parcel out, 
                int flags)

Flatten this object in to a Parcel.

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.

Protected methods

copyFrom

Added in API level 1
void copyFrom (ServiceState s)

Parameters
s ServiceState
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.