Setting the Emergency Support Number

Setting the Emergency Support Number

To accomplish this feature, three new configurations of Voice Client V9.0.24301 or later have been introduced, and those are not configured through the user interface.
Configuration String
Description
Type
Configuration Value
emergency_numbers
Configures one or multiple emergency numbers.
String
Emergency numbers are followed by commas.
Default: empty
emergency_package_name
Configures the package name associated with broadcast intent.
String
A valid package name
Default: empty
emergency_class_name
Configures the class name associated with Broadcast Intent.
String
A valid broadcast receiver class name.
Default: empty
dial_emergency_number
Either make a call and send or broadcast or only send a broadcast.
True: Initiates a call to the emergency number and activates a broadcast to the third-party service/application.
False: Initiates a broadcast to the third-party service/application.
Default: true
NOTE: The new configuration for dial_emergency_number is available from version 9.0.24403 and later.
A key use case of supporting the emergency number feature is to enable the transmission of a device’s location information to emergency services during an emergency call. This can be achieved by utilizing the intent feature mentioned earlier alongside a third-party service, such as a Critical Incident Management Application, as illustrated in the following diagram.
Emergency
As shown in the following example, one must configure the parameters with valid information to use this feature through PVM, EXM, and XML.
<WFConnect> ... <Profile> . . <emergency_numbers>911,8911,9911</emergency_numbers> <emergency_package_name>package_name</emergency_package_name> <emergency_class_name>class_name</emergency_class_name> <dial_emergency_number >true</dial_emergency_number> .. </Profile> ... </WFConnect>
ADB Command example to configure a single emergency number.
adb shell am start -a wfc.voice.ACTION_UPDATE_CONFIG --es emergency_numbers XYZ --es emergency_package_name PACKAGE_XYZ --es emergency_class_name CLASS_NAME_XYZ --ez dial_emergency_number true
ADB Command example to configure multiple emergency numbers.
adb shell am start -a wfc.voice.ACTION_UPDATE_CONFIG --es emergency_numbers XYZ,ABC --es emergency_package_name PACKAGE_XYZ --es emergency_class_name CLASS_NAME_XYZ --ez dial_emergency_number true
ADB Command example to pass token using intent.
adb shell am start -a android.intent.action.VIEW -d "wfcvp-uat://<token>" com.symbol.wfc.voice
  • Multiple numbers can be configured as emergency numbers.
  • The
    emergency_numbers
    and
    emergency_package_name
    are mandatory parameters to configure.