PTT Pro 3 - Zebra Technologies

Zebra PTT ProVersion 3.3.10155

Workforce Connect

User Guide for Android

MN-003555-10 Rev A

Copyright

ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in manyjurisdictions worldwide. Google, Android, Google Play and other marks are trademarks of Google LLC. Allother trademarks are the property of their respective owners. ©2021 Zebra Technologies Corporation and/or its affiliates. All rights reserved.

Information in this document is subject to change without notice. The software described in this documentis furnished under a license agreement or nondisclosure agreement. The software may be used or copiedonly in accordance with the terms of those agreements.

For further information regarding legal and proprietary statements, please go to:

SOFTWARE: zebra.com/linkoslegal.COPYRIGHTS: zebra.com/copyright.WARRANTY: zebra.com/warranty.END USER LICENSE AGREEMENT: zebra.com/eula.

Terms of Use

Proprietary Statement

This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries(“Zebra Technologies”). It is intended solely for the information and use of parties operating andmaintaining the equipment described herein. Such proprietary information may not be used, reproduced,or disclosed to any other parties for any other purpose without the express, written permission of ZebraTechnologies.

Product Improvements

Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs aresubject to change without notice.

Liability Disclaimer

Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals arecorrect; however, errors do occur. Zebra Technologies reserves the right to correct any such errors anddisclaims liability resulting therefrom.

Limitation of Liability

In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of theaccompanying product (including hardware and software) be liable for any damages whatsoever (including,without limitation, consequential damages including loss of business profits, business interruption, or lossof business information) arising out of the use of, the results of use of, or inability to use such product, evenif Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allowthe exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion maynot apply to you.

http://www.zebra.com/linkoslegal

http://www.zebra.com/copyright

http://www.zebra.com/warranty

http://www.zebra.com/eula

Contents

About this Guide.............................................................................................................................................. 8

Chapter Descriptions..............................................................................................................................8

Notational Conventions......................................................................................................................... 9

Related Documents................................................................................................................................ 9

Icon Conventions................................................................................................................................... 10

Service Information................................................................................................................................10

Revision History......................................................................................................................................10

Getting Started................................................................................................................................................12

Data Usage (Cellular Networks)........................................................................................................ 12

Group Types and Maximum List Sizes............................................................................................ 12

User Interface..................................................................................................................................................14

Navigation................................................................................................................................................ 15

Navigate Using the Tab Bar....................................................................................................... 15

Navigate Using the Navigation Drawer................................................................................... 18

Sample Screens..............................................................................................................................19

Indicators.................................................................................................................................................. 21

Contact Presence Indicators.......................................................................................................21

Group Presence Indicators.........................................................................................................22

Notification Bar Indicators.......................................................................................................... 23

In Call Viewing Options...................................................................................................................... 23

In Call List View.............................................................................................................................23

In Call Map View...........................................................................................................................23

Landscape Mode...................................................................................................................................23

3

Contents

PTT Calling......................................................................................................................................................26

One-to-One PTT Calls......................................................................................................................... 26

Ad Hoc PTT Calls................................................................................................................................. 28

Alert Calls................................................................................................................................................29

Alert Call from the Contacts Tab............................................................................................. 29

Alert Call from the Maps Tab....................................................................................................30

Responding to an Alert Call.......................................................................................................33

Non-Response on Alert Call...................................................................................................... 33

Group PTT Calls.................................................................................................................................... 34

Emergency Calls....................................................................................................................................35

Configure PTT Group and Users for Emergency Calls.......................................................36

Initiating an Emergency Call...................................................................................................... 38

In Call Operation...................................................................................................................................40

Responding to a Call............................................................................................................................ 41

Call Notifications.....................................................................................................................................41

Sending Messages.........................................................................................................................................42

Message Encryption.............................................................................................................................42

Messaging to Contacts........................................................................................................................42

Messaging to Groups.......................................................................................................................... 46

Viewing and Responding to Messages.......................................................................................... 47

View Messages.............................................................................................................................. 47

Respond to Messages.................................................................................................................48

Message of the Day............................................................................................................................ 50

Enable Image and Audio Messaging....................................................................................... 51

Send a Message of the Day......................................................................................................52

Options and Management............................................................................................................................54

Do Not Disturb.......................................................................................................................................54

Block Calls from Select Groups................................................................................................ 57

Block Calls from Select Contacts............................................................................................. 57

Group Member List.............................................................................................................................. 59

Late Join and Re-Join......................................................................................................................... 59

4

Contents

Talker Override and Preemption......................................................................................................59

Call Override.......................................................................................................................................... 60

Call Override on 1:1 and Ad hoc Calls.................................................................................... 60

Call Override on Group Calls (by Calling Individual User(s)).............................................60

Call Override on Group Calls (by Calling Group).................................................................60

Contact Management.......................................................................................................................... 60

Single Contact................................................................................................................................60

Multiple Contacts............................................................................................................................61

Favorites.......................................................................................................................................... 62

Group Management............................................................................................................................. 63

Favorites Groups........................................................................................................................... 64

Searching Contacts on the Device or Server...............................................................................65

Location Based Services...............................................................................................................................66

Live Tracking Mode............................................................................................................................. 66

Sending Location Information................................................................................................... 66

Location Enable and Disable.....................................................................................................67

Viewing Location Information....................................................................................................68

Viewing Live In-Call Location Information............................................................................. 69

Place a PTT Call from the Map........................................................................................................ 69

Place an Ad hoc Call to One or More Contacts from the Map................................................ 70

Create a Group from the Map............................................................................................................71

Map Options........................................................................................................................................... 72

Cluster Start Threshold................................................................................................................72

Map Gestures................................................................................................................................. 73

Map Presence Indicators.............................................................................................................74

Indoor Location Service...................................................................................................................... 74

Voice Commands........................................................................................................................................... 76

About Voice Commands.....................................................................................................................76

PTT Button Configuration and Function................................................................................. 76

Enabling Voice Commands................................................................................................................ 77

Voice Command Activity Screen.............................................................................................. 79

5

Contents

Supported Voice Commands............................................................................................................ 80

Locating a Contact........................................................................................................................ 81

Talking to a Contact, Group, or Default Callee..................................................................... 81

Messaging a Contact, Group, or Default Callee................................................................... 81

Managing Messages.................................................................................................................... 86

Localized Voice Commands.............................................................................................................. 88

Czech Voice Commands............................................................................................................ 88

Dutch Voice Commands.............................................................................................................90

French Voice Commands............................................................................................................ 91

French Canadian Voice Commands........................................................................................92

German Voice Commands......................................................................................................... 93

Hungarian Voice Commands.....................................................................................................94

Italian Voice Commands.............................................................................................................95

Polish Voice Commands.............................................................................................................96

Russian Voice Commands..........................................................................................................97

Slovak Voice Commands............................................................................................................99

Spanish Voice Commands........................................................................................................100

Swedish Voice Commands........................................................................................................101

Voice Command Error Conditions................................................................................................. 102

Worker Duress and Drop Detect............................................................................................................... 103

Requirements and Configuration for Worker Duress................................................................103

JSON Configuration Elements................................................................................................. 103

Intent to Trigger Worker Duress through a Key Press...................................................... 107

Intent to Trigger Worker Duress through Drop Detect.....................................................108

Stage Now and MX Deployment............................................................................................ 109

Worker Duress Feature Workflow................................................................................................... 110

Sending a Duress Alert.............................................................................................................. 110

Receiving a Duress Alert............................................................................................................112

Duress and Do Not Disturb...............................................................................................................114

Device Settings..............................................................................................................................................117

User Account Information.................................................................................................................. 117

6

Contents

Access Application Settings.............................................................................................................. 118

General Settings........................................................................................................................... 119

Notification Settings.................................................................................................................... 123

Default Sound Profile................................................................................................................. 124

Headset Sound Profile...............................................................................................................126

Voice Command Configuration............................................................................................... 129

FAQ & Troubleshooting...............................................................................................................................130

What devices does Zebra PTT Pro for Android support?........................................................130

What Headsets Does Zebra PTT Pro Support?........................................................................... 131

Supported Languages........................................................................................................................132

FAQ.......................................................................................................................................................... 133

Troubleshooting............................................................................................................................................134

7

About this GuideAbout this Guide

This guide describes the installation, activation, and configuration of Workforce Connect (WFC) Zebra PTTPro for Android. Features and operation of each application are described separately in correspondingguides. See Related Documents for a list of guides.

NOTE: Screens and windows pictured in this guide are samples and can differ from actualscreens.

Chapter DescriptionsTopics covered in this guide are as follows:

• Getting Started describes this document.

• User Interface describes the user interface, which includes tabs for Map, Recent calls and messages,Favorites, Contacts, and Groups.

• PTT Calling provides information on placing and managing barge calls, ad hoc calls, alert calls, andgroup calls.

• Sending Messages provides information on text and image messaging.

• Location Based Services provides information on the multiple options available for location tracking andmapping services.

• Options and Management provides information on voice commands, various operating options, andcontact and group management.

• Voice Commands provides information about using voice commands.

• Worker Duress provides information regarding the configuration and use of the Worker Duress feature.

• Device Settings provides information on device settings such as application and sound settings andaccount information.

• FAQ & Troubleshooting provides answers to frequently asked questions and solutions fortroubleshooting issues.

8

About this Guide

Notational ConventionsThe following conventions are used in this document:

• Bold text is used to highlight the following:

• Dialog box, window, and screen names

• Drop-down list and list box names

• Checkbox and radio button names

• Icons on a screen

• Key names on a keypad

• Button names on a screen

• Bullets (•) indicate:

• Action items

• List of alternatives

• Lists of required steps that are not necessarily sequential.

• Sequential lists (for example, those that describe step-by-step procedures) appear as numbered lists.

Related Documents• Zebra PTT Pro for Android Quick Start Guide—Describes procedures for the most common tasks, in a

two-sided single page printable format.

• Zebra PTT Pro Installation Guide—Describes the installation and activation of all Zebra PTT Proapplications.

• Zebra PTT Pro Management Portal Customer Administrator Guide—Describes the portal, whichprovides an interface for customer administrators or technical representatives to manage anorganization's Zebra PTT Pro accounts.

• Workforce Connect Zebra PTT Pro for Android Programmer Guide—Describes the intents and actionsfor the configuration and programming of Zebra PTT Pro for Android.

• Workforce Connect Zebra PTT Pro Task Tracker Customer Administration Guide—Describes theconfiguration and use of Task Tracker.

• Zebra PTT Pro for iOS Quick Start Guide—Describes procedures for the most common tasks, in a two-sided single page printable format.

• Zebra PTT Pro for iOS User Guide—Describes Zebra PTT Pro for iOS features and operation.

• Zebra PTT Pro Dispatch User Guide—Describes Zebra PTT Pro Dispatch features and operation.

For the latest version of this guide and all guides, go to: zebra.com/support.

9

http://www.zebra.com/support.

About this Guide

Icon ConventionsThe documentation set is designed to give the reader more visual clues. The following graphic icons areused throughout the documentation set.

NOTE: The text here indicates information that is supplemental for the user to know and that isnot required to complete a task.The text here indicates information that is important for the userto know.

IMPORTANT: The text here indicates information that is important for the user to know.

