CarrierConfigChangeListener

Kotlin |Java

interface CarrierConfigChangeListener

Listener interface to get a notification when the carrier configurations have changed. Use this listener to receive timely updates when the carrier configuration changes. System components should prefer this listener over ACTION_CARRIER_CONFIG_CHANGED whenever possible. To register the listener, call registerCarrierConfigChangeListener(java.util.concurrent.Executor,android.telephony.CarrierConfigManager.CarrierConfigChangeListener). To unregister, call unregisterCarrierConfigChangeListener(android.telephony.CarrierConfigManager.CarrierConfigChangeListener). Note that on registration, registrants will NOT receive a notification on last carrier config change. Only carrier configs change AFTER the registration will be sent to registrants. And unlike ACTION_CARRIER_CONFIG_CHANGED, notification wouldn't send when the device is unlocked. Registrants only receive the notification when there has been real carrier config changes.

Summary

Public methods
abstract Unit	`onCarrierConfigChanged(logicalSlotIndex: Int, subscriptionId: Int, carrierId: Int, specificCarrierId: Int)` Called when carrier configurations have changed.

abstract fun onCarrierConfigChanged(
    logicalSlotIndex: Int, 
    subscriptionId: Int, 
    carrierId: Int, 
    specificCarrierId: Int
): Unit

Called when carrier configurations have changed.

Parameters
`logicalSlotIndex`	Int: The logical SIM slot index on which to monitor and get notification. It is guaranteed to be valid.
`subscriptionId`	Int: The subscription on the SIM slot. May be `SubscriptionManager.INVALID_SUBSCRIPTION_ID`.
`carrierId`	Int: The optional carrier Id, may be `TelephonyManager.UNKNOWN_CARRIER_ID`. See `TelephonyManager.getSimCarrierId()`.
`specificCarrierId`	Int: The optional fine-grained carrierId, may be `android.telephony.TelephonyManager#UNKNOWN_CARRIER_ID`. A specific carrierId may be different from the carrierId above in a MVNO scenario. See detail in `TelephonyManager.getSimSpecificCarrierId()`.