CarrierNetworkListener

Kotlin |Java

interface CarrierNetworkListener

android.telephony.TelephonyCallback.CarrierNetworkListener

Interface for carrier network listener.

Summary

Public methods
abstract Unit	`onCarrierNetworkChange(active: Boolean)` Callback invoked when telephony has received notice from a carrier app that a network action that could result in connectivity loss has been requested by an app using `android.service.carrier.CarrierService#notifyCarrierNetworkChange(boolean)`

Public methods

onCarrierNetworkChange

Added in API level 31

abstract fun onCarrierNetworkChange(active: Boolean): Unit

Callback invoked when telephony has received notice from a carrier app that a network action that could result in connectivity loss has been requested by an app using android.service.carrier.CarrierService#notifyCarrierNetworkChange(boolean)

This is optional and is only used to allow the system to provide alternative UI while telephony is performing an action that may result in intentional, temporary network lack of connectivity.

Note, this callback is pinned to the registered subscription and will be invoked when the notifying carrier app has carrier privilege rule on the registered subscription. android.telephony.TelephonyManager#hasCarrierPrivileges

Parameters
`active`	Boolean: If the carrier network change is or shortly will be active, `true` indicate that showing alternative UI, `false` otherwise.