CAUTION: If the precaution is not heeded, the user could receive a minor or moderate injury.

WARNING: If danger is not avoided, the user CAN be seriously injured or killed.

DANGER: If danger is not avoided, the user WILL be seriously injured or killed.

Service InformationIf you have a problem with your equipment, contact Zebra Global Customer Support for your region.Contact information is available at: zebra.com/support.

When contacting support, please have the following information available:

• Serial number of the unit

• Model number or product name

• Software type and version number

Zebra responds to calls by email, telephone, or fax within the time limits set forth in support agreements.

If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment forservicing and will be given specific directions. Zebra is not responsible for any damages incurred duringshipment if the approved shipping container is not used. Shipping the units improperly can possibly voidthe warranty.

If you purchased your Zebra business product from a Zebra business partner, contact that business partnerfor support.

Revision HistoryChanges to the original guide are listed below:

Change Date Description

Rev A -01 May 2019 Initial Release.

Rev A -02 October 2019 Add screen shots for EC30.

Rev A -03 December 2019 Updated screen shots to reflect revised navigation drawericons. In “Talk to a Contact or Group” section, revised text from

10

https://www.zebra.com/support

About this Guide

<username> to <username or FirstName LastName>. (<FirstNameLastName> is also known as the Friendly Name.)

Rev A -04 March 2020 Updated to reflect new icons and list of supported languages.

Rev A -05 May 2020 Added Friendly Access Point and voice command information.

Rev A -06 September 2020 User interface enhancements, voice command features,notification bar enhancements.

Rev A -07 November 2020 Landscape mode for tablets, voice command updates, newbehavior for PTT button.

Rev A -08 March 2021 Voice command updates and supported accessories.

Rev A -09 June 2021 New Worker Duress feature. New headset support.

Rev A -10 November 2021 Added description for Drop Detect and Emergency Call features.New language support for Voice Commands.

11

Getting StartedGetting Started

The Workforce Connect Zebra PTT Pro solution provides a reliable, full featured, instant communicationservice leveraging 3G, LTE, and WiFi networks that includes three core areas of operation.

• Push To Talk (PTT) Voice

• Secure group messaging (text and images)

• Location tracking and mapping

Zebra PTT Pro for Android includes support for the following device types:

• Consumer smartphone devices

• Enterprise mobile devices.

NOTE: PTT Express cannot be activated on a device where Zebra PTT Pro is being used. Contactyour system administrator for assistance.

Data Usage (Cellular Networks)Zebra PTT Pro is a VoIP application that, for cellular network connections, requires a data plan. Ascompared with other video and image communication applications, Zebra PTT Pro requires minimal data.It uses a variable rate Voice CODEC technology so improved voice quality is delivered to users with betterdata service.

Zebra PTT Pro data can be estimated as follows, however, note that the results may vary.

Monthly system overhead: 6MB

Active PTT talk time (when voice is broadcast on a PTT call):

• Smartphone connected via 3G: 6MB per hour

• Smartphone connected via 4G: 8MB per hour.

Group Types and Maximum List SizesMultiple types of groups exist, and each type has different characteristics related to members, calloriginator, and so on. Zebra PTT Pro supports the following types of groups:

Personal Groups (size limit 250)Created by a user and only visible from the creator's Group List. Only the creator can initiate a callto a Personal Group.

12

Getting Started

Member Groups (size limit 250)Visible in all member's Group Lists. Any member of the group can initiate a call to the group.

Enterprise Open Groups (size limit 250)Available for any user to join. The owner or manager of the group may or may not be a participantin the group and there may be more than one Group Manager.

Enterprise Closed Groups (size limit 250)Created by any user. Only the owner or manager can add Members. The owner or manager ofthe group may or may not be a participant in the group and there can be more than one GroupManager.

Enterprise Dispatch Groups (size limit 250)These groups have definable time of day or day of week shifts associated with them. The membersof the group can change for each shift. The owner or manager of the Group may or may not be aparticipant in the Group and there can be more than one Group Manager. Users with a DispatchGroup in their Group List can call the group and to route it to members of the group that are on shiftat the time.

Broadcast Groups (size limit 60,000)Broadcast Groups are used to deliver high priority messages. Broadcast Group calls are highpriority unicast voice messages. Broadcast messages are resent until all messages are delivered.Only Primary or Secondary Administrators can create this group.

Law Enforcement Surveillance Channel (size limit 250)Surveillance Channel Groups are used by Law Enforcement personnel whose typical profilerequires long calls that cannot be automatically ended after brief periods of inactivity.

Public Safety Unicast Channel (size limit 250)Provide a means for Public Safety agencies to broadcast important audio feeds, such as NOAAWeather, Air Traffic Control, and any LMR network in a monitor only mode.

Adhoc Groups (size limit 250)Not pre-configured groups, but a selection of multiple contacts from the Contact List. Highlight theContacts and press the PTT button to establish a call.

NOTE: When an administrator uses WFC Profile Manager, the device can display friendly groupnames. When this occurs, underscores in the group name are replaced with spaces and the firstletter of each word in the name is capitalized.

13

User InterfaceUser Interface

Navigation of the Zebra PTT Pro user interface is performed using either the Tab Bar or the NavigationDrawer.

The user interface includes the following tabs or drawer options, which can be accessed on most screens:

• Map: Displays the location of all active users if they have enabled location reporting.

• Recent: Displays call and message history, both made and received.

• Favorites: Displays a user-defined list of contacts and groups to speed access.

• Contacts: Displays a list of all contacts with a presence indicator for each.

• Groups: Displays a list of all groups with a presence indicator for each.

• Voice: Switches to the WFC Voice application if installed. Refer to the Workforce Connect Zebra PTTPro Management Portal Administrator Guide (Configure App Switcher User Setting) to configure this tab.

The Contacts, Groups, Messages, and Recent tabs include context-sensitive menus invoked by pressingand holding items within the tab.

For Android Open Source Project (AOSP) devices:

• The Map icon does not display (regardless of the Show Map on Client feature key setting in theManagement Portal).

For Google Mobile Services (GMS) devices:

• The Map icon displays as long as it is enabled through the Show Map on Client feature key setting inthe Management Portal with the up-to-date Google Play Service.

NOTE: After completing any activity, the user is returned to the default screen as specified in theDefault Tab View field on the Modify Feature Keys window in the Zebra PTT Pro ManagementPortal. The default can be changed to Contacts, Groups, Messages, Map, or Recent Calls.

14

User Interface

NavigationThe user interface makes it easy to navigate using the Tab Bar or the Navigation Drawer.

Navigate Using the Tab Bar

The Tab Bar is enabled by default. Tap an icon in the Tab Bar to display the corresponding screen.

Tab Icons

Icons Description

Map (only available on devices with Google Mobile Services)

Recent (call and message history)

Favorites (user selected contacts and groups)

Contacts (place finger on the Contacts list and pull down to refresh)

Groups (place finger on the Groups list and pull down to refresh)

Navigation Drawer (switch views, Do Not Disturb, Settings)

Push To Talk (Tap to make a call)

Text, audio, or video message

Voice (Opens WFC Voice application if configured)

Search

Table 1 Tab Icons

15

User Interface

Figure 1 Contacts with Tab Bar Enabled

Hide the Tab Bar

Users who wish to use the Navigation Drawer can hide the Tab Bar from the Settings menu

1. Tap the Navigation Drawer .

2. Select Settings > General.

16

User Interface

3. Locate the Hide Tabs setting and tap to enable.

Figure 2 Hide Tabs Setting

17

User Interface

Navigate Using the Navigation Drawer

The Navigation Drawer can be used in addition to or instead of the Tab Bar.

• Tap the Navigation Drawer and select an available option to display the corresponding screen.

Figure 3 Navigation Drawer Options

18

User Interface

Sample Screens

Table 2 Interface Screens for Zebra PTT Pro

19

User Interface

Table 2 Interface Screens for Zebra PTT Pro (Continued)

20

User Interface

Table 2 Interface Screens for Zebra PTT Pro (Continued)

IndicatorsPresence is supported for individual contacts and groups. Group Presence indicates whether a group callis available for Late Join. Contact Presence is used for individual contacts.

Contact Presence Indicators

Icon Description

Contact is available.

Table 3 Contact Presence Indicators

21

User Interface

Icon Description

Contact is on a call.

Contact is in Do Not Disturb (DnD) mode.

Contact is in silent/vibrate mode.

Contact’s device is off or out of coverage area.

Contact’s device is signed out of Zebra PTT Pro.

Contact is blocked.

Contact is not responding to Zebra PTT Pro communication.

Contact has location functionality enabled - touch to see the contact’s location onthe map.

Table 3 Contact Presence Indicators (Continued)

Group Presence Indicators

Icon Description

Group is available.

Group member is speaking.

Group is blocked.

Table 4 Group Presence Indicators

22

User Interface

Notification Bar Indicators

Icon Description

Client is online.

Client is in DnD mode.

Client is offline.

New message is available.

Missed call.

Table 5 Notification Bar Indicators

In Call Viewing OptionsOnce a Zebra PTT Pro call is established, the user can view a list of all call participants. The Sound Waveicon indicates which call member is speaking. In order to access the map view, the user must have a GMSdevice. In map view, location is updated in real time.

In Call List View

• All call participants appear in the list.

•indicates the speaking participant.

In Call Map View

• All call participants with location enabled appear on the map.

• A blue dot indicates the owner (self).

• Green pins indicated call participants.

• In call locations are updated every two seconds.

Landscape ModeZebra PTT Pro supports landscape mode. Landscape mode provides a larger view when using Zebratablets for PTT.

The user must set the Allowed Screen Orientation setting to Landscape to enable the Landscapeorientation.

23

User Interface

Figure 4 Recent Screen in Landscape Mode

Figure 5 Contact Screen with Contact Selected and PTT Button

24

User Interface

Figure 6 Settings Screen in Landscape Mode

25

PTT CallingPTT Calling

This chapter provides information on placing and managing PTT calls, alert calls, and group calls.

On Zebra devices, the user can use the physical device PTT button or the on-screen button when placingPTT calls. If the user has a supported headset accessory, the user can use the physical PTT button on theheadset and speak into the microphone.

The user can also use the physical device PTT button to reject an incoming PTT call. During a call with twoor more participants, a user in the call can end their participation using the physical device PTT button. Theuser must double-click the physical device PTT button to reject a call or end their participation. The double-click action is also supported on approved Zebra wired headsets.

One-to-One PTT CallsTo make a one-to-one PTT call, select a recipient from the Contacts list.

26

PTT Calling

1. Tap the Contacts tab.

Figure 7 Select a Contact for a one-to-one PTT Call

2. Locate the contact:

• Scroll through the list of contacts.

• Perform a search by selecting the magnifying glass.

When searching, begin entering the contact name. As each letter is entered, the relevant matches aredisplayed in the contact list. Keep entering until a match is found. The contact search string is a “sticky”search, meaning that the letters entered remain in the search field until cleared. Entering a stringwithout a match will cause no contacts to be displayed. Clear the search string to review all contacts.

3. Select the desired contact by tapping the contact name.

4. Press and hold Push To Talk.

5. Upon hearing the grant tone, begin speaking.

