Stay organized with collections
Save and categorize content based on your preferences.
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.
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.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# CarrierConfigManager.CarrierConfigChangeListener\n\nAdded in [API level 34](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\nCarrierConfigManager.CarrierConfigChangeListener\n================================================\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/telephony/CarrierConfigManager.CarrierConfigChangeListener \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\nstatic\n\n\ninterface\nCarrierConfigManager.CarrierConfigChangeListener\n`\n\n\n`\n\n\n`\n\n|--------------------------------------------------------------------|\n| android.telephony.CarrierConfigManager.CarrierConfigChangeListener |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nListener interface to get a notification when the carrier configurations have changed.\n\nUse this listener to receive timely updates when the carrier configuration changes. System\ncomponents should prefer this listener over [CarrierConfigManager.ACTION_CARRIER_CONFIG_CHANGED](/reference/android/telephony/CarrierConfigManager#ACTION_CARRIER_CONFIG_CHANGED)\nwhenever possible.\n\nTo register the listener, call\n[CarrierConfigManager.registerCarrierConfigChangeListener(java.util.concurrent.Executor, android.telephony.CarrierConfigManager.CarrierConfigChangeListener)](/reference/android/telephony/CarrierConfigManager#registerCarrierConfigChangeListener(java.util.concurrent.Executor,%20android.telephony.CarrierConfigManager.CarrierConfigChangeListener)).\nTo unregister, call\n[CarrierConfigManager.unregisterCarrierConfigChangeListener(android.telephony.CarrierConfigManager.CarrierConfigChangeListener)](/reference/android/telephony/CarrierConfigManager#unregisterCarrierConfigChangeListener(android.telephony.CarrierConfigManager.CarrierConfigChangeListener)).\n\nNote that on registration, registrants will NOT receive a notification on last carrier config\nchange. Only carrier configs change AFTER the registration will be sent to registrants. And\nunlike [CarrierConfigManager.ACTION_CARRIER_CONFIG_CHANGED](/reference/android/telephony/CarrierConfigManager#ACTION_CARRIER_CONFIG_CHANGED), notification wouldn't send when the device is\nunlocked. Registrants only receive the notification when there has been real carrier config\nchanges. \n**See also:**\n\n- [CarrierConfigManager.registerCarrierConfigChangeListener(Executor, CarrierConfigChangeListener)](/reference/android/telephony/CarrierConfigManager#registerCarrierConfigChangeListener(java.util.concurrent.Executor,%20android.telephony.CarrierConfigManager.CarrierConfigChangeListener))\n- [CarrierConfigManager.unregisterCarrierConfigChangeListener(CarrierConfigChangeListener)](/reference/android/telephony/CarrierConfigManager#unregisterCarrierConfigChangeListener(android.telephony.CarrierConfigManager.CarrierConfigChangeListener))\n- [CarrierConfigManager.ACTION_CARRIER_CONFIG_CHANGED](/reference/android/telephony/CarrierConfigManager#ACTION_CARRIER_CONFIG_CHANGED)\n- [CarrierConfigManager.getConfig(String)](/reference/android/telephony/CarrierConfigManager#getConfig(java.lang.String[]))\n- [CarrierConfigManager.getConfigForSubId(int, String)](/reference/android/telephony/CarrierConfigManager#getConfigForSubId(int,%20java.lang.String[]))\n\nSummary\n-------\n\n| ### Public methods ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract void` | ` `[onCarrierConfigChanged](/reference/android/telephony/CarrierConfigManager.CarrierConfigChangeListener#onCarrierConfigChanged(int,%20int,%20int,%20int))`(int logicalSlotIndex, int subscriptionId, int carrierId, int specificCarrierId) ` Called when carrier configurations have changed. |\n\nPublic methods\n--------------\n\n### onCarrierConfigChanged\n\nAdded in [API level 34](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract void onCarrierConfigChanged (int logicalSlotIndex, \n int subscriptionId, \n int carrierId, \n int specificCarrierId)\n```\n\nCalled when carrier configurations have changed.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `logicalSlotIndex` | `int`: The logical SIM slot index on which to monitor and get notification. It is guaranteed to be valid. \u003cbr /\u003e |\n| `subscriptionId` | `int`: The subscription on the SIM slot. May be [SubscriptionManager.INVALID_SUBSCRIPTION_ID](/reference/android/telephony/SubscriptionManager#INVALID_SUBSCRIPTION_ID). \u003cbr /\u003e |\n| `carrierId` | `int`: The optional carrier Id, may be [TelephonyManager.UNKNOWN_CARRIER_ID](/reference/android/telephony/TelephonyManager#UNKNOWN_CARRIER_ID). See [TelephonyManager.getSimCarrierId()](/reference/android/telephony/TelephonyManager#getSimCarrierId()). \u003cbr /\u003e |\n| `specificCarrierId` | `int`: The optional fine-grained carrierId, may be [TelephonyManager.UNKNOWN_CARRIER_ID](/reference/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()](/reference/android/telephony/TelephonyManager#getSimSpecificCarrierId()). \u003cbr /\u003e |"]]