• Workcloud Communication PTT Pro for Android Programmer Guide
Launch a PTT Pro Messaging Window
Launch a PTT Pro Messaging Window

Launch a PTT Pro Messaging Window

This intent is used to pop-up the
PTT Pro for Android
 messaging dialog. The intent can optionally include a group or one or more users. If a group or users are not included, the dialog opens with no recipients, and the user must specify them.

Prerequisites

  • When initiating a message to a group, the group must be defined in the
    PTT Pro Server
    , and the initiating PTT Pro user (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 for Android
     version is 3.2.10066.

Intent Definition

Name
Description
Action
com.symbol.wfc.pttpro.ACTION_PTT_MESSAGE
Intent Type
broadcast
Extra 0
This extra defines whether the call is targeted to a group or to users. This is an optional parameter, but it must be included if the
target
 parameter is included.
          Type
String
          Name
tab
          Value
g to target the call to a group
c to target the call to 1 or more users
Extra 1
This extra defines the recipient(s) of the call. This is an optional parameter, but it must be included if the tab parameter is included.
          Type
String
          Name
target
          Value
Use the Group name or Username(s) exactly as it appears in the
PTT Pro Server
.
The following points are provided as notes on the target:
  1. When sending to a group, only one group can be specified.
  2. When sending to users, single or multiple users can be included. When including multiple user names, separate them with a comma.
  3. Recipient names (user or group) are case-sensitive.
  4. Two types of groups can be created by a PTT Pro user. When sending messages or initiating calls to these types of groups, the group name must be specified in the intent as a fully qualified group name. The two group types and the required formatting are defined below:
    • Personal Groups
      : Created by a user and only visible from the creator's Group List. Only the creator can initiate a call to a Personal Group. The fully qualified group name is specified as "<
      group-name
      >%<
      creator-user-name
      >", where
      creator-user-name
       is the PTT Pro user name of the creator.
    • Member Groups
      : Visible in all member's Group Lists. Any member of the group can initiate a call to the group. The fully qualified group name is specified as "<
      group-name
      >@<
      creator-user-name
      >", where
      creator-user-name
       is the PTT Pro user name of the creator.

ADB Examples

Sending to a group: 
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_MESSAGE --es "tab" "g" --es "target" "Hardware"
Sending to a user: 
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_MESSAGE –es “tab” “c” --es "target" "george.shaw"
Sending to multiple users: 
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_MESSAGE --ei “tab” “c” --es " target" "george.shaw,ira.gershwin,cole.porter"
Sending without specifying recipients: 
adb shell am broadcast -a com.symbol.wfc.pttpro.ACTION_PTT_MESSAGE