6. Release Push To Talk when finished.

27

PTT Calling

Ad Hoc PTT CallsAn ad hoc call is one made to multiple contacts or a temporary group, with a specific purpose in mind. Usethe ad hoc calling feature when a group containing the contacts needed for the call is not available.


2. Select two or more (up to 250) recipients from the Contacts list.

Figure 8 Select Contacts for Ad Hoc PTT Call




28

PTT Calling

Alert CallsZebra PTT Pro supports one-to-one alert calls, used for non-critical communication by alerting the recipientrather than barging in on a call. This allows the user to respond when they are available. Initiate alert callsfrom the Contact list or the Map tab.

Alert Call from the Contacts Tab

To make an alert call:


2. Select the desired contact.

Locate the contact by scrolling through the list of contacts, or perform a search by selecting themagnifying glass icon. After selecting the magnifying glass icon, begin entering the contact name. Aseach letter is entered, the relevant matches are displayed in the contact list. Keep entering until a matchis found. The contact search string is a “sticky” search, meaning that the letters entered remain in thesearch field until cleared. Entering a string without a match will cause no contacts to be displayed. Clearthe search string to review all contacts.

3. Press and hold the contact to open the secondary menu.

Figure 9 Secondary Menu

29

PTT Calling

4. Select Alert Call.

Figure 10 Contact Alert

When the contact accepts, the user is placed in the call. To cancel the call while waiting for a response,select Cancel Alert.

Alert Call from the Maps Tab

1. Tap the Map tab.

30

PTT Calling

2. Tap the desired contact to display the contact’s name.

Figure 11 Contact Selected on Map

31

PTT Calling

3. Tap the contact’s name to display the contact data.

Figure 12 Contact Data

32

PTT Calling

4. Tap WFC PTT Pro Alert Call to initiate the call.

Figure 13 Alert Call

When the contact accepts, the user is placed in the call. To cancel the call while waiting for a response,select Cancel Alert.

Responding to an Alert Call

1. When an incoming call alert is received, select Answer to accept the call or Ignore to reject the call.

2. After accepting the alert call, press the Push To Talk button to begin speaking and release whenfinished.

Non-Response on Alert Call

The user is notified when the contact is unavailable or cannot accept the call. The length of time the alertcall lasts before displaying this message is variable and depends on user settings.

33

PTT Calling

Figure 14 Contact Not Responding

If the contact does not answer the call, select Send Message to send a text message to the contact, orCancel to dismiss the message and end the call.

Group PTT CallsTo place a group PTT call, tap the Groups tab and then select a group from the Group list.

34

PTT Calling

1. Tap the Groups tab.

Figure 15 Select Group

2. Select the desired group.




Emergency CallsZebra PTT Pro supports emergency calls, which are routed to a specific PTT group designated as theemergency group.

Emergency calls can be initiated through an onscreen button or a physical button depending on theapplication and device configuration.

A PTT Pro emergency call may also be originated by sending the Emergency Call intent from anotherAndroid application. Refer to the PTT Pro Android Programmer’s guide for the intent format and operationof the client. The intent can be generated using StageNow as described at https://techdocs.zebra.com/mx/intent/. The intent can be sent immediately, scheduled, or triggered by pressing a button or sensor.

NOTE:

• The emergency call will be started or ended immediately upon receipt of the intent by ZebraPTT Pro.

35

https://techdocs.zebra.com/mx/intent/


PTT Calling

• If a PTT Pro call is active when this intent is sent, WFC Voice will end the active PTT Pro callbefore initiating the emergency call.

• When ending the emergency call through this intent, the emergency call will be ended, butthe PTT Pro call will not be ended. The user will need manually to end the PTT call to exit fromthe current PTT Pro call session.

Configure PTT Group and Users for Emergency Calls

Create a PTT group for emergency calls. Add users to the group who can initiate and receive emergencycalls.

Access to the PTT Pro Management Portal.

1. Log in to the PTT Pro Management Portal.

2. Select the Groups tab and create a group used for emergency calls.

Personal groups created on a device cannot be used for emergency calls.

3. Select the emergency group click the Members tab.

4. Click Add to choose and add contacts to the group.

5. Select the Users tab in the PTT Pro Management Portal.

6. Click on a user you want to configure for emergency calls and select Edit Client Settings.

36

PTT Calling

7. Select the Emergency tab.

8. Use the Emergency Group drop-down menu to select the emergency group.

NOTE: The Emergency Group drop-down menu only lists groups to which the user waspreviously added to.

9. Set the Start Hold Time and Cancel Hold Time to configure how long a user needs to press and holdthe emergency button to initiate an emergency call or cancel an emergency call.

The default value is 3,000 milliseconds (3 seconds).

10. Click Submit to finish the emergency group configuration.

Each user added to the emergency group will see an EMERGENCY call soft button on their device screen.

37

PTT Calling

Initiating an Emergency Call

Emergency calls can be initiated by an onscreen button or a physical button depending on the applicationand device configuration.

1. Press and hold the EMERGENCY button to initiate an emergency call.

The emergency call is routed to all members of the emergency group.

38

PTT Calling

2. Press and hold Push To Talk to speak to the group.

39

PTT Calling

3. Call recipients can press and hold Push To Talk to respond to the emergency call.

4. To end the call, press and hold Cancel on the Emergency Call Active pop-up and then touch LeaveCall.

Recipients of an emergency call cannot leave the call until after the initiator cancels the call.

In Call OperationDuring a PTT call:

• All participants on the call appear on the List.

•The sound wave icon indicates the speaking participant.

• To request to speak, press and hold Push To Talk.

• Upon hearing the grant tone, begin speaking.

• Release Push To Talk when finished speaking.

40

PTT Calling

• To change from the speakerphone to the device earpiece when on a call, press the Speaker/

Earpiece Toggle menu button and then press Earpiece. To change from the earpiece to thespeakerphone press the Speaker/Earpiece Toggle again.

The default is set by the Application Setting Start call with Speakerphone. If enabled, calls start with thespeakerphone. Otherwise, the earpiece is used.

To exit the call tap End Call.

Responding to a CallWhen the user receives a call:

1. After a voice is heard from an incoming call, press Push To Talk to begin speaking.


To ensure the user receives Zebra PTT Pro calls during the device’s sleep or suspend state, verify thatthe Android Keep Wi-Fi on during sleep setting is set to Always. This setting can be found in the Wi-FiAdvanced settings. This is particularly important for devices without wide area connectivity.

Call NotificationsZebra PTT Pro can display a notification for an incoming call when the application is in the background.The user can tap on the notification to respond to the call, either by speaking or by leaving the call. Thesetting Foreground app on Call must be disabled to display notifications for incoming calls.

Figure 16 Notification for an Incoming Call

41

Sending MessagesSending Messages

This sections provides information on text and image messaging using Zebra PTT Pro.

Message EncryptionZebra PTT Pro version 3.3.10094 and later do not encrypt messages stored on the following Zebra devicemodels.

• MC40N0

• MC67

• TC55

• TC700H

• TC75

• TC8000

• WT6000

• ET5X

• TC51

• TC56

• TC700K

• TC75X

• VC80X

• MC330M

• TC20

• TC25

Messages are encrypted during transmission and when stored on the PTT Pro Server. Messages stored ona device are only accessible through the Zebra PTT Pro application.

Messaging to ContactsNOTE: Audio and video messages require an Interworking Gateway (IWG) server and the IWGsettings configured on the Zebra PTT Pro client.

42

Sending Messages


2. Select the desired contact..

Locate the contact by scrolling through the list of contacts, or perform a search by selecting themagnifying glass icon. After selecting the magnifying glass icon, begin entering the contact name. Aseach letter is entered, the relevant matches are displayed in the contact list. Keep entering until a matchis found. The contact search string is a “sticky” search, meaning that the letters entered remain in thesearch field until cleared. Entering a string without a match will cause no contacts to be displayed. Clearthe search string to review all contacts.

Figure 17 Select Contact

3.Tap Message

43

Sending Messages

4. Enter the message text.

Figure 18 Type or Record a Message

5. (Optional) Select additional message recipients by tapping on the additional name(s) desired.

44

Sending Messages

6. (Optional) Add a photo, image, video, audio, or speech to text to the message by selecting .

Figure 19 Attach Media to Message

• Select Camera to take a picture using the device camera.

• Select Gallery and select an image from the device.

• Tap to rotate right or to rotate left.

• Tap to remove changes made to the image.

• Tap to remove the image.

• Select Video to record video using the device camera.

• Select Audio to record audio using the device microphone.

• Select Speech to Text to record a message.

7. Tap Send.

45

Sending Messages

Messaging to GroupsTo send a group message:

1. Tap the Groups tab.

2. Select the desired group, and then tap the Message icon

Figure 20 Select Group and Message

3. (Optional) Add video, audio, image, photo, or speech to text to the message by selecting .









4. Tap Send.

46

Sending Messages

Viewing and Responding to MessagesTo see all messages received and sent, tap the Recent tab . The Recent tab icon indicates whether allmessages received have been seen, or read.

Icon Description

All messages received have been seen or read.

One or more messages received have not been seen or read.

Table 6 Recent Tab Icons

View Messages

1. Select the Recent tab. A list of the contacts and groups with which the user has exchanged messagesor calls appears. A blue icon on the right edge indicates the number of unread messages.

Figure 21 Recent Messages and Calls

47

Sending Messages

2. Messages are organized contact or group, with the most recent message at the top of the screen.To read a message, tap the contact or group name— sent messages are indented from receivedmessages.

Messages that have not been read or heard are indicated by the presence of a red bar: messages thatthe user has read or heard are indicated by a blue bar.

An incoming message includes an arrow at the bottom. Tap the arrow to display the full content of themessage.

Figure 22 Message Status

Icon Description

Message delivered to some or all users and read by some or all users.

Message delivered to some or all users and not read by any users.

Message not delivered to any users and not read by any users.

Table 7 Message Status Icons

Respond to Messages

1. Tap the message to select.

48

Sending Messages

2. Tap the ellipses for message options.

Figure 23 Message Options Menu

49

Sending Messages

3. Select Mark All as Seen, Reply, Forward, Copy, or TTS.

NOTE: Mark All as Seen appears when a single message is selected.

Figure 24 Message Options

4. To reply to the message, select Reply.

5. Type a response and Send the message.

Message of the DayMessage of the Day (MOTD) allows the user to create, attach, and send an audio or video file with a textmessage to a list of recipients. When the recipients log on, or when the message is received, the attachedmedia file is played on the recipient’s device.

NOTE: An administrator must enable the MOTD feature.

50

Sending Messages

Enable Image and Audio Messaging

1. Tap the Navigation Drawer .

2. Select Settings > General.

Figure 25 Enable Server Information

51

Sending Messages

3. Under Server specify the following information:

a) Tap Server URL and enter the server URL.

b) Tap to Enable IWG.

c) Tap API Token and enter the API token.

d) Tap HTTP Upload Method and select POST or PUT.

The video and audio options now appear in the attachment sub-menu.

Figure 26 Video and Audio Enabled

Send a Message of the Day

1. Tap the Contacts or Groups tab.

52

Sending Messages

2. Select the desired contact or group, and then tap . The attachment sub menu displays.

