Added in API level 33

ImsEmergency


class ImsEmergency
kotlin.Any
   ↳ android.telephony.CarrierConfigManager.ImsEmergency

Emergency Call/E911. This groups the configs specific for emergency call over IMS.

Reference: 3GPP 24.229, 3GPP 23.167 Annex H, 3GPP 24.301.

Summary

Constants
static Int

Circuit switched domain.

static Int

Packet switched domain over 3GPP networks.

static Int

Packet switched domain over non-3GPP networks such as Wi-Fi.

static String

A timer to guard the max attempting time on current SIM slot so that modem will not stuck in current SIM slot for long time.

static String

Flag specifying whether UE should enter Emergency CallBack Mode(ECBM) after E911 call is ended.

static String

Specifies the time by which a call should be set up on the current network once the call is routed on the network.

static String

Specifies the numbers to be dialed over CDMA network in case of dialing over CS network.

static String

Specifies the emergency call domain preference for the home network.

static String

Specifies the emergency call domain preference for the roaming network.

static String

Specifies if LTE is preferred when re-scanning networks after the failure of dialing over NR.

static String

Specifies the preferred emergency network scanning type.

static String

List of CS access network technologies where circuit-switched emergency calls are supported in the roaming network and non-domestic 3rd-party networks.

static String

List of CS access network technologies where circuit-switched emergency calls are supported in the home network and domestic 3rd-party networks.

static String

List of 3GPP access network technologies where e911 over IMS is supported in the roaming network and non-domestic 3rd-party networks.

static String

List of 3GPP access network technologies where e911 over IMS is supported in the home network and domestic 3rd-party networks.

static String

List of different RAT technologies on which emergency call using IMS is supported.

static String

Flag specifying whether QoS preconditions are supported for emergency call setup.

static String

Specifies the maximum time from deciding that an emergency service is to be established until completion of the emergency registration procedure.

static String

Specifies if emergency call shall be attempted on IMS only when IMS is registered.

static String

Specifies if emergency call shall be attempted on IMS over cellular network only when VoLTE is enabled.

static String

Emergency scan timer to wait for scan results from radio before attempting the call over Wi-Fi.

static String

Specifies the condition when emergency call shall be attempted on IMS over Wi-Fi.

static String

The timer to wait for the call completion on the cellular network before attempting the call over Wi-Fi.

static String

Specifies maximum number of emergency call retries over Wi-Fi.

static String

Specifies whether the emergency call shall be preferred over IMS or not irrespective of IMS registration status.

static String

Prefix of all imsemergency.

static String

If emergency calls are only allowed with normal-registered service and UE should get normal service in a short time with acquired band information, telephony expects dialing emergency call will be completed in a short time.

static String

This setting will be specify the wait time for refreshing geolocation information before dialing emergency call.

static String

Flag specifying whether UE would retry E911 call on IMS PDN if emergency PDN setup failed.

static String

Indicates whether limited service only scanning will be requested after VoLTE fails.

static String

Indicates whether the quick cross stack redial timer will be triggered only when the device is registered to the network.

static Int

This values indicates that the cross SIM redialing timer and maximum celluar search timer shall be disabled.

static Int

Modem will attempt to camp on a network with full service only.

static Int

Telephony shall attempt full service scan first.

static Int

No specific preference given to the modem.

static Int

Default value.

static Int

VoWi-Fi emergency call shall be attempted on IMS over Wi-Fi if Wi-Fi network is connected and Wi-Fi calling setting is enabled.

static Int

VoWi-Fi emergency call shall be attempted on IMS over Wi-Fi if Wi-Fi network is connected and Wi-Fi calling is activated successfully.

Constants

DOMAIN_CS

static val DOMAIN_CS: Int

Circuit switched domain.

Value: 1

DOMAIN_PS_3GPP

static val DOMAIN_PS_3GPP: Int

Packet switched domain over 3GPP networks.

Value: 2

DOMAIN_PS_NON_3GPP

static val DOMAIN_PS_NON_3GPP: Int

Packet switched domain over non-3GPP networks such as Wi-Fi.

Value: 3

KEY_CROSS_STACK_REDIAL_TIMER_SEC_INT

static val KEY_CROSS_STACK_REDIAL_TIMER_SEC_INT: String

A timer to guard the max attempting time on current SIM slot so that modem will not stuck in current SIM slot for long time. On timer expiry, if emergency call on the other SIM slot is preferable, telephony shall cancel the emergency call and place the call on the other SIM slot. If this value is set to REDIAL_TIMER_DISABLED, then the timer will never be started and domain selection continues on the current SIM slot. This value should be greater than the value of KEY_EMERGENCY_SCAN_TIMER_SEC_INT. The default value for the timer is 120 seconds.

