Worker Duress Configuration

Workcloud Communication PTT Pro for Android Configuration Guide

Worker Duress enables a site manager, for example, a Hospital Ops Manager, Store Manager, or Warehouse Manager can enable their staff to raise an alert through their mobile device when in duress or panic situation. The alert, sent to designated people, shows physical presence information about the affected staff seeking help. If the LAS-friendly name is returned as null or Unknown, the MAC address of the Wi-Fi network to which the user is connected is displayed in the emergency message sent.

Requires PTT Pro 3.3.10094 or later.

Worker Duress Parameters
Parameter	Description	Type	Default Value	Configurable Values
drop_detection_feature_enable	When true, enables Work Duress.	Boolean	1	1 or 0
drop_detection_auto_alert_title	Specifies the title on the first screen when Worker Duress is initiated by Drop Detect. If the specified title length exceeds what can be displayed on a single line, the title is cropped to fit with an ellipsis.	String	Drop Detected	User-specified string.
drop_detection_manual_alert_title	Specifies the title on the first screen when Worker Duress is initiated by the designated key press. When the value is not set or is empty, the title is Duress Detected. If the specified title length exceeds what can be displayed on a single line, the title is cropped to fit with an ellipsis.	String	Duress Detected	User-specified sting.
drop_detection_default_text_message	Specifies the emergency PTT text message sent after the alert time elapses.	String	Empty	User-specified string.
drop_detection_recipient_type	Specifies whether the alert recipient is a group or a user. A value of 1 indicates a group and a value of 0 indicates a user. This value is required when the feature is enabled.	Integer	Empty	1 = group 0 = user
drop_detection_recipient_name	Recipient of the alert message. The value can be a single group or a comma-separated list of users. The group name or user name(s) are case-sensitive and must match the names defined in the PTT Pro Management Portal. A group or user name is required when the feature is enabled.	String	Empty	List of user names or groups.
drop_detection_alarm_duration	Specifies the duration, in seconds, of the alarm on the initiator’s device when an alert is triggered. The value must be greater than 30 seconds and less than 10 minutes (600 seconds). A value less than 30 seconds defaults to 30 seconds and a value greater than 600 seconds defaults to 600 seconds. An invalid value defaults to 30 seconds.	Integer	30 seconds	A minimum value of 30 seconds and a maximum value of 600 seconds.
drop_detection_skip_first_screen	Enables or disables the countdown screen on the initiator’s device. A value of 1 skips the countdown screen and a value of 0 enables the countdown screen.	Boolean	0	0 enables the countdown screen. 1 disables the countdown screen.
drop_detection_show_gps_location	Shows/hides the current GPS location link of the user as part of the emergency message sent. Supports from PTT Pro 3.3.10330 or later.	String	1	0= hides the current GPS location as a link. 1= shows the current GPS location as a link.

Example

The following parameters with valid configuration must be applied to the PTT Pro client via the JSON file. It can also be configured from the

PVM

environment.

{
"drop_detection_feature_enable":"1",
"drop_detection_auto_alert_title": "Free Fall Detected"
"drop_detection_manual_alert_title": "Duress Initiated",
"drop_detection_default_text_message": "Help me! I am in duress",
"drop_detection_recipient_type": "1",
"drop_detection_recipient_name": "Duress.Group",
"drop_detection_alarm_duration": "30",
"drop_detection_skip_first_screen":"0"
"drop_detection_show_gps_location ":"1"
}

Apply Config on Android 10 & below:

adb push WFCPTTProDefault.json /sdcard/
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_DEFAULT_CONFIG --es "configpath" "/sdcard/WFCPTTProDefault.json"

Applying the configuration to Android 11 and above:

adb push WFCPTTProDefault.json /enterprise/device/settings/pttpro/
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_DEFAULT_CONFIG --es "configpath"
"/enterprise/device/settings/pttpro/WFCPTTProDefault.json"

ADB command to apply the configuration:

adb shell am start -a android.intent.action.VIEW -d "wfctp-uat://<TOKEN>" com.symbol.wfc.pttpro

The device GPS location should be enabled to fetch the connected WIFI BSSID. (

Settings

Location (Security and Location)

Location

If the device location is disabled or location permission is not granted to the PTT Pro client, the Client does not share the current location link, regardless of the

drop_detection_show_gps_location

value.