Figure 27 Video and Audio Options









53

Options and ManagementOptions and Management

This chapter provides information on voice commands as well as contact and group management.

Do Not DisturbZebra PTT Pro supports Global Do Not Disturb (DnD) that prevents receiving PTT calls. To activate DnDmode:

1. Tap the Navigation Drawer icon.

54

Options and Management

2. Tap Online to change the status to Do not Disturb.

Figure 28 User is Online

1 Indicator shows that the user is online.

55


2 Notification bar indicates the user is online.

The Zebra PTT Pro icon in the device notification bar indicates if the device is in DnD mode.

Figure 29 User in DnD Mode

1 Do not disturb (DnD) is enabled.

2 Notification bar indicates the user is in DnD mode.

The ability to enable DnD on the device is controlled in the Client Settings in the PTT Pro ManagementPortal.

56


Block Calls from Select Groups

This feature allows a user to disable the reception of calls from any group.

To disable the reception of calls from a group:

1. Select the Groups tab.

2. Press and hold a group. In the secondary menu select Block Calls. The group icon changes to indicatethat the reception of calls from that group is disabled.

Figure 30 Group Blocked

Callout Description

1 Blocked group.

2 Block group menu option.

To re-enable the reception of calls from the group, press and hold the group and select Unblock Callsin the secondary menu.

Block Calls from Select Contacts

This feature allows a user to selectively disable the reception of calls from any individual contact.

To disable the reception of calls from an individual contact, press and hold a contact and select Block Callsin the secondary menu. The contact icon changes to indicate that the reception of calls from that contact isdisabled.

57


Figure 31 Contact Blocked

Callout Description

1 Block call from a contact.

2 Blocked contact.

To re-enable the reception of calls from this contact, press and hold the contact and select Unblock Calls inthe secondary menu.

58


Group Member ListThe members of a group can be viewed by tapping the expand carat (>). All members of the group aredisplayed, along with their presence indicators. Collapse the list as shown.

Figure 32 Group Member Presence

Callout Description

1 Unexpanded group.

2 Expanded group.

Late Join and Re-JoinZebra PTT Pro supports late join/re-join on group calls. This also provides a group presence indication tospecify which group calls are active and available for late join/re-join.

There may be times when someone cannot join a group call when it begins. The Late Join feature letsa person join the call when the call is already in progress. The Rejoin feature lets a person join a callpreviously participated in and exited.

Talker Override and PreemptionZebra PTT Pro supports the Talker Override/Preemption feature with group types Enterprise Open,Enterprise Closed, and Dispatch.

59


During a call, a user with Talker Override can press the PTT button to speak while a user without TalkerOverride is speaking, interrupting the speaking user. Multiple Talker Override users requesting to speakare managed on a first-come first-serve basis.

Users can be assigned Talker Override capability when they are added as members to a group in the PTTPro Management Portal.

The Broadcast Group supports a preemption feature. Whenever a Broadcast call is made, it will preemptevery other call the members of the Broadcast Group are currently participating in. Once the user hasheard the broadcast message, the user can make other PTT calls again.

NOTE: Talker Override/Preemption is not related to Call Override. Talker Override relates tointeractions during a call, while Call Override relates to interactions between calls

.

Call OverrideZebra PTT Pro supports the Call Override feature on 1:1, Ad hoc, and Group Calls.

Call Override allows users to be removed from a lower priority ongoing call and put in a a new higherpriority call. Each user and group has an assigned priority between 1 and 5 which determines the behaviorof Call Override as described in the following sections.

NOTE: Call Override is not related to Talker Override/Preemption. Talker Override relates tointeractions during a call, while Call Override relates to interactions between calls.

Call Override on 1:1 and Ad hoc Calls

A user or group with a higher priority than the members of a 1:1 or ad hoc call can override that call.

Call Override on Group Calls (by Calling Individual User(s))

A caller with a priority higher than group call members in an ongoing group call can remove membersfrom the group call and put them into a new 1:1 or ad hoc call. The group call continues with the remainingmembers.

Call Override on Group Calls (by Calling Group)

A group with a priority higher than group call members in an ongoing group call can remove members fromthe group call and put them into a new group call. The original group call continues with the remainingmembers.

Contact ManagementUse Zebra PTT Pro to manage most contact functions via the device, including Remove Contact, AddContact to Group, Create New Group, and Delete Group.

Single Contact

Select a contact and then press and hold the contact for contact management options.

60


Figure 33 Contact Management Options

Contact InfoDisplays the contact name, phone number, and related information.

Alert CallInitiates an alert call to the selected contact.

Block CallsBlock calls from the selected contact.

Set Default CalleeSpecify contact as default callee.

Create GroupCreates a group with the selected contact.

Add to GroupAdds the contact to an existing group.

Remove ContactRemoves contact from the contact list.

Multiple Contacts

Press and hold multiple contacts for contact management options.

61


Figure 34 Multiple Contact Management Options

Callout Description

1 Select multiple contacts to create a group, add contacts to a group, or removecontacts from a group.

Available actions for multi-contact management include:

• Create Group - Creates a new group with the contacts.

• Add to Group - Adds the contacts to an existing group.

• Remove Contacts - Removes contacts from the contact list.

Favorites

NOTE: Favorites are saved locally, and cannot be configured from the PTT Pro ManagementPortal.

62


Figure 35 Favorites

1.Tap the tab.

2.Select a contact or multiple contacts and click . The icon changes to .

3.Click the tab to view a list of favorite contacts and groups.

Group ManagementUse Zebra PTT Pro to manage most group functions using the device. Use the device's native UI behaviorsuch as using the Navigation Drawer icon or holding a group for group management.

Select a group and then press and hold the group for group management options.

63


Figure 36 Group Management Options

Available actions for group management include:

• Block Calls - Block incoming calls from the group.

• Delete Group - Delete the group (Personal groups only).

• Set Default Callee - The default group to call when Zebra PTT Pro is in the background, or in theforeground and no group is selected.

Favorites Groups

NOTE: Favorites are saved locally, and cannot be configured from the PTT Pro server.

64


Figure 37 Favorites

1.Tap .

2.Select a group or multiple groups and click . The icon changes to .

3.Click the tab to view a list of favorite groups and contacts.

Searching Contacts on the Device or Server1. Tap the Contacts tab.

2. Tap to locate a contact on the device or, tap to locate a contact on the server.

3. Start typing the contact name until a match is found. As each letter is entered, the matches display.Select the contact, and press and hold the contact to open the secondary menu.

4. Select an available option.

5. Select to clear the search string to view all contacts

6. Select again to close the Search Contacts field.

65

Location Based ServicesLocation Based Services

This chapter provides information on the multiple options available for location tracking and mappingservices. In order to access the map view, the user must have a device with Google Mobile Services (GMS).

Live Tracking ModeThe mobile device, provided the device has GPS services and is enabled, can send GPS locationinformation to the server. This is enabled in the server by the administrator. If enabled, the Android clientprovides the ability to:

• Enable/disable location services.

• Enable/disable the Duty mode.

If the administrator has not enabled location functionality, the map and attendant controls will not appearon the device.

Sending Location Information

Enterprise administrators have the option to configure the client to send live location Information from themobile client back to the server in the following ways:

• Administrator controlled - Administrators can set location information to ON or OFF without giving theindividual users the ability to change settings.

• User controlled - If the administrator has set the device’s location setting to Allow Location Disable toON, the user has the ability to enable/disable sending location information to the server.

• Duty Mode - Duty mode allows the user to stop/start sending location information to the server. Whenthe user is Off duty, they are still available for a PTT call and messaging, but no location information isbeing sent to the server. If a user engages in a PTT call while Off duty, the user is reset back to On duty.

If the Server Force Duty Mode is set to off, then the user does not have the ability to set the Off Duty mode,and will transmit location information constantly. If the Force Duty Mode is set to on, then the user has theability to go on and off duty.

If both Duty Mode and Location are turned on in the Zebra PTT Pro Management Portal, Duty Mode takespriority and will display, the Enable/Disable Location option does not appear.

66

Location Based Services

Figure 38 Administrator Controlled Duty Modes

Location Enable and Disable

To enable the location functionality:

1. Tap the Navigation Drawer icon, then Settings.

67


2. Toggle the Enable Location control to enable or disable location functionality.

Figure 39 User Controlled Device Location Enable and Disable

Viewing Location Information

Users with live tracking enabled and map view privileges can view location and presence information for allcontacts.

• Contacts with Location enabled appear on the map.

• Contacts appear with the same presence indications as on the Contacts tab.

• A blue dot indicates the owner (self).

• Green pins indicate available contacts.

• Red pins indicate unavailable contacts (already in-call or in DnD mode).

• Use the plus and minus icons to zoom in or out.

• Use Location to center the map on the current location.

68


Viewing Live In-Call Location Information

Users with tracking enabled and map view privileges can view real-time location information for all in-callparticipants.

• In call participants with Location enabled appear on the map.

• A blue dot indicates the caller.

• Green pins indicate call participants.

• A red pin indicate the speaking participant.

• Use the plus and minus icons to zoom in or out.

• Use Location to center the map on the current location.

• In call locations update every two seconds.

Figure 40 In-Call Map View

Place a PTT Call from the Map1. Tap the Map tab.

2. Tap the contact.

69


3. Select the name of contact.

Figure 41 Select contact from map

4.Tap .


6. Tap End Call when finished.

Place an Ad hoc Call to One or More Contacts from the MapAn ad hoc call is one made to multiple contacts or a temporary group, with a specific purpose in mind. Usethe ad hoc calling feature when a group is not available containing the particular contacts needed for thecall.

1. Tap the Map tab.

2. Scroll and zoom to an area that includes the desired contacts.

3. Select More... and slide up to display Add All and Remove All.

4. Tap Add All to include contacts in the map view to an Ad hoc call.

70



Figure 42 Add Contacts from Map to Ad hoc Call

Create a Group from the Map1. Tap the Map tab.

71


2. Tap

Figure 43 Creating a Group from a Map

3. Choose either Personal Group or Member Group.

4. Type a name for the group, and tap OK.

5. All contacts on the map are added to the group.

Map OptionsMap options are available within the Settings.

Cluster Start Threshold

The application can group or cluster users shown on the map, allowing the user to place a call to allcontacts within that cluster. To determine the number of users clustered together:

1. Tap the Navigation Drawer , and then Settings.

2. Tap General, and then Cluster Start Threshold.

72


3. Set the number of users on the map beyond which the map will cluster users on the display.

Figure 44 Cluster Map Threshold

Map Gestures

Gestures Description

Two Finger Rotate Using two fingers, twist or rotate the map. Tap on the Compass icon (topleft) to return to the North Up orientation.

Double Tap Using one finger, tap two times to zoom to location.

Swipe Up Swipe up on More... to add or remove all users on the map to (or from) anAd hoc call.

Table 8 Map Gestures

73


Map Presence Indicators

Icon Description

Contact is available.

Contact is on a call.

Contact is Do Not Disturb (DnD) mode.

Contact is blocked.

Table 9 Contact Presence Indicators on Map

