1. Workcloud Communication PTT Pro for Android Programmer Guide
  2. Intents and Actions to Initiate Calls and Messages
  3. Initiate a PTT Call
  • Workcloud Communication PTT Pro for Android Programmer Guide
Initiate a PTT Call

Initiate a PTT Call

Use this intent to initiate a PTT call to a group or to one or more users. When multiple users are included, an ad hoc group call is initiated. You can also use this intent to initiate a one-to-one call in
PTT Pro
.

Prerequisites

  • When initiating a call to a group, the group must be defined in the
    PTT Pro server
     and the user who initiates the PTT call (i.e., the target of the intent) must be a member of the group.
  • When initiating a call to one or more users, the usernames(s) must be defined in the
    PTT Pro server
    .
  • The minimum required PTT Pro Android version is 3.3.10134.
User or group information with the intent is not mandatory, in such case one of the following-mentioned actions take place and supports from PTT Pro Android version is 3.3.10311 and later.
  • Initiate a PTT Pro call to the selected user or group displayed in the PTT Pro UI if no specific user or group is mentioned in the PTT Pro Call intent.
  • Initiate a call to the Default Callee when the device is in the background, the Default Callee is configured, and no specific user or group is designated in the PTT Pro Call intent.

Intent Definition

Name
Description
Action
com.symbol.wfc.pttpro.ACTION_PTT_PRO_CALL
Intent Type
broadcast
Extra 0
This extra defines whether the call is targeted to a group or users. This is a mandatory parameter.
          Type
Integer
          Name
recipientType
          Value
1 to target the call to a group.
0 to target the call to 1 or more users.
Extra 1
This extra defines the recipient(s) of the call. This is a mandatory parameter.
          Type
String
          Name
recipientName
          Value
Use the group name or the user name(s) exactly as they appear in the
PTT Pro Server
.

ADB Examples

Call a group:
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_PRO_CALL --ei recipientType 1 --es recipientName 'staff_admin'
Call a user:
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_PRO_CALL --ei recipientType 0 --es recipientName 'george.shaw'
Call multiple users:
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_PRO_CALL --ei recipientType 0 --es recipientName 'george.shaw,ira.gershwin,cole.porter'