PhoneStateListener

LISTEN_ACTIVE_DATA_SUBSCRIPTION_ID_CHANGE

static val LISTEN_ACTIVE_DATA_SUBSCRIPTION_ID_CHANGE: Int

Deprecated: Use TelephonyCallback.ActiveDataSubscriptionIdListener instead.

Listen for changes to active data subId. Active data subscription is the current subscription used to setup Cellular Internet data. For example, it could be the current active opportunistic subscription in use, or the subscription user selected as default data subscription in DSDS mode.
Requires android.Manifest.permission#READ_PHONE_STATE

Value: 4194304

LISTEN_BARRING_INFO

static val LISTEN_BARRING_INFO: Int

Deprecated: Use TelephonyCallback.BarringInfoListener instead.

Listen for Barring Information for the current registered / camped cell.

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).

Also requires the Manifest.permission.ACCESS_FINE_LOCATION permission, regardless of whether the calling app has carrier privileges.
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

Value: -2147483648

LISTEN_CALL_DISCONNECT_CAUSES

static val LISTEN_CALL_DISCONNECT_CAUSES: Int

Deprecated: Use TelephonyCallback.CallDisconnectCauseListener instead.

Listen for call disconnect causes which contains DisconnectCause and the precise disconnect cause.

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

Value: 33554432

LISTEN_CALL_FORWARDING_INDICATOR

static val LISTEN_CALL_FORWARDING_INDICATOR: Int

Deprecated: Use TelephonyCallback.CallForwardingIndicatorListener instead.

Listen for changes to the call-forwarding indicator. {@more} Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PHONE_STATE

Value: 8

LISTEN_CALL_STATE

static val LISTEN_CALL_STATE: Int

Deprecated: Use TelephonyCallback.CallStateListener instead.

Listen for changes to the device call state. {@more}

Value: 32

LISTEN_CELL_INFO

static val LISTEN_CELL_INFO: Int

Deprecated: Use TelephonyCallback.CellInfoListener instead.

Listen for changes to observed cell info. Listening to this event requires the Manifest.permission.READ_PHONE_STATE and Manifest.permission.ACCESS_FINE_LOCATION permission.
Requires android.Manifest.permission#READ_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

Value: 1024

LISTEN_CELL_LOCATION

static val LISTEN_CELL_LOCATION: Int

Deprecated: Use TelephonyCallback.CellLocationListener instead.

Listen for changes to the device's cell location. Note that this will result in frequent callbacks to the listener. {@more} Requires Permission: ACCESS_FINE_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.
Requires android.Manifest.permission#ACCESS_FINE_LOCATION

Value: 16

LISTEN_DATA_ACTIVITY

static val LISTEN_DATA_ACTIVITY: Int

Deprecated: Use TelephonyCallback.DataActivityListener instead.

Listen for changes to the direction of data traffic on the data connection (cellular). {@more} Example: The status bar uses this to display the appropriate data-traffic icon.

Value: 128

LISTEN_DATA_CONNECTION_STATE

static val LISTEN_DATA_CONNECTION_STATE: Int

Deprecated: Use TelephonyCallback.DataConnectionStateListener instead.

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

Value: 64

LISTEN_DISPLAY_INFO_CHANGED

static val LISTEN_DISPLAY_INFO_CHANGED: Int

Deprecated: Use TelephonyCallback.DisplayInfoListener instead.

Listen for display info changed event. For clients compiled on Android 11 SDK, requires permission: android.Manifest.permission#READ_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges). For clients compiled on Android 12 SDK or newer, android.Manifest.permission#READ_PHONE_STATE or carrier privileges is not required anymore.

Value: 1048576

LISTEN_EMERGENCY_NUMBER_LIST

static val LISTEN_EMERGENCY_NUMBER_LIST: Int

Deprecated: Use TelephonyCallback.EmergencyNumberListListener instead.

Listen for changes to emergency number list based on all active subscriptions.

Requires permission android.Manifest.permission#READ_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PHONE_STATE

Value: 16777216

LISTEN_IMS_CALL_DISCONNECT_CAUSES

static val LISTEN_IMS_CALL_DISCONNECT_CAUSES: Int

Deprecated: Use TelephonyCallback.ImsCallDisconnectCauseListener instead.

Listen for IMS call disconnect causes which contains android.telephony.ims.ImsReasonInfo

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

Value: 134217728

LISTEN_MESSAGE_WAITING_INDICATOR

static val LISTEN_MESSAGE_WAITING_INDICATOR: Int

Deprecated: Use TelephonyCallback.MessageWaitingIndicatorListener instead.

Listen for changes to the message-waiting indicator. {@more} Requires Permission: READ_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).

Example: The status bar uses this to determine when to display the voicemail icon.
Requires android.Manifest.permission#READ_PHONE_STATE

Value: 4

LISTEN_NONE

static val LISTEN_NONE: Int

Deprecated: Deprecated in Java.

Stop listening for updates. The PhoneStateListener is not tied to any subscription and unregistered for any update.

Value: 0