Indoor Location ServiceEnterprise administrators can configure Zebra PTT Pro devices to display the indoor location of a device.The location displays under each name on the Contacts tab. The indoor location is determined by the Wi-FI Access Point (AP) to which the device is connected. Administrators can specify a name, such as thedepartment or location, for each AP. Indoor location services support voice commands.

The About screen in the following figure shows the current location of the device.

Figure 45 WFC-LAS Name Identifies the Location of the Device

The following figure displays a contact in an indoor location identified as HomeOffice.

74


Figure 46 Indoor Location of Contact

75

Voice CommandsVoice Commands

Voice commands enable the user to perform tasks by speaking into the device or supported accessory.

About Voice CommandsVoice commands do not work on bring your own device (BYOD) or Zebra devices where the Push To Talk(PTT) button is not available, or is used for other purposes.

If Zebra PTT Pro and WFC Voice are installed on the device, both apps must have voice commandseither enabled or disabled. Setting voice commands to on in one app and off in the other app may causeunexpected behavior when using voice commands.

When using a voice command to talk, message, or locate a contact and multiple entries are found, thesystem prompts you to make a choice. Only the first three entries are made available when using voicecommands.

• If no entries are found, the system responds that the entry was not found.

• If an invalid selection is made, the system responds I do not understand.

Two beeps indicate that the system has stopped listening for voice commands. Press and release Push ToTalk again to start a new voice command.

PTT Button Configuration and Function

The user can press or tap the physical PTT button on a Zebra device to initiate a PTT call to a contact,group or default callee, exit a PTT call, or invoke a voice command.

Several of these functions require that the administrator to give the user the necessary permissions andthat the user configures the device.

• Default callee requires permission from the administrator of the Zebra PTT Pro Management Portal andthe user selects a default callee in the Default Callee setting.

• Features that enable the user to double press the PTT button require that the Enable Double Key PressFeature is enabled.

NOTE: When both voice commands and the default callee options are enabled, voice commandswork only when the PTT Pro application is in the background.

See the following table for the interaction between PTT button functions.

76

Voice Commands

Action Double KeyEnabled

In a Call User or GroupSelected

Result

Double Tap Yes Yes NA Exit the call.

Single Tap Invoke voice command.

Double Tap

NA NA No

PTT Call to default callee.

Table 10 PTT Button Action and Result

Enabling Voice Commands1. Tap the Navigation Drawer .

2. Select Settings > Voice Command Configuration.

77

Voice Commands

3. Locate the Voice Command setting and tap to enable.

Figure 47 Enable Voice Command

78

Voice Commands

The is now active in the Navigation Drawer screen

Figure 48 Voice Command Enabled

Voice Command Activity Screen

PTT Pro can provide visual feedback when the user issues a voice command. The user can enable ordisable the visual feedback with the Enable Voice Command Help Screen setting under Settings > VoiceCommand Configuration.

79

Voice Commands

Figure 49 Voice Command Activity Screen

The activity screen appears when the PTT button is pressed to start a voice command.

• Activity screen waits 3 seconds for a command. The user can also say Help to hear a list of voicecommands.

• Activity screen can be dismissed by tapping Hide Bar or pulling down on the activity screen.

• When the voice command is complete, a double beep plays and the activity screen disappears after 3seconds.

Supported Voice CommandsZebra PTT Pro supports voice commands to perform the following tasks:

• Locate a contact.

• Talk to a contact or group.

• Message a contact or group.

• Play and manage messages.

80

Voice Commands

Locating a Contact

The user can locate a contact using the locate, search, and where is commands. This voice commandrequires the Location Area Service.

1. Press the Push To Talk .

2. Speak into the device: “Locate <username or FirstName LastName>”.

3. The device responds “<username> or FirstName LastName> is located at <location>”

User: Locate Amanada Lopez.

Device: Amanad Lopez is located at Hardware.

Action: The device reports the location of the contact.

Table 11 Example Voice Command to Locate a Contact

Talking to a Contact, Group, or Default Callee

The user can make a PTT call using the talk to, speak to, and contact commands.

User must say one of the following voice commands to make a PTT call:

• talk to

• speak to

• contact

1. Press Push To Talk.

2. Speak into the device:

• Talk to contact <username> or <FirstName LastName>

• Talk to group <groupname>

• Talk to default callee

• Talk to default target

3. The device responds:

• Do you want to talk to <username> or <FirstName LastName>

• Do you want to talk to group <groupname>?

• Do you want to talk to default callee <username or group name>?

4. Speak into the device: Yes

5. The device says: Talk to <username> or <FirstName LastName> or <groupname>. Zebra PTT Prodisplays the call idle screen.

Messaging a Contact, Group, or Default Callee

The user can send a message using the Send message, Send a text, and chat with commands.

1. Tap the Contacts or Groups tab.

2. Select the desired contact or group, and then tap the Message icon.

81

Voice Commands

3. Tap .

The following screen displays.

Figure 50 Speech To Text

82

Voice Commands

4. Tap Speech to Text.

The following screen displays.

Figure 51 WFC PTT Pro Speech-to-Text

83

Voice Commands

5. Say the message.

Figure 52 Voice Message Recorded

84

Voice Commands

6. The recorded message displays in the text box. Click Send.

Figure 53 Send Recorded Voice Message

NOTE: The following examples have Confirm Message Detail enabled in the Voice CommandConfiguration settings.

User: Send message to Amanda Lopez.

Device: Do you want to message Amanda Lopez?

User: Yes

Device: What do you want to say?

User: Please come to the meeting at 10 a.m.

Device: Do you want to message Amanda Lopez stating, “Please come to the meeting at10am”? Say Send, Retry, or Cancel.

User: Send.

Table 12 Example Voice Command to Message a Contact

User: Send a text to group Area Managers.

Device: Do you want to message to group Area Managers?

User: Yes

Table 13 Example Voice Command to Text with a Group

85

Voice Commands


User: The meeting is at 10 a.m.

Device: Say Send, Retry, or Cancel.

User: Send.

Table 13 Example Voice Command to Text with a Group (Continued)

User: Chat with default callee.

Device: Do you want to message to default callee group Electronics?

User: Yes


User: Customer assistance required in aisle 5.

Device: Say Send, Retry, or Cancel.

User: Send.

Device: Message sent to the default callee group Electronics.

Table 14 Example Voice Command to Chat with the Default Callee

Managing Messages

The user can use voice commands to manage and play messages. Messages can include text, audio,video, and the Message of the Day (MOTD). The messages are read from oldest to newest.

• Play messages.

• Read messages.

• Read my messages.

• Play my unread messages.

• Read my unread messages.

• Read my new messages.

• Play new messages.

• Play my new messages.

• Skip

• Replay an unread message.

• Delete an unread message.

• List the number of unread messages.

• List the number of messages and conversations.

• Delete all conversations.

NOTE: Voice commands to play and manage messages are not available when the deviceis locked. When the device is locked and the user invokes a restricted command, the device

86

Voice Commands

responds with the message “This feature is not available when the device is locked” and twobeeps. Two beeps indicate that the device is no longer listening for voice commands.

After listening to an unread message, the user can replay or delete the message, listen to the next unreadmessage, skip the next message, or quit.

User: Play my messages.

Device: Plays all messages, from oldest to newest. After playing the last message,the device says No more messages to play followed by a double beep.

Table 15 Example Voice Command to Play Messages

User: Play my unread messages.

Device: Message received from Amanda Lopez. Message is customer assistance is requiredat Electronics.

User: Next.

Device: Message received from Robert Brown. Message is curbside pickup at parking number3.

User: Skip.

Device Message received from Robert Brown. Message is curbside pickup at parking number3.

User: Delete.

Device: Are you sure you want to delete the message?

User: Yes.

Device: Message deleted. Next Message or Quit?

User: Quit.

Table 16 Example Voice Command to Play and Delete Unread Messages

User: How many messages do I have?.

Device: You have 2 conversations and 5 messages.

Table 17 Example Voice Command for Listing Number of Messages

User: How many unread messages do I have?.

Device: You have 2 conversations and 5 unread messages.

Table 18 Example Voice Command for Listing Number of Unread Messages

User: Delete all my messages.

Device: Are you sure you want to delete all of the messages?

User: Yes.

Table 19 Example Voice Command for Deleting All Messages

87

Voice Commands

Device: All text messages have been deleted.

Table 19 Example Voice Command for Deleting All Messages (Continued)

User: Remove all conversations.

Device: Are you sure you want to remove all conversations?

User: Yes.

Device: All the conversations have been removed.

Table 20 Example Voice Command for Removing Conversations

Localized Voice CommandsWhen the device language is set to a supported language, Zebra PTT Pro uses that language to receiveand respond to voice commands.

Supported languages for voice commands include:

• Czech

• Dutch

• French

• French Canadian

• German

• Hungarian

• Italian

• Polish

• Russian

• Slovak

• Spanish

• Swedish

WARNING: Localized voice commands are a Beta feature and may not work as expected.

Czech Voice Commands

When the device language is set to Czech, Zebra PTT Pro uses Czech to receive and respond to voicecommands.

Locate Contact

Czech Command Action

Lokalizovat Locate contact.

Malézt Find contact.

88

Voice Commands


Kde Where is contact?

NOTE: These commands require the Location Area Service

Talk to Contact, Group, or Default Callee


Hovor

Mluvit s

Make a PTT call to a contact.

Hovořit s výchozím volaným Make a PTT call to default callee.

Hovořte so skupinou Make a PTT call to a group.

Hovořit s výchozí volanou skupinou Make a PTT call to default callee group.

Message a Contact or Group


Zpráva pro

Text pro

Send message to contact.

Zprávu do skupiny

Text do skupiny

Send message to group.

Manage Messages


Kolik mám zpráv

Počet zpráv

Report the total number of messages.

Kolik mám nepřečtených zpráv

Počet nepřečtených zpráv

Report the number of unread messages.

Přehrát nepřečtené zprávy

Přehrát moje nepřečtené zprávy

Play unread messages.

Nejprve přehrát nové zprávy

Nejdříve přehrajte nejnovější zprávy

Play newest message first.

Smazat všechny zprávy Delete all messages.

Smazat všechny konverzace Delete all conversations.

89

Voice Commands

Dutch Voice Commands

When the device language is set to Dutch, Zebra PTT Pro uses Dutch to receive and respond to voicecommands.

Locate Contact

Dutch Command Action

Bevind zich Locate contact.

Vind Find contact.

Waar Where is contact?

NOTE: These commands require the Location Area Service.

Talk to a Contact, Group, or Default Callee


Praten met

Bellen


Praat met standaard aangeroepen Make a PTT call to the default callee.

Praat met de groep

Praat met een groep

Make a PTT call to a group.

Praat met de standaard aangeroepen groep Make a PTT call to the default callee group.



Bericht naar

Sms naar

Send a message to a contact.

Bericht aan groep

Tekst naar groep

Send a message to a group.

Manage Messages


Hoeveel berichten heb ik

Aantal berichten


Hoeveel ongelezen berichten heb ik

Aantal ongelezen berichten


Speel mijn ongelezen berichten

Ongelezen berichten afspelen


Speel nieuwe berichten eerst af

Speel de nieuwste berichten eerst af


90

Voice Commands


Verwijder alle berichten Delete all messages.

Verwijder alle conversaties Delete all conversations.

French Voice Commands

