Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
4-57
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1)
Chapter 4 Building Your Application
Working with Calls
CTIOS_NOTREADYREASONCODES - This Arguments array provides a list
of the not ready reason codes configured on CTIOS server. They can be obtained
using the GetValueArray method on the Agent object.
of the not ready reason codes configured on CTIOS server. They can be obtained
using the GetValueArray method on the Agent object.
When Does the Application Receive the
OnButtonEnablementChange() Event?
OnButtonEnablementChange() Event?
An application receives an OnButtonEnablementChange() event in the following
situations:
situations:
•
When the Current Call is changed.
•
When the call which is the Current Call receives an event which includes a
CTIOS_ENABLEMENTMASK argument. Usually the included enablement
mask is changed from what it was set to, but occasionally it is the same. This
mask is used to indicate which functions are allowed for this Call in its
current state.
CTIOS_ENABLEMENTMASK argument. Usually the included enablement
mask is changed from what it was set to, but occasionally it is the same. This
mask is used to indicate which functions are allowed for this Call in its
current state.
For example, when a Call receives an OnCallDelivered() event with a
Connection State of LCS_ALERTING, its enablement mask is changed to set
the Answer bit. When this Call is answered, and it receives the
OnCallEstablished() event, the mask no longer sets the Answer bit, but
instead enables the Hold, Release, TransferInit and ConferenceInit bits.
Connection State of LCS_ALERTING, its enablement mask is changed to set
the Answer bit. When this Call is answered, and it receives the
OnCallEstablished() event, the mask no longer sets the Answer bit, but
instead enables the Hold, Release, TransferInit and ConferenceInit bits.
What to do in the OnButtonEnablementChange() Event
To see if a button should be enabled, simply do a bitwise "AND" with the
appropriate value listed in the Table included under the
OnButtonEnablementChange event in Chapter 6.
appropriate value listed in the Table included under the
OnButtonEnablementChange event in Chapter 6.
The following examples shows this in Java:
Integer IMask = rArgs.GetValueIntObj(CTIOS_ENABLEMENTMASK);
if (null != IMask) {
int iMask = IMask.intValue();
if (iMask & ENABLE_ANSWER) {
//Enable the AnswerCall button
}
else {
//Disable the AnswerCall button
}
}
// else do nothing