Added in [API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Nested Classes](https://developer.android.com/reference/android/telephony/TelephonyCallback#nestedclasses) \| [Ctors](https://developer.android.com/reference/android/telephony/TelephonyCallback#pubctors) \| [Inherited Methods](https://developer.android.com/reference/android/telephony/TelephonyCallback#inhmethods)

# TelephonyCallback

*** ** * ** ***


`
public


class
TelephonyCallback
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


`

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.telephony.TelephonyCallback |

<br />

*** ** * ** ***

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


To register a callback, use a `https://developer.android.com/reference/android/telephony/TelephonyCallback` which implements interfaces regarding
EVENT_\*. For example,
FakeServiceStateCallback extends `https://developer.android.com/reference/android/telephony/TelephonyCallback` implements
`https://developer.android.com/reference/android/telephony/TelephonyCallback.ServiceStateListener`.


Then override the methods for the state that you wish to receive updates for, and
pass the executor and your TelephonyCallback object to
`https://developer.android.com/reference/android/telephony/TelephonyManager#registerTelephonyCallback(int,%20java.util.concurrent.Executor,%20android.telephony.TelephonyCallback)`.
Methods are called when the state changes, as well as once on initial registration.


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 sub-interfaces.

## Summary

| ### Nested classes ||
|---|---|
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.ActiveDataSubscriptionIdListener` Interface for active data subscription ID listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.BarringInfoListener` Interface for barring information listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CallDisconnectCauseListener` Interface for call disconnect cause listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CallForwardingIndicatorListener` Interface for call-forwarding indicator listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CallStateListener` Interface for call state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CarrierNetworkListener` Interface for carrier network listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CarrierRoamingNtnListener` Interface for carrier roaming non-terrestrial network listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CellInfoListener` Interface for cell info listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.CellLocationListener` Interface for device cell location listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.DataActivationStateListener` Interface for SIM data activation state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.DataActivityListener` Interface for data activity state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.DataConnectionStateListener` Interface for data connection state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.DisplayInfoListener` Interface for display info listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.EmergencyNumberListListener` Interface for the current emergency number list listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.ImsCallDisconnectCauseListener` Interface for IMS call disconnect cause listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.MessageWaitingIndicatorListener` Interface for message waiting indicator listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.PhysicalChannelConfigListener` Interface for current physical channel configuration listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.PreciseDataConnectionStateListener` Interface for precise data connection state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.RegistrationFailedListener` Interface for registration failures listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.ServiceStateListener` Interface for service state listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.SignalStrengthsListener` Interface for network signal strengths listener. |
| ` interface` | `https://developer.android.com/reference/android/telephony/TelephonyCallback.UserMobileDataStateListener` Interface for user mobile data state listener. |

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/telephony/TelephonyCallback#TelephonyCallback()() ` |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### TelephonyCallback

```
public TelephonyCallback ()
```

<br />

<br />