When the device language is set to French, Zebra PTT Pro uses French to receive and respond to voicecommands.

Locate Contact

French Command Action

Localiser Locate a contact.

Trouver Find a contact.

Où Where is contact?


Talk to Contact, Group, or Default Callee


Appel

Parler à


Parler à l'appelé par défaut Make a PTT call to default callee.

Parler à un groupe

Parler au groupe


Parler au groupe d'appels par défaut Make a PTT call to the default callee group.



Message à

Envoyer un SMS à

Send message to contact.

Message au groupe

Texte au groupe

Send message to group.

Manage Messages


Combien de messages ai-je

Nombre de messages


Combien de messages non lus ai-je

Nombre de messages non lus

Report the total number of unread messages.

91

Voice Commands


Lire mes messages non lus

Lire les messages non lus


Lire d'abord les nouveaux messages

Lire les messages les plus récents en premier


Supprimer tous les messages Delete all messages.

Supprimer toutes les conversations Delete all conversations.

French Canadian Voice Commands

When the device language is set to French Canadian, Zebra PTT Pro uses French Canadian to receive andrespond to voice commands.

Locate Contact

Command Action

localiser Locate a contact.

trouver Find a contact.

où Where is contact?



French Canadian Command Action

Parler à

Contact


Parler à la personne identifiée par défaut Make a PTT call to default callee.

Parler à un groupe

Contacterun groupe


Parler au groupe d'appels par défaut Make a PTT call to default callee group.



Envoyer un message

Envoyer un texto a

Parler à


Envoyer un message de groupe

Envoyer un message au groupe


92

Voice Commands

Manage Messages


Combien ai-je de messages

Nombre de messages


Combien de messages non lus ai-je

Combien de messages non lus


Nombre de messages non lus

Lire mes messages non lus

Lire non lu


Lire d'abord les nouveaux messages

Lire les messages les plus récents enpremier


Supprimer tous les messages Delete all messages.

Supprimer toutes les conversations Delete all conversations.

German Voice Commands

When the device language is set to German, Zebra PTT Pro uses German to receive and respond to voicecommands.

Locate Contact

German Command Action

Lokalisieren Locate a contact.

Finden Find a contact.

Wo Where is contact?




Anruf

Reden mit


Sprechen sie mit dem standard-angerufenen Make a PTT call to default callee.

Sprich mit der gruppe

Sprich mit einer gruppe

Make a PTT call to a group

Sprechen sie mit der standard-angerufenengruppe Make a PTT call to default callee group.

93

Voice Commands



Nachricht an

Text an


Nachricht an die gruppe

Zu gruppierender text


Manage Messages


Wie viele nachrichten habe ich?

Anzahl der ungelesenen nachrichten


Wie viele ungelesene nachrichten habe ich?

Anzahl der ungelesenen nachrichten


Spiele meine ungelesenen nachrichten ab

Ungelesene nachrichten abspielen


Spielen sie zuerst neue nachrichten ab

Spielen sie zuerst die neuesten nachrichten ab


Alle nachrichten löschen Delete all messages.

Löschen sie alle gespräche Delete all conversations.

Hungarian Voice Commands

When the device language is set to Hungarian, Zebra PTT Pro uses Hungarian to receive and respond tovoice commands.

Locate Contact

Hungarian Command Action

Keresd meg Locate contact.

Megtalál Find contact.

Hol Where is contact?




Hívás

Beszélni valakihez


Beszéljen alapértelmezettszeméllyel Make a PTT call to default callee.

Beszélj a csoporttal Make a PTT call to a group.

94

Voice Commands


Beszélj egy csoporttal

Beszéljen az alapértelmezett csoporttal Make a PTT call to default callee group.



üzenetet

Szöveget


üzenet a csoportnak

szöveges üzenet csoportnak


Manage Messages


hány üzenetem van?

üzenetek száma

Report the number of messages.

hány olvasatlan üzenetem van?

olvasatlan üzenetek száma


lejátszani az olvasatlan üzeneteimet

olvasatlan üzeneteket játszhat le


törölje az összes üzenetet Delete all messages.

törölje az összes beszélgetést Delete all conversations.

Italian Voice Commands

When the device language is set to Italian, Zebra PTT Pro uses Italian to receive and respond to voicecommands.

Locate Contact

Italian Command Action

Individuare Locate contact.

Trova Find contact.

Dove Where is contact?




Chiamata

Parlare a


95

Voice Commands


Parlare con il chiamato predefinito Make a PTT call to default callee.

Parla al gruppo

Parlare a un gruppo


Parlare con il gruppo chiamato predefinito Make a PTT call to default callee group.



Messaggio a

Testo a


Messaggio al gruppo

Testo al gruppo


Manage Messages


Quanti messaggi ho Report the total number of messages.

Numero di messaggi

Quanti messaggi non letti ho Report the number of unread messages.

Numero di messaggi non letti

Riproduci i miei messaggi non letti Play unread messages.

Riprodurre messaggi non letti

Riprodurre prima i nuovi messaggi Play newest message first.

Riprodurre prima i messaggi più recenti

Elimina tutti i messaggi Delete all messages.

Elimina tutte le conversazioni Delete all conversations.

Polish Voice Commands

When the device language is set to Polish, Zebra PTT Pro uses Polish to receive and respond to voicecommands.

Locate Contact

Polish Command Action

Zlokalizować Locate contact.

Odnaleźć Find contact.

Gdzie Where is contact?


96

Voice Commands



Połączenie Make a PTT call to a contact.

Rozmawiać z

Porozmawiaj z domyślnym rozmówcą Make a PTT call to default callee.

Porozmawiaj z grupą Make a PTT call to a group.

Naciśnij, aby porozmawiać z grupą

Porozmawiaj z domyślną grupą Make a PTT call to default callee group.



Wiadomość do

Tekst do

Send message to a contact.

Wiadomość do grupy

Tekst do grupy

Send message to a group.

Manage Messages


Ile mam wiadomości

Liczba wiadomoścI


ile mam nieprzeczytanych wiadomości

Počet neprečítaných správ


Odtwórz moje nieprzeczytane wiadomości

Odtwórz nieprzeczytane wiadomości


Odtwórz najpierw nowe wiadomości Play newest message first.

Odtwórz najpierw najnowsze wiadomości

Usuń wszystkie wiadomości Delete all messages.

Usuń wszystkie rozmowy Delete all conversations.

Russian Voice Commands

When the device language is set to Russian, Zebra PTT Pro uses Russian to receive and respond to voicecommands.

Locate Contact

Russian Command Action

найти Locate contact.

находить Find contact.

где Where is contact?

97

Voice Commands




вызов

говорить с


поговорить с вызываемым по умолчанию Make a PTT call to default callee.

поговорить с группой

нажмите, чтобы поговорить с группой


поговорить с группой вызываемых поумолчанию

Make a PTT call to default callee group.



сообщение

текст на


сообщение группе

текст для группы


Manage Messages


сколько сообщений у меня

количество сообщений


сколько у меня непрочитанных сообщений

количество непрочитанных сообщений


воспроизвести мои непрочитанные сообщения

воспроизводить непрочитанные сообщения


сначала воспроизвести новые сообщения

сначала воспроизвести новейшие сообщения

Play the newest message first.

удалить все сообщения Delete all messages.

удалить все разговоры Delete all conversations.

98

Voice Commands

Slovak Voice Commands

When the device language is set to Slovak, Zebra PTT Pro uses Slovak to receive and respond to voicecommands.

Locate Contact

Slovak Command Action

Lokalizovať Locate contact.

Nájsť Find contact.

Kde Where is contact?




Hovor

Rozprávať s


Hovoriť s predvoleným volaným Make a PTT call to default callee.

Hovorte so skupinou

Push to talk so skupinou


Hovoriť s predvolenou volanou skupinou Make a PTT call to default callee group.



Správa pre

Text pre


Správa pre skupinu

Text pre skupinu


Manage Messages


Koľko mám správ

Počet správ


Koľko mám neprečítaných správ

Počet neprečítaných správ


Prehrať moje neprečítané správy

Prehrať neprečítané správy


Najskôr prehrať nové správy

Najskôr prehrať najnovšie správy


99

Voice Commands


Vymazať všetky správy Delete all messages.

Vymazať všetky konverzácie Delete all conversations.

Spanish Voice Commands

When the device language is set to Spanish, Zebra PTT Pro uses Spanish to receive and respond to voicecommands.

Locate Contact

Spanish Command Action

Localizar Locate contact.

Encontrar Find contact.

Dónde Where is contact?




Llamada

Hablar con


Hablar con el destinatario predeterminado Make a PTT call to default callee.

Hablar con el grupo

Hablar con un grupo


Hablar con el grupo de destinatariospredeterminado

Make a call to default callee group.



Mensaje para

Texto a


Mensaje al grupo

Texto al grupo


Manage Messages


Cuantos mensajes tengo

Número de mensajes


Cuántos mensajes no leídos tengo

Número de mensajes no leídos


100

Voice Commands


Reproducir mis mensajes no leídos

Reproducir mensajes no leídos


Reproducir mensajes nuevos primero

Reproducir los mensajes más nuevos primero


Borrar todos los mensajes Delete all messages.

Eliminar todas las conversaciones Delete all conversations.

Swedish Voice Commands

When the device language is set to Swedish, Zebra PTT Pro uses Swedish to receive and respond to voicecommands.

Locate Contact

Swedish Command Action

Lokalisera Locate contact.

Hitta Find contact.

Var Where is contact.




Ring upp

Prata med


Prata med standardcalle Make a PTT call to default callee.

Prata med gruppen

Prata med en grupp


Prata med standardgrupp Make a PTT call to a default callee group.



Meddelande till

Text till


Meddelande till gruppen

Text till grupp


101

Voice Commands

Manage Messages


Hur många meddelanden har jag

Antal meddelanden


Hur många olästa meddelanden har jag

Antal olästa meddelanden


Spela mina olästa meddelanden

Spela olästa meddelanden


Spela upp nya meddelanden först

Spela de senaste meddelandena först


Radera alla meddelanden Delete all messages.

Ta bort alla konversationer Delete all conversations.

Voice Command Error ConditionsZebra PTT Pro provides feedback when a voice command is not available or another error conditionoccurs.

Error Condition Zebra PTT Pro Response Description

User gives voice commandCall John.

Calling not available, would youlike to talk to John instead?

User provides a WFC Voice voicecommand when only Zebra PTTPro is installed on the device.

User gives an invalid voicecommand but a valid username.

Invalid voice command. Wouldyou like to talk to John instead?

When the user provides an invalidcommand but a correct username, Zebra PTT Pro suggeststhe talk voice command.

User does not receive aresponse from the devicewhen initiating a PTT call.

Voice permissions must beenabled to use this feature.Please check with youradministrator.

User must provide permissionfor Zebra PTT Pro to access themicrophone.

User gives a command thatZebra PTT Pro does notunderstand.

Sorry. I didn’t get that. This issue can occur when theuser is in a noisy environmentor the audio is too soft for theAndroid SpeechRecognizer towork properly.

Table 21 Voice Command Error Conditions

102

Worker Duress and DropDetectWorker Duress and Drop Detect

