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_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
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
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
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
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
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
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
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