LISTEN_PRECISE_DATA_CONNECTION_STATE

static val LISTEN_PRECISE_DATA_CONNECTION_STATE: Int

Deprecated: Use TelephonyCallback.PreciseDataConnectionStateListener instead.

Listen for PreciseDataConnectionState on the data connection (cellular).

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

Value: 4096

LISTEN_REGISTRATION_FAILURE

static val LISTEN_REGISTRATION_FAILURE: Int

Deprecated: Use TelephonyCallback.RegistrationFailedListener instead.

Listen for Registration Failures. Listen for indications that a registration procedure has failed in either the CS or PS domain. This indication does not necessarily indicate a change of service state, which should be tracked via LISTEN_SERVICE_STATE.

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).

Also requires the Manifest.permission.ACCESS_FINE_LOCATION permission, regardless of whether the calling app has carrier privileges.
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

Value: 1073741824

LISTEN_SERVICE_STATE

static val LISTEN_SERVICE_STATE: Int

Deprecated: Use TelephonyCallback.ServiceStateListener instead.

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

Value: 1

LISTEN_SIGNAL_STRENGTH

static val LISTEN_SIGNAL_STRENGTH: Int

Deprecated: Use TelephonyCallback.SignalStrengthsListener instead.

Listen for changes to the network signal strength (cellular). {@more}

Value: 2

LISTEN_SIGNAL_STRENGTHS

static val LISTEN_SIGNAL_STRENGTHS: Int

Deprecated: Use TelephonyCallback.SignalStrengthsListener instead.

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

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

Value: 256

LISTEN_USER_MOBILE_DATA_STATE

static val LISTEN_USER_MOBILE_DATA_STATE: Int

Deprecated: Use TelephonyCallback.UserMobileDataStateListener instead.

Listen for changes to the user mobile data state

Value: 524288

PhoneStateListener

PhoneStateListener()

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

PhoneStateListener

PhoneStateListener(executor: Executor)

Create a PhoneStateListener for the Phone using the specified Executor

Create a PhoneStateListener with a specified Executor for handling necessary callbacks. The Executor must not be null.

onActiveDataSubscriptionIdChanged

open fun onActiveDataSubscriptionIdChanged(subId: Int): Unit

Deprecated: Use TelephonyCallback.ActiveDataSubscriptionIdListener instead.

Callback invoked when active data subId changes. Note, this callback triggers regardless of registered subscription. Requires the READ_PHONE_STATE permission.
Requires android.Manifest.permission#READ_PHONE_STATE

onBarringInfoChanged

open fun onBarringInfoChanged(barringInfo: BarringInfo): Unit

Deprecated: Use TelephonyCallback.BarringInfoListener instead.

Report updated barring information for the current camped/registered cell.

Barring info is provided for all services applicable to the current camped/registered cell, for the registered PLMN and current access class/access category.
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

onCallDisconnectCauseChanged

open fun onCallDisconnectCauseChanged(
    disconnectCause: Int, 
    preciseDisconnectCause: Int
): Unit

Deprecated: Use TelephonyCallback.CallDisconnectCauseListener instead.

Callback invoked when call disconnect cause changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

onCallForwardingIndicatorChanged

open fun onCallForwardingIndicatorChanged(cfi: Boolean): Unit

Deprecated: Use TelephonyCallback.CallForwardingIndicatorListener instead.

Callback invoked when the call-forwarding indicator changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PHONE_STATE

onCallStateChanged

open fun onCallStateChanged(
    state: Int, 
    phoneNumber: String!
): Unit

Deprecated: Use TelephonyCallback.CallStateListener instead.

Callback invoked when device call state changes.

Reports the state of Telephony (mobile) calls on the device for the registered subscription.

Note: the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

Note: The state returned here may differ from that returned by TelephonyManager.getCallState(). Receivers of this callback should be aware that calling TelephonyManager.getCallState() from within this callback may return a different state than the callback reports. Requires Permission: READ_PHONE_STATE for applications targeting API level 31+.

onCellInfoChanged

open fun onCellInfoChanged(cellInfo: MutableList<CellInfo!>!): Unit

Deprecated: Use TelephonyCallback.CellInfoListener instead.

Callback invoked when a observed cell info has changed or new cells have been added or removed on the registered subscription. Note, the registration subId s from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

onCellLocationChanged

open fun onCellLocationChanged(location: CellLocation!): Unit

Deprecated: Use TelephonyCallback.CellLocationListener instead.

Callback invoked when device cell location changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#ACCESS_FINE_LOCATION

onDataActivity

open fun onDataActivity(direction: Int): Unit

Deprecated: Use TelephonyCallback.DataActivityListener instead.

Callback invoked when data activity state changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

onDataConnectionStateChanged

open fun onDataConnectionStateChanged(state: Int): Unit

Deprecated: Use TelephonyCallback.DataConnectionStateListener instead.

Callback invoked when connection state changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

onDataConnectionStateChanged

open fun onDataConnectionStateChanged(
    state: Int, 
    networkType: Int
): Unit