Staff safety is a priority for mobile workers dealing with public or handling money. Whether in healthcare,retail, field mobility or warehouse, staff may find itself in unpredictable situations, often alone.

Worker Durress enables a site manager, for example a Hospital Ops Manager, Store Manager, orWarehouse Manager can enable their staff to raise an alert through their mobile device when in duressor panic situation. The alert, sent to designated people, shows physical presence information about theaffected staff seeking help. Once notified, the designated recipients can arrange for help.

The Worker Duress feature is integrated with Zebra PTT Pro, which initiates an alert to members of a PTTPro group when the designated key is pressed.

The PTT Pro client registers and listens for the intent associated to a specific key and initiates an alertwhenever the intent is triggered. When the alert is triggered, recipients of the alert can respond with a PTTcall to the initiator to validate duress and obtain additional information.

In addition to generating alerts triggered by a specific key, Worker Duress can also generate alertstriggered by the Drop Detection device feature.

The following sections describe the required PTT Pro configuration, the necessary configuration for keys orthe Drop Detection feature to trigger alerts, and operation of the client.

Requirements and Configuration for Worker DuressWorker Duress and Drop Detect require that Zebra PTT Pro is configured to initiate an alert.

• Zebra PTT Pro version 3.3.10134 or later.

• Zebra PTT Pro running on Android 10 or later prompts the user to provide system-level Do Not Disturb(DnD) access. See System-Level DnD Permissions and Behavior for more information regarding theinteraction between the Zebra PTT Pro and Android DnD.

JSON Configuration Elements

The Worker Duress feature is configured using the WFCPTTProDefault.json file. The followingelements are added to the JSON file to configure the Worker Duress feature behavior:

{"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",

103

Worker Duress and Drop Detect

"drop_detection_recipient_name": "Duress.Group","drop_detection_alarm_duration": "30","drop_detection_skip_first_screen": "0"}

JSON Parameter Description

drop_detection_feature_enable Enables or disables Worker Duress.

Value of 0 (disabled) or 1 (enabled).

Default value is 1.

drop_detection_auto_alert_title Specifies the title on the first screen when WorkerDuress is initiated by Drop Detect.

When the value is not set or is empty, the title isDrop Detected.

If the specified title length exceeds what can bedisplayed on a single line, the title is cropped to fitwith an ellipsis.

drop_detection_manual_alert_title Specifies the title on the first screen when WorkerDuress is initiated by the designated key press.

When the value is not set or is empty, the title isDuress Detected.

If the specified title length exceeds what can bedisplayed on a single line, the title is cropped to fitwith an ellipsis.

drop_detection_default_text_message Specifies the emergency PTT text message sentafter the alert time elapses.

Empty by default.

drop_detection_recipient_type Specifies whether the alert recipient is a group or auser.

A value 1 indicates a group and a value of 0indicates a user.

This value is required when the feature is enabled.

drop_detection_recipient_name Recipient of the alert message. The value can be asingle 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 thePTT Pro Management Portal.

A group or user name is required when the featureis enabled.

drop_detection_alarm_duration Specifies the duration, in seconds, of the alarm onthe initiator’s device when an alert is triggered.

The value must be 30 seconds or more.

Default value is 30 seconds.

Table 22 JSON Parameters for Worker Duress

104


JSON Parameter Description

drop_detection_skip_first_screen Enables or disables the countdown screen on theinitiator’s device. A value of 1 skips the countdownscreen and a value of 0 enables the countdownscreen.

Default value is 0.

Table 22 JSON Parameters for Worker Duress (Continued)

Use ADB to Update the JSON Configuration

Use ADB commands to update the JSON configuration of Zebra PTT Pro on a Zebra device.

Update the WFCPTTProDefault.json file.

1. Push the JSON configuration to the device.

adb push WFCPTTProDefault.json /sdcard/

2. Apply the configuration to the device to force Zebra PTT Pro to reload its configuration.

Android 11 and later use a different command than Android 10 and earlier.

Option Description

Android 11 and later

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

Android 10 and earlier

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

NOTE:

• Worker Duress is only supported in Portrait mode.

• Worker Duress is only supported in the English locale.

Allow System-level Do Not Disturb

Zebra PTT Pro clients running on Android 10 or later prompt the user to provide system-level Do notDisturb (DnD) access to enable features such as Worker Duress.

The system prompts for system-level DnD permission when the feature is enabled on the device.

105


1. Select the slide switch and enable Allow Do Not Disturb.

106


2. Touch Allow to confirm the permission.

This is a system level DnD and it does not activate the Zebra PTT Pro DnD. Android system DnDpermission is required in Android 10 and later.

Intent to Trigger Worker Duress through a Key Press

The intent is required to initiate the Worker Duress alert from a specified key.

The key or button must be programmed to generate this intent when pressed. For Zebra devices,refer to the Stage Now documentation for configuring the key used to initiate the intent at https://techdocs.zebra.com/mx/intent/. In addition, an example is included in this documentation.

Worker Duress Intent Alert

com.symbol.wfc.pttpro.FREE_FALL_STATE_MANUALLY_TRIGGERED

Extra 0Boolean

Extra 0 NameFreeFallState

107




Extra 0 Value

• True or False (Android 11 and above)

• 1 or 0 (Android 10 and below)

ADB Example for Android 10

adb shell am broadcast -a com.symbol.wfc.pttpro.FREE_FALL_STATE_MANUALLY_TRIGGERED --ez FreeFallState 1

ADB Example for Android 11

adb shell am broadcast -a com.symbol.wfc.pttpro.FREE_FALL_STATE_MANUALLY_TRIGGERED --ez FreeFallState true

Intent to Trigger Worker Duress through Drop Detect

An intent is required to initiate the Worker Duress alert because of a Drop Detect. To generate this intentand send it to Zebra PTT Pro, the Free Fall Detection sensor must be enabled and mapped to the intent.

When Drop Detect is enabled, the an icon is displayed in the notification bar.

Figure 54 Drop Detect in Notification Bar

For Zebra devices, refer to the Stage Now documentation for configuring the sensor used to initiatethe Drop Detect intent at https://techdocs.zebra.com/mx/intent/. A Zebra Knowledge Base articleexplains how to configure Drop Detect, also called Free Fall Detection, to send an intent is at https://supportcommunity.zebra.com/s/article/000021316. Supported devices are noted in the KB article.

Drop Detect Alert Intent

com.zebra.ffdservice.FREE_FALL_STATE_CHANGED

Extra 0Boolean

Extra 0 NameFreeFallState

Extra 0 Value

• True or False (Android 11 and above)

• 1 or 0 (Android 10 and below)

108


https://supportcommunity.zebra.com/s/article/000021316

https://supportcommunity.zebra.com/s/article/000021316


ADB Example of Drop Detect Intent

The ADB command to trigger the Drop Detect intent. The intent works for devices that support Free FallDetection.

• adb shell am broadcast -a com.zebra.ffdservice.FREE_FALL_STATE_CHANGED

Stage Now and MX Deployment

Stage Now is required to map a key or sensor to an intent.

Use a Stage Now Profile to map to the Worker Duress alert. Define the intent and the key to trigger theintent. This can be done in a variety of ways and further definition is beyond the scope of this document.Shown below is an example of the Rear Button key provisioning document. Other keys on the device canbe mapped as needed.

<characteristic version="10.2" type="Intent"><parm name="Mode" value="2" /><parm name="KeyIdentifier" value="REAR_BUTTON" /><parm name="KeepDeviceAwake" value="false" /><parm name="Action3" value="Broadcast" /><parm name="ActionName" \value="com.symbol.wfc.pttpro.FREE_FALL_STATE_MANUALLY_TRIGGERED" /><parm name="Package" value="com.symbol.wfc.pttpro" /><characteristic type="Extra"><parm name="ExtraType" value="boolean" /><parm name="ExtraName" value="FreeFallState" /><parm name="ExtraValue" value="true" /></characteristic></characteristic>

109


Worker Duress Feature WorkflowThe Worker Duress feature is integrated with the PTT Pro client. This feature works only if it is enabled asdefined in the JSON file.

Sending a Duress Alert

When a user sends an alert, the countdown screen shown in the following figure displays on the device.The user can request help before the timer elapses by touching Get Help or cancel the alert by touching Idon’t need help. The Duress Alert chime is heard for the duration of the countdown.

Figure 55 Duress Countdown Screen

When the countdown expires, the Duress alert is sent to the recipients, and the Request Help screen,shown in following figure, displays on the device. The Duress Alert chime stops when the countdownexpires.

110


Figure 56 Request Help Screen

The user can initiate a PTT call to the alert recipient or recipients by touching Talk to the response team.After the user leaves the call, the device returns to the Request Help screen.

The Request Help screen displays on the device until the user touches Cancel help or Help received. TheCancel help button sends a message to the recipients indicating that help is no longer needed and thedevice returns to the main PTT Pro screen.

111


Receiving a Duress Alert

Recipients receive the Duress alert as a new message in the PTT Pro client.

Figure 57 Recent Screen with Duress Message

Recipients can open the message to view additional details regarding the alert, as shown in followingfigure:

112


Figure 58 Contents of a Duress Message

The Duress message can include the following information:

Message Field Description

Default message Configured through thedrop_detection_default_text_message parameter. Themessage is optional.

Alert sent from <user_name> Name of the user that initiated the alert.

Current Location A link to the longitude and latitude of the device in Google Maps.This requires that GPS and location services are enabled.

Department Name Name of the PTT Pro department. Note that departments can beassociated to create a larger recipient audience.

Access Point Name The name of the access point to which the device is connected. Thisrequires Location Area Service.

Table 23 Duress Message Contents

113


A recipient can make a PTT call to the alert initiator from the message. The initiator and all active recipientscan communicate as many times as necessary. The alert initiator’s screen returns to the Request Helpscreen.

Figure 59 PTT Call from Duress Message

Duress and Do Not DisturbWorker Duress and Drop Detect override the setting of Do Not Disturb (DnD) in the Zebra PTT Pro client.

When a duress or drop-detect alert is initiated, as shown in the Duress Countdown Screen, DnD isenabled in Zebra PTT Pro, regardless of the previous DnD state. If the user selects I don't need help, DnDreturns to its previous state.

114


Figure 60 Duress Countdown Screen

If the user requests help, as shown in the Request Help Screen, DnD is disabled in Zebra PTT Pro,regardless of its previous state. After the alert is resolved, DnD remains disabled and the user must enableDnD if needed.

115


Figure 61 Request Help Screen

116

Device SettingsDevice Settings

This chapter provides information on device settings such as application, sound settings, and accountinformation. If enabled in the Zebra PTT Pro Management Portal, certain settings are available on the clientdevice.

User Account Information• Tap the Navigation Drawer , and then select About.

Figure 62 About Window

Information regarding the user, the department, software version, and more is displayed.

117

Device Settings

Access Application Settings• Tap the Navigation Drawer , and then select Settings.

The Settings screen provides access to the following settings:

• General

• Notification

• Default Sound Profile

• Headset Sound Profile

• Voice Command Configuration

Figure 63 Zebra PTT Pro Setting

118

Device Settings

General Settings

Access General Settings from the Settings screen.

Screen 1

Call PrioritySelect the priority of Zebra PTT Pro calls or WFC Voice calls.