Value: "imsemergency.cross_stack_redial_timer_sec_int"

KEY_EMERGENCY_CALLBACK_MODE_SUPPORTED_BOOL

Added in API level 33
static val KEY_EMERGENCY_CALLBACK_MODE_SUPPORTED_BOOL: String

Flag specifying whether UE should enter Emergency CallBack Mode(ECBM) after E911 call is ended.

If true: Enter ECBM mode after E911 call is ended. false otherwise.

Value: "imsemergency.emergency_callback_mode_supported_bool"

KEY_EMERGENCY_CALL_SETUP_TIMER_ON_CURRENT_NETWORK_SEC_INT

static val KEY_EMERGENCY_CALL_SETUP_TIMER_ON_CURRENT_NETWORK_SEC_INT: String

Specifies the time by which a call should be set up on the current network once the call is routed on the network. If the call cannot be set up by timer expiry, call shall be re-dialed on the next available network. If this value is set to 0, the timer shall be disabled. The default value for this key is 0.

Value: "imsemergency.emergency_call_setup_timer_on_current_network_sec_int"

KEY_EMERGENCY_CDMA_PREFERRED_NUMBERS_STRING_ARRAY

static val KEY_EMERGENCY_CDMA_PREFERRED_NUMBERS_STRING_ARRAY: String

Specifies the numbers to be dialed over CDMA network in case of dialing over CS network. The default value for this key is an empty string array.

Value: "imsemergency.emergency_cdma_preferred_numbers_string_array"

KEY_EMERGENCY_DOMAIN_PREFERENCE_INT_ARRAY

static val KEY_EMERGENCY_DOMAIN_PREFERENCE_INT_ARRAY: String

Specifies the emergency call domain preference for the home network. The domain selection service shall choose the domain in the order for attempting the emergency call

Possible values are, DOMAIN_CS DOMAIN_PS_3GPP DOMAIN_PS_NON_3GPP. The default value for this key is {DOMAIN_PS_3GPP, DOMAIN_CS, DOMAIN_PS_NON_3GPP}.

Value: "imsemergency.emergency_domain_preference_int_array"

KEY_EMERGENCY_DOMAIN_PREFERENCE_ROAMING_INT_ARRAY

static val KEY_EMERGENCY_DOMAIN_PREFERENCE_ROAMING_INT_ARRAY: String

Specifies the emergency call domain preference for the roaming network. The domain selection service shall choose the domain in the order for attempting the emergency call.

Possible values are, DOMAIN_CS DOMAIN_PS_3GPP DOMAIN_PS_NON_3GPP. The default value for this key is {DOMAIN_PS_3GPP, DOMAIN_CS, DOMAIN_PS_NON_3GPP}.

Value: "imsemergency.emergency_domain_preference_roaming_int_array"

KEY_EMERGENCY_LTE_PREFERRED_AFTER_NR_FAILED_BOOL

static val KEY_EMERGENCY_LTE_PREFERRED_AFTER_NR_FAILED_BOOL: String

Specifies if LTE is preferred when re-scanning networks after the failure of dialing over NR. If not, CS will be preferred. The default value for this key is false.

Value: "imsemergency.emergency_lte_preferred_after_nr_failed_bool"

KEY_EMERGENCY_NETWORK_SCAN_TYPE_INT

static val KEY_EMERGENCY_NETWORK_SCAN_TYPE_INT: String

Specifies the preferred emergency network scanning type.

Possible values are, SCAN_TYPE_NO_PREFERENCE SCAN_TYPE_FULL_SERVICE SCAN_TYPE_FULL_SERVICE_FOLLOWED_BY_LIMITED_SERVICE The default value for this key is SCAN_TYPE_NO_PREFERENCE.

Value: "imsemergency.emergency_network_scan_type_int"

KEY_EMERGENCY_OVER_CS_ROAMING_SUPPORTED_ACCESS_NETWORK_TYPES_INT_ARRAY

static val KEY_EMERGENCY_OVER_CS_ROAMING_SUPPORTED_ACCESS_NETWORK_TYPES_INT_ARRAY: String

List of CS access network technologies where circuit-switched emergency calls are supported in the roaming network and non-domestic 3rd-party networks. The order in the list represents the preference. The domain selection service shall scan the network type in the order of the preference.

Possible values are, AccessNetworkConstants.AccessNetworkType#GERAN AccessNetworkConstants.AccessNetworkType#UTRAN AccessNetworkConstants.AccessNetworkType#CDMA2000 The default value for this key is {AccessNetworkConstants.AccessNetworkType#UTRAN, AccessNetworkConstants.AccessNetworkType#GERAN}.

