1. Workcloud Communication Voice Client Programmer Guide
  2. Actions
  3. Phone State Monitoring
  • Workcloud Communication Voice Client Programmer Guide
Phone State Monitoring

Phone State Monitoring

The Zebra Voice Client broadcasts its status using the following intent. This is an intent that is sent by the Zebra Voice Client. A third-party application can register to receive the intents; example code is below:

Prerequisites

  • Zebra Voice Client is loaded to the device.
  • The third-party application must register to receive the intents as described in Phone State Example.
  • All versions of Zebra Voice Client 9.0 support these intents.

Intent Definition

Name
Description
Action
wfc.voice.PHONE_STATE
extras
registration_state
PBX registration state
ACTIVE|ACTIVE_DND|CONNECTING|INACTIVE
state
Voice call state
IDLE|CALLING|RINGING|ACTIVE
number
Phone number for the current session that is reported when the voice call state changes (optional).
line_id
Line number that is reported when one of the line registers (optional).
line_extension
Line extension that is reported when one of the lines registers (optional).
line_registered
Boolean expression that is reported when one of the lines registers (optional).
suspended
Boolean expression that is reported when the state is
IDLE
 because one of the sessions is suspended or on hold (optional)
The suspended extra is only available in Zebra Voice version 9.0.21104 or later.

Phone State Example

The following code example registers the phone state intent from a third party app.
// create broadcast receiver
BroadcastReceiver mMessageReceiver = new BroadcastReceiver() 
{
          @Override
          public void onReceive(Context context, Intent intent) 
            {
                Log.i(TAG,
                      "Received PHONE_STATE from WFCVoice “
                    + " registration_state=" + intent.getStringExtra("registration_state")
                    + “ call state=" + intent.getStringExtra("state")
                    + " number=" + intent.getStringExtra("number")
                    + " line_id=" + intent.getStringExtra("line_id")
                    + " line_extension=" + intent.getStringExtra("line_extension")
                    + " line_registered=" + intent.getBooleanExtra("line_registered", false)
                    );
            }
};
  
// register broadcast receiver in the Activity
IntentFilter mMessageReceiver = new IntentFilter();
requestFilter.addAction(“wfc.voice.PHONE_STATE”);
registerReceiver(mMessageReceiver, requestFilter);