Call Status

Prerequisites

The minimum required

PTT Pro for Android

version is 3.3.10271.

Intent Definition

Name	Definition
Action	com.symbol.wfc.pttpro.PTTPRO_CALL_STATUS
Intent Type	broadcast
Extra	Returns information about call status
PTT_PRO_CALL_STATUS	String Possible values: CALL_STARTED_OUTGOING CALL_STARTED_INCOMING CALL_ENDED CALL_FAILED
PTT_PRO_CALL_STATUS_CODE	Int
PTT_PRO_CALL_STATUS_REASON	String
PTT_PRO_CALL_STATUS_DETAILED_REASON	String

Register for the broadcast as shown in the code example, listen with action

PTTPRO_CALL_STATUS

, and filter the result with extra types to get the status and other information from the broadcast.

Code Example

IntentFilter call_info = new IntentFilter();
call_status.addAction("com.symbol.wfc.pttpro.PTTPRO_CALL_STATUS");
registerReceiver(mReceiver,call_status);

Status Code

The PTT_PRO_CALL_STATUS_CODE has the following codes and reasons:

Status Code	Status Reason	Detailed Reason
0	UNKNOWN	The reason is unknown
1	NO_RESOURCES	There are no call resources available on the server.
2	USER_INITIATED	User-initiated call-clearing
3	UNAVAILABLE	The called party was unavailable
4	SIGNED_OUT	The called party was signed out of ESChat
5	NOT_RESPONDING	The called party was not responding.
6	BUSY	The called party was busy.
7	LIST_NOT_SYNCED	The group list was not in sync
8	GROUP_FULL	The group was full
9	NO_PRIVS	The user does not have high enough privilege to call this contact or group
10	DND	The user was in Do Not Disturb mode
11	CIRCUIT_CALL	The user was in or started a Circuit Switched voice call
12	CALL_DROPPED	The call was dropped
13	CRYPTO_ERROR	There was a security problem and the call was cleaned up
14	SILENT	The user device is in silent mode
15	USER_REJECT	The user rejected the incoming alert call
16	NO_ANSWER	There was no answer to the alert call
17	OVERRIDE	The user was removed from this call for a higher-priority call
18	DUPLICATE_GROUP	Received an invite to a group, but the call for that group is already in session
19	REMOVED_FROM_GROUP	The User has been removed from a group while in a call with that group
20	NOT_SUPPORTED	The called party does not support the type or options of a call it's invited to
21	AMBIGUOUS_NAME	The name specified in a call does not have a single match so the call cannot proceed
22	EXTERNAL_NETWORK_UNAVAILABLE	The Called party can not be reached because the external network it is on was unavailable
23	LISTEN_ONLY	A listen Only Group Member sent an Invite to a group that is not in-call
24	TRY_AGAIN	The client should retry the call request again in 20 msec (or longer).
25	IDLE_TIMEOUT	The call ended with an idle timeout
26	TARGET_NOT_FOUND	The client attempts a call to an unknown group or user(s).
27	RECONFIGURED	Indicates a configuration change that forced the call to end
28	USER_INITIATED_WITH_BLOCK	User-initiated call clearing and the user will block the group

Status Code Usage Example

public void onReceive(Context context, Intent intent) {
    String action= intent.getAction();
    if(action.equals("com.symbol.wfc.pttpro.PTTPRO_CALL_STATUS")) {
       String status ="";

     if (intent.hasExtra("PTT_PRO_CALL_STATUS") { 
        status = intent.getStringExtra("PTT_PRO_CALL_STATUS");
        Log.d("TAG","Call status:- "+status);
    }

           if(status.equals("CALL_ENDED") || status.equals("CALL_FAILED")) {
       Log.d("TAG","PTT_PRO_CALL_STATUS_CODE:- "+intent.getIntExtra("PTT_PRO_CALL_STATUS_CODE",0));
       Log.d("TAG","PTT_PRO_CALL_STATUS_REASON:- "+intent.getStringExtra("PTT_PRO_CALL_STATUS"));
       Log.d("TAG","PTT_PRO_CALL_STATUS_DETAILED_REASON:- "+intent.getStringExtra("PTT_PRO_CALL_STATUS_DETAILED_REASON")); 
    }

}