added in API level 1

Summary: Constants | Ctors | Methods | Inherited Methods

PhoneStateListener

public class PhoneStateListener
extends Object

java.lang.Object
↳	android.telephony.PhoneStateListener

A listener class for monitoring changes in specific telephony states on the device, including service state, signal strength, message waiting indicator (voicemail), and others.

Override the methods for the state that you wish to receive updates for, and pass your PhoneStateListener object, along with bitwise-or of the LISTEN_ flags to TelephonyManager.listen().

Note that access to some telephony information is permission-protected. Your application won't receive updates for protected information unless it has the appropriate permissions declared in its manifest file. Where permissions apply, they are noted in the appropriate LISTEN_ flags.

Summary

Constants
`int`	`LISTEN_CALL_FORWARDING_INDICATOR` Listen for changes to the call-forwarding indicator.
`int`	`LISTEN_CALL_STATE` Listen for changes to the device call state.
`int`	`LISTEN_CELL_INFO` Listen for changes to observed cell info.
`int`	`LISTEN_CELL_LOCATION` Listen for changes to the device's cell location. Note that this will result in frequent callbacks to the listener.
`int`	`LISTEN_DATA_ACTIVITY` Listen for changes to the direction of data traffic on the data connection (cellular).
`int`	`LISTEN_DATA_CONNECTION_STATE` Listen for changes to the data connection state (cellular).
`int`	`LISTEN_MESSAGE_WAITING_INDICATOR` Listen for changes to the message-waiting indicator.
`int`	`LISTEN_NONE` Stop listening for updates.
`int`	`LISTEN_SERVICE_STATE` Listen for changes to the network service state (cellular).
`int`	`LISTEN_SIGNAL_STRENGTH` This constant was deprecated in API level 7. by `LISTEN_SIGNAL_STRENGTHS`
`int`	`LISTEN_SIGNAL_STRENGTHS` Listen for changes to the network signal strengths (cellular).
`int`	`LISTEN_USER_MOBILE_DATA_STATE` Listen for changes to the user mobile data state

Public constructors
`PhoneStateListener()` Create a PhoneStateListener for the Phone with the default subscription.

Public methods
`void`	`onCallForwardingIndicatorChanged(boolean cfi)` Callback invoked when the call-forwarding indicator changes.
`void`	`onCallStateChanged(int state, String phoneNumber)` Callback invoked when device call state changes.
`void`	`onCellInfoChanged(List<CellInfo> cellInfo)` Callback invoked when a observed cell info has changed, or new cells have been added or removed.
`void`	`onCellLocationChanged(CellLocation location)` Callback invoked when device cell location changes.
`void`	`onDataActivity(int direction)` Callback invoked when data activity state changes.
`void`	`onDataConnectionStateChanged(int state, int networkType)` same as above, but with the network type.
`void`	`onDataConnectionStateChanged(int state)` Callback invoked when connection state changes.
`void`	`onMessageWaitingIndicatorChanged(boolean mwi)` Callback invoked when the message-waiting indicator changes.
`void`	`onServiceStateChanged(ServiceState serviceState)` Callback invoked when device service state changes.
`void`	`onSignalStrengthChanged(int asu)` This method was deprecated in API level 5. Use `onSignalStrengthsChanged(SignalStrength)`
`void`	`onSignalStrengthsChanged(SignalStrength signalStrength)` Callback invoked when network signal strengths changes.
`void`	`onUserMobileDataStateChanged(boolean enabled)` Callback invoked when the user mobile data state has changed

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Constants

LISTEN_CALL_FORWARDING_INDICATOR

added in API level 1

int LISTEN_CALL_FORWARDING_INDICATOR

Listen for changes to the call-forwarding indicator.

Requires Permission: READ_PHONE_STATE

See also:

onCallForwardingIndicatorChanged(boolean)

Constant Value: 8 (0x00000008)

LISTEN_CALL_STATE

added in API level 1

int LISTEN_CALL_STATE

Listen for changes to the device call state.

See also:

onCallStateChanged(int, String)

Constant Value: 32 (0x00000020)

LISTEN_CELL_INFO

added in API level 17

int LISTEN_CELL_INFO

Listen for changes to observed cell info.

See also:

onCellInfoChanged(List)

Constant Value: 1024 (0x00000400)

LISTEN_CELL_LOCATION

added in API level 1

int LISTEN_CELL_LOCATION

Listen for changes to the device's cell location. Note that this will result in frequent callbacks to the listener.

Requires Permission: ACCESS_COARSE_LOCATION

If you need regular location updates but want more control over the update interval or location precision, you can set up a listener through the location manager instead.

See also:

onCellLocationChanged(CellLocation)

Constant Value: 16 (0x00000010)

LISTEN_DATA_ACTIVITY

added in API level 1

int LISTEN_DATA_ACTIVITY

Listen for changes to the direction of data traffic on the data connection (cellular).

Example: The status bar uses this to display the appropriate data-traffic icon.

See also:

onDataActivity(int)

Constant Value: 128 (0x00000080)

LISTEN_DATA_CONNECTION_STATE

added in API level 1

int LISTEN_DATA_CONNECTION_STATE

Listen for changes to the data connection state (cellular).

See also:

onDataConnectionStateChanged(int)

Constant Value: 64 (0x00000040)

LISTEN_MESSAGE_WAITING_INDICATOR

added in API level 1

int LISTEN_MESSAGE_WAITING_INDICATOR

Listen for changes to the message-waiting indicator.

Requires Permission: READ_PHONE_STATE