Value: "imsemergency.emergency_over_cs_roaming_supported_access_network_types_int_array"

KEY_EMERGENCY_OVER_CS_SUPPORTED_ACCESS_NETWORK_TYPES_INT_ARRAY

static val KEY_EMERGENCY_OVER_CS_SUPPORTED_ACCESS_NETWORK_TYPES_INT_ARRAY: String

List of CS access network technologies where circuit-switched emergency calls are supported in the home network and domestic 3rd-party networks. The order in the list represents the preference. The domain selection service shall scan the network type in the order of the preference.

Possible values are, AccessNetworkConstants.AccessNetworkType#GERAN AccessNetworkConstants.AccessNetworkType#UTRAN AccessNetworkConstants.AccessNetworkType#CDMA2000 The default value for this key is {AccessNetworkConstants.AccessNetworkType#UTRAN, AccessNetworkConstants.AccessNetworkType#GERAN}.

Value: "imsemergency.emergency_over_cs_supported_access_network_types_int_array"

KEY_EMERGENCY_OVER_IMS_ROAMING_SUPPORTED_3GPP_NETWORK_TYPES_INT_ARRAY

static val KEY_EMERGENCY_OVER_IMS_ROAMING_SUPPORTED_3GPP_NETWORK_TYPES_INT_ARRAY: String

List of 3GPP access network technologies where e911 over IMS is supported in the roaming network and non-domestic 3rd-party networks. The order in the list represents the preference. The domain selection service shall scan the network type in the order of the preference.

Possible values are, AccessNetworkConstants.AccessNetworkType#NGRAN AccessNetworkConstants.AccessNetworkType#EUTRAN The default value for this key is {AccessNetworkConstants.AccessNetworkType#EUTRAN,

Value: "imsemergency.emergency_over_ims_roaming_supported_3gpp_network_types_int_array"

KEY_EMERGENCY_OVER_IMS_SUPPORTED_3GPP_NETWORK_TYPES_INT_ARRAY

static val KEY_EMERGENCY_OVER_IMS_SUPPORTED_3GPP_NETWORK_TYPES_INT_ARRAY: String

List of 3GPP access network technologies where e911 over IMS is supported in the home network and domestic 3rd-party networks. The order in the list represents the preference. The domain selection service shall scan the network type in the order of the preference.

Possible values are, AccessNetworkConstants.AccessNetworkType#NGRAN AccessNetworkConstants.AccessNetworkType#EUTRAN The default value for this key is {AccessNetworkConstants.AccessNetworkType#EUTRAN,

Value: "imsemergency.emergency_over_ims_supported_3gpp_network_types_int_array"

KEY_EMERGENCY_OVER_IMS_SUPPORTED_RATS_INT_ARRAY

Added in API level 33
static val KEY_EMERGENCY_OVER_IMS_SUPPORTED_RATS_INT_ARRAY: String

List of different RAT technologies on which emergency call using IMS is supported.

Possible values are, AccessNetworkConstants.AccessNetworkType#NGRAN AccessNetworkConstants.AccessNetworkType#EUTRAN AccessNetworkConstants.AccessNetworkType#IWLAN

Value: "imsemergency.emergency_over_ims_supported_rats_int_array"

KEY_EMERGENCY_QOS_PRECONDITION_SUPPORTED_BOOL

Added in API level 33
static val KEY_EMERGENCY_QOS_PRECONDITION_SUPPORTED_BOOL: String

Flag specifying whether QoS preconditions are supported for emergency call setup.

If true: QoS Preconditions are supported. false otherwise.

Reference: 3GPP TS 24.229

Value: "imsemergency.emergency_qos_precondition_supported_bool"

KEY_EMERGENCY_REGISTRATION_TIMER_MILLIS_INT

Added in API level 33
static val KEY_EMERGENCY_REGISTRATION_TIMER_MILLIS_INT: String

Specifies the maximum time from deciding that an emergency service is to be established until completion of the emergency registration procedure. Upon timer expiry, the UE considers the emergency REGISTER request or the emergency call attempt as failed.

Value: "imsemergency.emergency_registration_timer_millis_int"

KEY_EMERGENCY_REQUIRES_IMS_REGISTRATION_BOOL

static val KEY_EMERGENCY_REQUIRES_IMS_REGISTRATION_BOOL: String

Specifies if emergency call shall be attempted on IMS only when IMS is registered. This is applicable only for the case PS is in service. The default value for this key is false.

Value: "imsemergency.emergency_requires_ims_registration_bool"

