Client overview

There are client's features for PTT service.

PTT signalling

PTT signalling type

Touch/Click

PTT signalling by User Touch/Click.

Volume key

PTT signalling by smart phone's volume key.

Maker Model Supported Issues
SAMSUNG Galaxy S8 Note O
Galaxy S8 O
Galaxy S7 Edge O
Galaxy S7 O
Galaxy S6 Edge+ * Required on with "Allow using button when media is playing" option
Galaxy S5
Galaxy S4
Galaxy S3 X
Galaxy S2 X
Galaxy Alpha
Galaxy Note 4
Galaxy Note 3
Galaxy Note 2
LG V30
G5
G4
G3A
G2
Optimus View 2
Motolora MotoG X
SONY XPERIA Z2
Xiaomi Redmi Note 2

PTT key

PTT signalling by a dedicated device's PTT key. (Android only)
Belows are dedicated key and boradcast event

Type Key code Braodcast intent Remark
PTT lock 230 android.intent.action.PTT.down
PTT unlock 230 android.intent.action.PTT.up

Bluetooth

1) PTT signalling by Bluetooth's a dedicated PTT button.

2) PTT signalling by Bluetooth's a play button.

Earset

PTT signalling by Earset's Play button.

Keyboard

PTT signalling by a space key.

In case of an android version, user can choice the key in setup.

VOX(Voice-Operated Switch)

PTT signalling by VAD(Voice Activity Detector).

In case of ProGate, is also support SAD(Scratch Activity Detector).

Emergency lock

PTT signalling by Administrator. User's PTT signal will be broken.

Competition lock

All user can request a lock before other user's unlock. When other user's lock is released, one of competition lock users can have the next lock. It would be depend on network and system status.

Master lock

In PTT, normally only a user can have lock. But in multi lock mode, channel owner can have another lock at the same time.

SOS signalling

SOS key

SOS signalling by a dedicated device's SOS key. (Android only)
Belows are dedicated key and boradcast event

Type Key code Braodcast intent Remark
SOS 229 android.intent.action.SOS.up
android.intent.action.SOS.longpress

Channel changing

Channel changing key

Channel changing by a dedicated device's key. (Android version 3.0.8~, Embedded version 3.0.3~)
Belows are dedicated key and boradcast event

Type Key code Braodcast intent Remark
Move to Previous Channel 220 android.intent.action.channelup.up
android.intent.action.channel.up
Move to Next Channel 221 android.intent.action.channeldown.up
android.intent.action.channel.down

Android App Launch

Other app can launch ProPTT2 Android client by Intent.

Client Package name Remark
Android Client com.imptt.proptt
Android Embedded Client com.imptt.proptt.embedded​
Intent intent = this.getPackageManager().getLaunchIntentForPackage(packageName);
intent.setAction(Intent.ACTION_MAIN);
startActivity(intent);

Android standard event

ProPTT2 client fire events for device or external app. (Android version 3.1.0~, Embedded version 3.1.0~)
Belows are boradcast events

Braodcast intent Parameter Remark
android.intent.event.log.in userId(string), userName(string)
android.intent.event.log.out
android.intent.event.ptt.locked channelNo(string), lockerId(string), lockerName(string)
android.intent.event.ptt.unlocked channelNo(string), lockerId(string)
android.intent.event.sos.fired channelNo(string), senderId(string), senderName(string)
android.intent.event.alert.fired channelNo(string), message(string)
android.intent.event.channel.joined channelNo(string) It is for only current user.
android.intent.event.channel.leaved channelNo(string) It is for only current user.
android.intent.event.latency latency(int) millisecond. round-trip latency

Android device provisioning

ProPTT2 client support device provisioning. (Android version 3.1.0~, Embedded version 3.1.0~)
Device supplier can provision device for customer.
It would be usefull for non-screen device.

The provisioning is based on ProPTT2.ini. The ini file must be in {USB mounted}/ProPTT2.
ex)
/storage/emulated/0/ProPTT2/ProPTT2.ini
/sdcard/ProPTT2/ProPTT2.ini
* The rooting is not requried.

If you don't want to provision a field, you can remove the field, then the operation would be on default.