Example: The status bar uses this to determine when to display the voicemail icon.

See also:

onMessageWaitingIndicatorChanged(boolean)

Constant Value: 4 (0x00000004)

LISTEN_NONE

added in API level 1

int LISTEN_NONE

Stop listening for updates.

Constant Value: 0 (0x00000000)

LISTEN_SERVICE_STATE

added in API level 1

int LISTEN_SERVICE_STATE

Listen for changes to the network service state (cellular).

See also:

Constant Value: 1 (0x00000001)

LISTEN_SIGNAL_STRENGTH

added in API level 1

int LISTEN_SIGNAL_STRENGTH

This constant was deprecated in API level 7.
by LISTEN_SIGNAL_STRENGTHS

Listen for changes to the network signal strength (cellular).

Requires Permission: READ_PHONE_STATE

See also:

onSignalStrengthChanged(int)

Constant Value: 2 (0x00000002)

LISTEN_SIGNAL_STRENGTHS

added in API level 7

int LISTEN_SIGNAL_STRENGTHS

Listen for changes to the network signal strengths (cellular).

Example: The status bar uses this to control the signal-strength icon.

See also:

onSignalStrengthsChanged(SignalStrength)

Constant Value: 256 (0x00000100)

LISTEN_USER_MOBILE_DATA_STATE

Android P Developer Preview

int LISTEN_USER_MOBILE_DATA_STATE

Listen for changes to the user mobile data state

See also:

onUserMobileDataStateChanged(boolean)

Constant Value: 524288 (0x00080000)

Public constructors

PhoneStateListener

added in API level 1

PhoneStateListener ()

Create a PhoneStateListener for the Phone with the default subscription. This class requires Looper.myLooper() not return null.

Public methods

onCallForwardingIndicatorChanged

added in API level 1

void onCallForwardingIndicatorChanged (boolean cfi)

Callback invoked when the call-forwarding indicator changes.

Parameters
`cfi`	`boolean`

onCallStateChanged

added in API level 1

void onCallStateChanged (int state, 
                String phoneNumber)

Callback invoked when device call state changes.

Parameters
`state`	`int`: call state
`phoneNumber`	`String`: call phone number. If application does not have `READ_PHONE_STATE` permission, an empty string will be passed as an argument.

See also:

onCellInfoChanged

added in API level 17

void onCellInfoChanged (List<CellInfo> cellInfo)

Callback invoked when a observed cell info has changed, or new cells have been added or removed.

Parameters
`cellInfo`	`List`: is the list of currently visible cells.

onCellLocationChanged

added in API level 1

void onCellLocationChanged (CellLocation location)

Callback invoked when device cell location changes.

Parameters
`location`	`CellLocation`

onDataActivity

added in API level 1

void onDataActivity (int direction)

Callback invoked when data activity state changes.

Parameters
`direction`	`int`

See also:

onDataConnectionStateChanged

added in API level 7

void onDataConnectionStateChanged (int state, 
                int networkType)

same as above, but with the network type. Both called.

Parameters
`state`	`int`
`networkType`	`int`

onDataConnectionStateChanged

added in API level 1

void onDataConnectionStateChanged (int state)

Callback invoked when connection state changes.

Parameters
`state`	`int`

See also:

onMessageWaitingIndicatorChanged

added in API level 1

void onMessageWaitingIndicatorChanged (boolean mwi)

Callback invoked when the message-waiting indicator changes.

Parameters
`mwi`	`boolean`

onServiceStateChanged

added in API level 1

void onServiceStateChanged (ServiceState serviceState)

Callback invoked when device service state changes.

Parameters
`serviceState`	`ServiceState`

See also:

onSignalStrengthChanged

added in API level 1

void onSignalStrengthChanged (int asu)

This method was deprecated in API level 5.
Use onSignalStrengthsChanged(SignalStrength)

Callback invoked when network signal strength changes.

Parameters
`asu`	`int`

See also:

onSignalStrengthsChanged

added in API level 7

void onSignalStrengthsChanged (SignalStrength signalStrength)

Callback invoked when network signal strengths changes.

Parameters
`signalStrength`	`SignalStrength`

See also:

onUserMobileDataStateChanged

Android P Developer Preview

void onUserMobileDataStateChanged (boolean enabled)

Callback invoked when the user mobile data state has changed

Parameters
`enabled`	`boolean`: indicates whether the current user mobile data state is enabled or disabled.

Most visited

Recently visited

Results for

PhoneStateListener

Summary

Constants

Public constructors

Public methods

Inherited methods

Constants

LISTEN_CALL_FORWARDING_INDICATOR

LISTEN_CALL_STATE

LISTEN_CELL_INFO

LISTEN_CELL_LOCATION

LISTEN_DATA_ACTIVITY

LISTEN_DATA_CONNECTION_STATE

LISTEN_MESSAGE_WAITING_INDICATOR

LISTEN_NONE

LISTEN_SERVICE_STATE

LISTEN_SIGNAL_STRENGTH

LISTEN_SIGNAL_STRENGTHS

LISTEN_USER_MOBILE_DATA_STATE

Public constructors

PhoneStateListener

Public methods

onCallForwardingIndicatorChanged

onCallStateChanged

onCellInfoChanged

onCellLocationChanged

onDataActivity

onDataConnectionStateChanged

onDataConnectionStateChanged

onMessageWaitingIndicatorChanged

onServiceStateChanged

onSignalStrengthChanged

onSignalStrengthsChanged

onUserMobileDataStateChanged

Classes

Enums