KEY_EMERGENCY_REQUIRES_VOLTE_ENABLED_BOOL

static val KEY_EMERGENCY_REQUIRES_VOLTE_ENABLED_BOOL: String

Specifies if emergency call shall be attempted on IMS over cellular network only when VoLTE is enabled. The default value for this key is false.

Value: "imsemergency.emergency_requires_volte_enabled_bool"

KEY_EMERGENCY_SCAN_TIMER_SEC_INT

static val KEY_EMERGENCY_SCAN_TIMER_SEC_INT: String

Emergency scan timer to wait for scan results from radio before attempting the call over Wi-Fi. On timer expiry, if emergency call on Wi-Fi is allowed and possible, telephony shall cancel the scan and place the call on Wi-Fi. If emergency call on Wi-Fi is not possible, then domain selection continues to wait for the scan result from the radio. If an emergency scan result is received before the timer expires, the timer shall be stopped and no dialing over Wi-Fi will be tried. If this value is set to 0, then the timer is never started and domain selection waits for the scan result from the radio. The default value for the timer is 10 seconds.

Value: "imsemergency.emergency_scan_timer_sec_int"

KEY_EMERGENCY_VOWIFI_REQUIRES_CONDITION_INT

static val KEY_EMERGENCY_VOWIFI_REQUIRES_CONDITION_INT: String

Specifies the condition when emergency call shall be attempted on IMS over Wi-Fi.

Possible values are, VOWIFI_REQUIRES_NONE VOWIFI_REQUIRES_SETTING_ENABLED VOWIFI_REQUIRES_VALID_EID The default value for this key is VOWIFI_REQUIRES_NONE.

Value: "imsemergency.emergency_vowifi_requires_condition_int"

KEY_MAXIMUM_CELLULAR_SEARCH_TIMER_SEC_INT

static val KEY_MAXIMUM_CELLULAR_SEARCH_TIMER_SEC_INT: String

The timer to wait for the call completion on the cellular network before attempting the call over Wi-Fi. On timer expiry, if emergency call on Wi-Fi is allowed and possible, telephony shall cancel the scan on the cellular network and place the call on Wi-Fi. If dialing over cellular network is ongoing when timer expires, dialing over Wi-Fi will be requested only when the ongoing dialing fails. If emergency call on Wi-Fi is not possible, then domain selection continues to try dialing from the radio and the timer remains expired. Later when calling over Wi-Fi is possible and dialing over cellular networks fails, calling over Wi-Fi will be requested. The timer shall be restarted from initial state if calling over Wi-Fi fails. If this value is set to REDIAL_TIMER_DISABLED, then the timer will never be started. The default value for the timer is REDIAL_TIMER_DISABLED.

Value: "imsemergency.maximum_cellular_search_timer_sec_int"

KEY_MAXIMUM_NUMBER_OF_EMERGENCY_TRIES_OVER_VOWIFI_INT

static val KEY_MAXIMUM_NUMBER_OF_EMERGENCY_TRIES_OVER_VOWIFI_INT: String

Specifies maximum number of emergency call retries over Wi-Fi. This is valid only when DOMAIN_PS_NON_3GPP is included in KEY_EMERGENCY_DOMAIN_PREFERENCE_INT_ARRAY or KEY_EMERGENCY_DOMAIN_PREFERENCE_ROAMING_INT_ARRAY. The default value for this key is 1.

Value: "imsemergency.maximum_number_of_emergency_tries_over_vowifi_int"

KEY_PREFER_IMS_EMERGENCY_WHEN_VOICE_CALLS_ON_CS_BOOL

static val KEY_PREFER_IMS_EMERGENCY_WHEN_VOICE_CALLS_ON_CS_BOOL: String

Specifies whether the emergency call shall be preferred over IMS or not irrespective of IMS registration status. If the value of the config is true then emergency calls shall prefer IMS when device is combined-attached in LTE network and IMS is not registered. If the value of the config is false then emergency calls use CS domain in the same scenario. The default value for this key is false.

Value: "imsemergency.prefer_ims_emergency_when_voice_calls_on_cs_bool"

KEY_PREFIX

Added in API level 33
static val KEY_PREFIX: String

Prefix of all imsemergency.KEY_* constants.

Value: "imsemergency."

KEY_QUICK_CROSS_STACK_REDIAL_TIMER_SEC_INT

static val KEY_QUICK_CROSS_STACK_REDIAL_TIMER_SEC_INT: String

