com.cisco.telephony

Provides support for Cisco telephony features.

Cisco supports more extensive telephony features than what the Android Telephony API includes.

The Cisco Telephony API allows you to originate calls, terminate calls, put calls on hold, start conference calls, and many other features.

The Cisco Telephony API also contains more information about the call including data such as:

• incoming name/number
• outbound name/number
• which line the call is on
• the number of participants in the call
• and more.

The Cisco Telephony API also offers more call states as opposed to Android Telephony which only offers three.

The Cisco Cius supports both the Cisco Telephony API and the Android Telephony API.
This allows you to use the one that best suits your needs.

The Cisco Telephony API is organized around three main interfaces: CiscoTelephonyManagerDevice, CiscoTelephonyManagerLine, CiscoTelephonyManagerCall.

The CiscoTelephonyManagerDevice provides device services, allows you to add listeners on the device level, create calls, get device info (CiscoTelephonyManagerDeviceInfo), and toggle states.

The CiscoTelephonyManagerLine provides line services, allows you to add listeners at the line level, and allows you to create calls and get line info ( CiscoTelephonyManagerLineInfo).

The CiscoTelephonyManagerCall provides call services, allows you to add listeners at the call level, create calls, dial voice mail, start conferences, transfer calls, terminate calls, and get call info (CiscoTelephonyManagerCallInfo).

The following basic steps to get started with using this API are demonstrated in the SamplePhoneApplication that is included in the add-on download.

1. Retrieve an instance of the Cisco Telephony Manager.
2. Get the Device from the Cisco Telephony Manager.
3. Create a Cisco Telephony Call Listener.
4. Add the Call Listener to the device.

 public void onCreate() {
 	super.onCreate();
		
 	ctm = (CiscoTelephonyManager)getSystemService(CiscoTelephonyManager.CISCO_TELEPHONY_MANAGER);
 	device = ctm.getCiscoTelephonyManagerDevice();
		
 	callListener = ctm.new CiscoTelephonyManagerCallListener() {
 		public void onCallEvent(CallEventID evID, CiscoTelephonyManagerCall ctmCall, CiscoTelephonyManagerCallInfo ctmCallInfo) {
 			try {
 				//Perform Actions on the Call
 				CallPartyId called = ctmCallInfo.getCalledParty();
 				String calledName = called.getPartyName();
 			} catch (CiscoTelephonyManagerCallInfoInvalidObject e) {
 				e.printStackTrace();
 			}
 		}	
 	};
		
 	device.addCallListener(callListener);
 }