Deprecated: Use TelephonyCallback.DataConnectionStateListener instead.

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

onDisplayInfoChanged

open fun onDisplayInfoChanged(telephonyDisplayInfo: TelephonyDisplayInfo): Unit

Deprecated: Use TelephonyCallback.DisplayInfoListener instead.

Callback invoked when the display info has changed on the registered subscription.

The TelephonyDisplayInfo contains status information shown to the user based on carrier policy. For clients compiled on Android 11 SDK, requires permission: android.Manifest.permission#READ_PHONE_STATE or that the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges). For clients compiled on Android 12 SDK or newer, android.Manifest.permission#READ_PHONE_STATE or carrier privileges is not required anymore.
Requires android.Manifest.permission#READ_PHONE_STATE

onEmergencyNumberListChanged

open fun onEmergencyNumberListChanged(emergencyNumberList: MutableMap<Int!, MutableList<EmergencyNumber!>!>): Unit

Deprecated: Use TelephonyCallback.EmergencyNumberListListener instead.

Callback invoked when the current emergency number list has changed on the registered subscription. Note, the registered subscription is associated with TelephonyManager object on which TelephonyManager.listen(PhoneStateListener, int) was called. If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the given subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PHONE_STATE

onImsCallDisconnectCauseChanged

open fun onImsCallDisconnectCauseChanged(imsReasonInfo: ImsReasonInfo): Unit

Deprecated: Use TelephonyCallback.ImsCallDisconnectCauseListener instead.

Callback invoked when Ims call disconnect cause changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

onMessageWaitingIndicatorChanged

open fun onMessageWaitingIndicatorChanged(mwi: Boolean): Unit

Deprecated: Use TelephonyCallback.MessageWaitingIndicatorListener instead.

Callback invoked when the message-waiting indicator changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().
Requires android.Manifest.permission#READ_PHONE_STATE

onPreciseDataConnectionStateChanged

open fun onPreciseDataConnectionStateChanged(dataConnectionState: PreciseDataConnectionState): Unit

Deprecated: Use TelephonyCallback.PreciseDataConnectionStateListener instead.

Callback providing update about the default/internet data connection on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

Requires permission android.Manifest.permission#READ_PRECISE_PHONE_STATE or the calling app has carrier privileges (see TelephonyManager.hasCarrierPrivileges).
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE

onRegistrationFailed

open fun onRegistrationFailed(
    cellIdentity: CellIdentity, 
    chosenPlmn: String, 
    domain: Int, 
    causeCode: Int, 
    additionalCauseCode: Int
): Unit

Deprecated: Use TelephonyCallback.RegistrationFailedListener instead.

Report that Registration or a Location/Routing/Tracking Area update has failed.

Indicate whenever a registration procedure, including a location, routing, or tracking area update fails. This includes procedures that do not necessarily result in a change of the modem's registration status. If the modem's registration status changes, that is reflected in the onNetworkStateChanged() and subsequent get{Voice/Data}RegistrationState().

Because registration failures are ephemeral, this callback is not sticky. Registrants will not receive the most recent past value when registering.
Requires android.Manifest.permission#READ_PRECISE_PHONE_STATE and android.Manifest.permission#ACCESS_FINE_LOCATION

onServiceStateChanged

open fun onServiceStateChanged(serviceState: ServiceState!): Unit

Deprecated: Use TelephonyCallback.ServiceStateListener instead.

Callback invoked when device service state changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId(). The instance of ServiceState passed as an argument here will have various levels of location information stripped from it depending on the location permissions that your app holds. Only apps holding the Manifest.permission.ACCESS_FINE_LOCATION permission will receive all the information in ServiceState, otherwise the cellIdentity will be null if apps only holding the Manifest.permission.ACCESS_COARSE_LOCATION permission. Network operator name in long/short alphanumeric format and numeric id will be null if apps holding neither android.Manifest.permission#ACCESS_FINE_LOCATION nor android.Manifest.permission#ACCESS_COARSE_LOCATION.

onSignalStrengthChanged

open fun onSignalStrengthChanged(asu: Int): Unit

Deprecated: Use onSignalStrengthsChanged(android.telephony.SignalStrength)

Callback invoked when network signal strength changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

onSignalStrengthsChanged

open fun onSignalStrengthsChanged(signalStrength: SignalStrength!): Unit

Deprecated: Use TelephonyCallback.SignalStrengthsListener instead.

Callback invoked when network signal strengths changes on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().

onUserMobileDataStateChanged

open fun onUserMobileDataStateChanged(enabled: Boolean): Unit

Deprecated: Use TelephonyCallback.UserMobileDataStateListener instead.

Callback invoked when the user mobile data state has changed on the registered subscription. Note, the registration subId comes from TelephonyManager object which registers PhoneStateListener by TelephonyManager.listen(PhoneStateListener, int). If this TelephonyManager object was created with TelephonyManager.createForSubscriptionId(int), then the callback applies to the subId. Otherwise, this callback applies to SubscriptionManager.getDefaultSubscriptionId().