If emergency calls are only allowed with normal-registered service and UE should get normal service in a short time with acquired band information, telephony expects dialing emergency call will be completed in a short time. If dialing is not completed with in a certain timeout, telephony shall place on another SIM slot. If this value is set to REDIAL_TIMER_DISABLED, then the timer will never be started and domain selection continues on the current SIM slot. The timer shall be started for the first trial of each subscription and shall be ignored in the roaming networks and non-domestic networks. The default value for the timer is REDIAL_TIMER_DISABLED.

Value: "imsemergency.quick_cross_stack_redial_timer_sec_int"

KEY_REFRESH_GEOLOCATION_TIMEOUT_MILLIS_INT

Added in API level 33
static val KEY_REFRESH_GEOLOCATION_TIMEOUT_MILLIS_INT: String

This setting will be specify the wait time for refreshing geolocation information before dialing emergency call.

Value: "imsemergency.refresh_geolocation_timeout_millis_int"

KEY_RETRY_EMERGENCY_ON_IMS_PDN_BOOL

Added in API level 33
static val KEY_RETRY_EMERGENCY_ON_IMS_PDN_BOOL: String

Flag specifying whether UE would retry E911 call on IMS PDN if emergency PDN setup failed.

If true: Allow UE to retry emergency call on IMS PDN if emergency PDN setup failed.false otherwise.

Value: "imsemergency.retry_emergency_on_ims_pdn_bool"

KEY_SCAN_LIMITED_SERVICE_AFTER_VOLTE_FAILURE_BOOL

static val KEY_SCAN_LIMITED_SERVICE_AFTER_VOLTE_FAILURE_BOOL: String

Indicates whether limited service only scanning will be requested after VoLTE fails. This value is applicable if the value of KEY_EMERGENCY_NETWORK_SCAN_TYPE_INT is any of SCAN_TYPE_NO_PREFERENCE or SCAN_TYPE_FULL_SERVICE_FOLLOWED_BY_LIMITED_SERVICE. The default value is false.

Value: "imsemergency.scan_limited_service_after_volte_failure_bool"

KEY_START_QUICK_CROSS_STACK_REDIAL_TIMER_WHEN_REGISTERED_BOOL

static val KEY_START_QUICK_CROSS_STACK_REDIAL_TIMER_WHEN_REGISTERED_BOOL: String

Indicates whether the quick cross stack redial timer will be triggered only when the device is registered to the network. The default value is true.

Value: "imsemergency.start_quick_cross_stack_redial_timer_when_registered_bool"

REDIAL_TIMER_DISABLED

static val REDIAL_TIMER_DISABLED: Int

This values indicates that the cross SIM redialing timer and maximum celluar search timer shall be disabled.

Value: 0

SCAN_TYPE_FULL_SERVICE

static val SCAN_TYPE_FULL_SERVICE: Int

Modem will attempt to camp on a network with full service only.

Value: 1

SCAN_TYPE_FULL_SERVICE_FOLLOWED_BY_LIMITED_SERVICE

static val SCAN_TYPE_FULL_SERVICE_FOLLOWED_BY_LIMITED_SERVICE: Int

Telephony shall attempt full service scan first. If a full service network is not found, telephony shall attempt a limited service scan.

Value: 2

SCAN_TYPE_NO_PREFERENCE

static val SCAN_TYPE_NO_PREFERENCE: Int

No specific preference given to the modem. Modem can return an emergency capable network either with limited service or full service.

Value: 0

VOWIFI_REQUIRES_NONE

static val VOWIFI_REQUIRES_NONE: Int

Default value. If ImsWfc#KEY_EMERGENCY_CALL_OVER_EMERGENCY_PDN_BOOL is true, VoWi-Fi emergency call shall be attempted if Wi-Fi network is connected. Otherwise, it shall be attempted if IMS is registered over Wi-Fi.

Value: 0

VOWIFI_REQUIRES_SETTING_ENABLED

static val VOWIFI_REQUIRES_SETTING_ENABLED: Int

VoWi-Fi emergency call shall be attempted on IMS over Wi-Fi if Wi-Fi network is connected and Wi-Fi calling setting is enabled. This value is applicable if the value of ImsWfc#KEY_EMERGENCY_CALL_OVER_EMERGENCY_PDN_BOOL is true.

Value: 1

VOWIFI_REQUIRES_VALID_EID

static val VOWIFI_REQUIRES_VALID_EID: Int

VoWi-Fi emergency call shall be attempted on IMS over Wi-Fi if Wi-Fi network is connected and Wi-Fi calling is activated successfully. The device shall have the valid Entitlement ID if the user activates VoWi-Fi emergency calling successfully. This value is applicable if the value of ImsWfc#KEY_EMERGENCY_CALL_OVER_EMERGENCY_PDN_BOOL is true.

Value: 2