• No Action —The user can hear both types of calls at the same time (PTT and Voice). If the useris on a PTT call, the Voice call will still ring through without preempting the PTT call. If the user ison a Voice call, the PTT voice will barge through without preempting the Voice call. So, it allowsthe user to make the decision at the moment.

• Current —The current call has priority. If the user is on a PTT call, the Voice call will go directlyto voicemail. If the user is on a Voice call, then it will not be interrupted.

NOTE: Only the Voice setting is supported for interaction between the Zebra PTT Proand WFC Voice. Using other Call Priority settings is not recommended when the ZebraPTT Pro and WFC Voice applications are both present. Voice is the default setting.

119

Device Settings

Foreground app on CallBring Zebra PTT Pro to the foreground when receiving a Zebra PTT Pro call.

When using Zebra PTT Pro on Android 11 devices, do not disable Foreground app on call. Whenthis option is disabled, the user cannot respond to the incoming PTT call using the PTT button. Torespond to an incoming call with the option disabled, the user must open the PTT Pro applicationand then press PTT button.

Wake Display at Call StartChecking this will unlock and wake up the display when a Zebra PTT Pro call starts. Deselectingthis option is only applicable if Foreground Zebra PTT Pro on Call is not selected.

Hide TabsHide the Tab Bar and use the Navigation Drawer to change screens.

Enable LocationIf enabled, the device location will be sent to the server, and displayed on the map tab of otherdevices within the organization.

Cluster Start ThresholdThe number of users on the map beyond which the map will cluster users on the display.

Screen 2

120

Device Settings

Activate DnD in Silent ModeActivate Do not Disturb when device is put in silent mode.

Activate DnD in Vibrate ModeActivate Do not Disturb when device is put in vibrate mode.

Start Call with SpeakerphoneStart all calls with the speaker enabled.

Allowed Screen OrientationConfigure the screen to display in either the portrait or landscape orientation.

Default CalleeThe default contact or group to call when Zebra PTT Pro is in the background, or in the foregroundand no contact or group is selected.

Enable Surveillance CallDim and display the full screen during a call.

Screen 3

Surveillance Call BrightnessSet screen brightness during a call when Surveillance Call is enabled. Higher values are brighter.

121

Device Settings

Allow Bluetooth AudioUse a connected Bluetooth headset for call audio. This does not affect Bluetooth PTT keyoperation.

Bluetooth Always OnEnable this option to always keep the connection to a Bluetooth device open. This will improve theinitial call start performance at a cost to battery life on both the Bluetooth device and the phone.

Show Adhoc Call WarningDisplay a warning message before placing Ad hoc calls to the specified number of users.

Adhoc Call Warning ThresholdSets the number of users above which a warning is displayed.

Screen 4

End Call via Double Key PressEnables the user to double press the Push To Talk button to end the current PTT call.

PTT Button double press speedThe number of milliseconds between button presses to trigger the double key press feature. Ahigher number allows more time between button presses.

122

Device Settings

WFC Location Area Service (WFC-LAS)

• Server URL sets the WFC Location Area Service server URL.

• Server Token sets the API token to authorize connection to WFC-LAS server.

Server

• Server URL sets the Internetworking Gateway server URL to upload audio and video messages.

• Enable IWG enables Internetworking Gateway for media.

• API Token sets the API token to upload audio and video messages.

• HTTP Upload Method specifies the HTTP upload method, POST or PUT.

Notification Settings

Notification settings control how Zebra PTT Pro alerts to the device user.

DND Mode ReminderThis setting provides an Android notification at regular intervals to indicate that the device is inDND mode. Tap the setting to select the notification interval (0 to 60 minutes).

123

Device Settings

Missed Call Endless AlertPlay a repeating alert on missed calls.

Alert Call Ring TimeThe duration in seconds to ring when receiving an alert call.

Default Sound Profile

The Default Sound Profile settings change the default speaker sound and the tones played for call actions.

Screen 1

Minimum Call VolumeSet the default minimum in-call volume.

Ring on Incoming CallRings when receiving a Zebra PTT Pro call.

Vibrate on Incoming CallVibrates when receiving a Zebra PTT Pro call.

124

Device Settings

Tone GainSets the relative gain to play the tones.

Play Grant TonePlays a tone when the user is granted permission to speak.

Vibrate on GrantVibrates the device when the user is granted permission to speak.

Play Taken TonePlays a tone when another user is granted permission to speak.

Screen 2

Play Idle TonePlays a tone when the floor is available for the user to speak.

Play Deny TonePlays a tone when the user is denied permission to speak because another user is speaking.

Play Revoke TonePlays a tone when the user is removed from the floor because the user exceeded the speakingtime limit.

125

Device Settings

Play Call Lost TonePlays a tone when a call is lost.

Play Busy Bonk TonePlays a tone when a call fails to connect.

Headset Sound Profile

Settings to set the headset type, specify minimum call volume, and control vibrate and tone options.

126

Device Settings

Headset TypeSets the headset type:

• Toggle

• Two Pulse

• Event

• Bluetooth SPP

• Bluetooth LE

• None

Minimum Call VolumeA Zebra PTT Pro call will start with at least this minimum volume.

Ring on Incoming CallPlay Zebra PTT Pro Ringer when a PTT Pro call is received.

Vibrate on Incoming CallVibrate phone when a Zebra PTT Pro call is received.

Tone GainSets the relative gain to play tones.

Play Grant TonePlay a tone when the user is granted the floor to talk.

Vibrate on GrantVibrate the phone when the user is granted the floor to talk.

127

Device Settings

Figure 64

Play Taken TonePlay a tone when someone else is granted the floor to talk.

Play Idle TonePlay a tone when the floor is available to talk.

Play Deny TonePlay a tone when the user is denied the floor because someone else is talking.

Play Revoke TonePlay a tone when the floor is taken from the user because the user talked too long.

Play Call Lost TonePlay a tone when a call is lost.

Play Busy Bonk TonePlay a tone when a call fails to connect.

128

Device Settings

Voice Command Configuration

Voice command configuration enables to the user to control how the device responds to voice commands.

Confirm PTT call TargetAsks user to confirm the contact, group, or default callee before making PTT call.

Confirm Message TargetAsks user to confirm the contact or group before sending the message.

Confirm Message DetailAsks user to confirm the message before sending it.

Announce Message Cancel ConfirmationConfirms that the message was cancelled.

Confirm Individual Message DeletionAsks the user to confirm the deletion of a message.

Enable Voice Command Help ScreenEnables the activity screen that provide the user visual feedback of voice command activity.

129

FAQ & TroubleshootingFAQ & Troubleshooting

The following section contains answers commonly asked questions.

What devices does Zebra PTT Pro for Android support?Zebra PTT Pro supports the following Zebra Android devices running Android 8.0, Android 10, and Android11:

• CC600/CC6000

• EC30

• EC50/EC55

• ET51/ET56

• L10A

• MC20

• MC2200/MC2700

• MC3300/MC3300x/MC3300ax

• MC9300

• PS20

• TC20/TC25

• TC21/TC26

• TC51/TC56

• TC52/TC57

• TC52x/TC57x/TC52ax

• TC70x/TC75x

• TC72/TC77

• TC8300

• VC80x

• VC8300

• WT6300

130

FAQ & Troubleshooting

NOTE:

• Devices running Android 4.4 (KitKat) must use Zebra PTT Pro version 3.2.10087 or below.

• Devices running Android 5 (Lollipop), 6 (Marshmallow) and 7 (Nougat), use version 3.3.10134or below.

What Headsets Does Zebra PTT Pro Support?Zebra PTT Pro supports wired and wireless (Bluetooth) headsets.

NOTE: Bluetooth headsets require that you enable the Allow Bluetooth Audio setting.

Model Wired orWireless Type

Audio PassThrough Only

SupportsPTT Button

SupportsVoice Comman

Headset Type

AINA PTT VoiceResponder

Wireless(Bluetooth andBluetooth LowEnergy)

Yes Yes No Bluetooth LE

Blue Ant Q3 Wireless(Bluetooth)

Yes No No

Jabra BlueParrott

• C300-XT

• B350-XT(204260)

• C400-XT

• B450-XT

• B550-XT

• M300-XT

Wireless(Bluetooth andBluetooth LowEnergy)

Yes Yes Yes None

Jabra BT 2080 Wireless(Bluetooth)

Yes No No

JBL Clip2 Wireless(Bluetooth)

Yes No No

Motorola EliteSilver 2

Wireless(Bluetooth)

Yes No No

Re-Fuel Wireless(Bluetooth)

Yes No No

Savox BTH-101 Wireless(Bluetooth)

Yes Yes No SPP

Savox BTR-155(K551051)

Wireless(Bluetooth)

Yes Yes No SPP

Table 24 Headsets Validated with Zebra PTT Pro

131


Model Wired orWireless Type

Audio PassThrough Only

SupportsPTT Button

SupportsVoice Comman

Headset Type

Savox RSM-30Supported onAndroid 8 andbelow

Wired Yes Yes No Two Pulse

VXi VR11/VR12 Wired Yes No No

Zebra ADP-USBC-35MM1-01

Wired USBC to3.5mm adapter

Yes Yes Yes None

ZebraHDST-35MM-PTT1-01

Wired Yes Yes Yes None

ZebraHDST-25MM-PTVP-01


ZebraHDST-35MM-PTVP-01


Zebra HS2100 Wired Yes No No None

Zebra HS3100 Wireless(Bluetooth)

Yes No No

Table 24 Headsets Validated with Zebra PTT Pro (Continued)

Supported LanguagesWhen the device language is set to a supported language, Zebra PTT Pro uses the specified language fortext elements within the user interface.

• Czech

• Dutch

• English

• French (Canada)

• French (France)

• German

• Hungarian

• Italian

• Polish

• Russian

• Slovak

• Spanish

• Swedish

132


FAQFrequently asked questions about .

Can Zebra PTT Express be enabled on devices where Zebra PTT Pro is being installed?No, Zebra PTT Express should not be enabled on devices where Zebra PTT Pro is installed.

When should the date and time on the device be verified?Verify the correct date and time are set on the device before installing Zebra PTT Pro,

Which Call Priority options are supported?For Zebra Android devices, the Call Priority setting should be set to Voice (default). Other callpriority options are not supported.

Zebra PTT Pro automatically launches to the foreground when the device rebootsOn Android 11, PTT Pro automatically launches to the foreground after the device reboots. Thisbehavior allows PTT Pro to make a PTT call using the Push To Talk button when in the background.

133

TroubleshootingTroubleshooting

Problem Cause Solution

Activation is not completedon the client.

In order to complete activation ofthe client, the system administratormust first provision a user in theZebra PTT Pro ManagementPortal.

Contact the system administratorto provision the user.

The Map tab appears blackor blue.

The Location Services feature onthe device is turned off.

The Google Play services featureon the device is disabled and/or isout-of-date.

A firewall is blocking access toGoogle Maps.

Turn on the device’s LocationServices.

Enable and/or update Google Playservices.

For more information aboutLocation Services and GooglePlay services for a specific device,refer to the documentation for thatdevice.

Table 25 Troubleshooting PTT Pro for Android

134

www.zebra.com