Field Name Available Value Description
DisableService true/false Disable service feature on log-in
CompanyLogo png file name Set logo image on log-in
ServerAddress Text Server's address. Domain name is possible.
UserID Text Android: User's ID without domain.
Embedded: UserID@Domain
Domain Text User's domain. Android only
UserPassword Text User's password
EncryptedUserPassword Text Encryped user's password. It will work with [AutoLogIn] option
Sha512(Password)
(Android 4.1.0~, Embedded 4.1.0~)
UseSecureLogin true/false Use secured login
UseIMEI true/false Use IMEI authentication
UsePhoneNumber true/false Use phone number authentication
UseMobileOnly true/false Use mobile network only
AutoLogIn true Use auto login
AutoReconnect true Use auto reconnect
AutoStart true Use auto start at boot
StartChannel 0 or above
0: The first channel,
1~: channel number to be joined
Use auto join to channel at boot
(Android version 3.1.10~, Embedded version 3.1.9~)
UseDisconnectSound false Use a sound when disconnect
PTTMode "hold"/"toggle" Select PTT button type
UseInterception true User interception of channel owner
EarphoneMode "hold"/"toggle" Select earphone type
AudioQuality "high"/"medium"/"low" Select audio quality
LocationSensitivity "high"/"medium"/"low" Select location sensitivity
LocationSendingInterval 10~50 Set the interval of location sending
PTTKeycode Number Set android key code for PTT
ex)230
PTTBroadcastDown Text Set android broadcast for PTT key down
ex)android.intent.action.PTT.down
PTTBroadcastUp Text Set android broadcast for PTT key up
ex)android.intent.action.PTT.up
SOSKeycode Number Set android key code for SOS
ex)229
SOSBroadcast Text Set android broadcast for SOS fire
ex)android.intent.action.SOS.up
NextChennelKeycode Number Set android key code for NextChennel
NextChennelBroadcast Text Set android broadcast for NextChennel fire
PrevChennelKeycode Number Set android key code for PrevChennel
PrevChennelBroadcast Text Set android broadcast for PrevChennel fire
SkipConnectedChannel true/false Whether skip the connected channel on channel moving
PlayKeycode Number Set android key code for playing of last PTT
PlayBroadcast Text Set android broadcast for last PTT playing fire
StartChannel 0:The first channel, 1~:Channel number Set channel number to be started at loading
(Android 3.1.9~, Embedded 3.1.8~)
UsePTTSendSound true/false Use the PTT sound for sending time
(Android 3.4.10~, Embedded 3.4.5~)
UsePTTReceiveSound true/false Use the PTT sousoundnf for receiving time
(Android 3.4.10~, Embedded 3.4.5~)
UsePTTEndSound true/false Use the PTT sound for end time
(Android 3.4.10~, Embedded 3.4.5~)
UseSOSSendSound true/false Use the SOS sound for sending time
(Android 3.4.10~, Embedded 3.4.5~)
UseSOSReceiveSound true/false Use the SOS sound for receiving time
(Android 3.4.10~, Embedded 3.4.5~)
UseAlertReceiveSound true/false Use the Alert sound for receiving time
(Android 3.4.10~, Embedded 3.4.5~)
TouchableDevice true/false Does this device have a touchable LCD. Menus will be hide on screen.
(Only Embedded 4.0.2~)
NonScreenDevice true/false Does this device have no LCD. Support TTS for the start channel
(Only Embedded 4.0.3~)
KioskMode true/false Use Kiosk Mode
(Only Embedded 4.0.5~)
CompanyName Text Login text on login screen wil be changed.
(Only Embedded 4.1.0~)

PTT Call Model

PTT has several types of call.

1:N Channel

It is a general call model.

1:N Group

Group means a temporary channel for 1:N.

1:1 Peer

It is one of group.

Features

There are general features of PTT device.

TOT

It is "Time Out Timer".

DTMF

It is "Dual Tone Multiple Frequency". Some radio devices support DTMF. But smartphone app don't use DTMF directly.

PTT Processing Type

There are several processing types for PTT.

Type Record and send(Not real-time) Half real-time Full real-time(VOIP mode) Master's PTT(VOIP mode)
Advatage Support off-line PTT Good audio quality Best responsiblity
Can support full-duplex in multi-channel
No limitation of TOT
Can support full-duplex in same channel
Disadvatage Low responsiblity
Can not support full-duplex
Delayed PTT sound
Can not support full-duplex
Normal audio quality(VOIP) Required better jitter for long communication
Product Company V Company Z Company
ProPTT2(Android, Embedded)
ProPTT2 ProPTT2

Half real-time

Used half-duplex and delayed recieved audios until recording.

Half real-time

Full real-time

Used full-duplex and played recieved audios promptly.

Full real-time

Master's PTT

Used full-duplex and There are sending and receving in same channel at the same time.

Master's PTT