CarrierConfigManager.CarrierConfigChangeListener
public
static
interface
CarrierConfigManager.CarrierConfigChangeListener
| android.telephony.CarrierConfigManager.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 CarrierConfigManager.ACTION_CARRIER_CONFIG_CHANGED
whenever possible.
To register the listener, call
CarrierConfigManager.registerCarrierConfigChangeListener(java.util.concurrent.Executor, android.telephony.CarrierConfigManager.CarrierConfigChangeListener).
To unregister, call
CarrierConfigManager.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 CarrierConfigManager.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.
See also:
CarrierConfigManager.registerCarrierConfigChangeListener(Executor, CarrierConfigChangeListener)CarrierConfigManager.unregisterCarrierConfigChangeListener(CarrierConfigChangeListener)CarrierConfigManager.ACTION_CARRIER_CONFIG_CHANGEDCarrierConfigManager.getConfig(String)CarrierConfigManager.getConfigForSubId(int, String)
Summary
Public methods | |
|---|---|
abstract
void
|
onCarrierConfigChanged(int logicalSlotIndex, int subscriptionId, int carrierId, int specificCarrierId)
Called when carrier configurations have changed. |
Public methods
onCarrierConfigChanged
public abstract void onCarrierConfigChanged (int logicalSlotIndex,
int subscriptionId,
int carrierId,
int specificCarrierId)
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 TelephonyManager.UNKNOWN_CARRIER_ID. A specific carrierId may
be different from the carrierId above in a MVNO scenario. See
detail in TelephonyManager#getSimSpecificCarrierId(). |