javax.telephony
Interface CallEvent

All Superinterfaces:
Event
All Known Subinterfaces:
CallCenterCallEvent, CallCenterConnectionEvent, CallCenterTrunkEvent, CallControlCallEvent, CallControlConnectionEvent, CallControlTerminalConnectionEvent, ConnectionEvent, TerminalConnectionEvent

public interface CallEvent
extends Event

The CallEvent interface is the base interface for all Call-related events. All Call-related events must extend this interface. Events which extend this interface are reported via the CallListener interface.

An individual CallEvent conveys one of a series of different possible Call state changes; the specific Call state change is indicated by the Event.getID() value returned by the event.

The core package defines events which are reported when the Call changes state. The event IDs (as returned by Event.getID()) are: CALL_ACTIVE and CALL_INVALID. Also, the core package defines the CALL_EVENT_TRANSMISSION_ENDED event ID which is sent when the the application can no longer listen for Call events.

These event IDs are reported via methods in the CallListener interface (see method CallListener.CallInvalid)

The ConnectionEvent and TerminalConnectionEvent interfaces extend this interface. This reflects the fact that all Connection and TerminalConnection events are reported via the CallListener interface.

The CallEvent.getCall() method on this interface returns the Call associated with the Call event.

Version:
04/06/99 1.4
See Also:
Event, ConnectionEvent, TerminalConnectionEvent, CallListener, Call

Field Summary
static int CALL_ACTIVE
          The CALL_ACTIVE event indicates that the state of the Call object has changed to Call.ACTIVE.
static int CALL_EVENT_TRANSMISSION_ENDED
          The CALL_EVENT_TRANSMISSION_ENDED event indicates that the application will no longer receive Call events on the instance of the CallListener.
static int CALL_INVALID
          The CALL_INVALID event indicates that the state of the Call object has changed to Call.INVALID.
 
Fields inherited from interface javax.telephony.Event
CAUSE_CALL_CANCELLED, CAUSE_DEST_NOT_OBTAINABLE, CAUSE_INCOMPATIBLE_DESTINATION, CAUSE_LOCKOUT, CAUSE_NETWORK_CONGESTION, CAUSE_NETWORK_NOT_OBTAINABLE, CAUSE_NEW_CALL, CAUSE_NORMAL, CAUSE_RESOURCES_NOT_AVAILABLE, CAUSE_SNAPSHOT, CAUSE_UNKNOWN
 
Method Summary
 Call getCall()
          Returns the Call object associated with this Call event.
 
Methods inherited from interface javax.telephony.Event
getCause, getID, getMetaEvent, getSource
 

Field Detail

CALL_ACTIVE

public static final int CALL_ACTIVE
The CALL_ACTIVE event indicates that the state of the Call object has changed to Call.ACTIVE.

This constant corresponds to a specific call state change, is passed via a CallEvent event, and is reported to the CallListener.callActive method.

See Also:
Constant Field Values

CALL_INVALID

public static final int CALL_INVALID
The CALL_INVALID event indicates that the state of the Call object has changed to Call.INVALID.

This constant corresponds to a specific call state change, is passed via a CallEvent event, and is reported to the CallListener.callInvalid method.

See Also:
Constant Field Values

CALL_EVENT_TRANSMISSION_ENDED

public static final int CALL_EVENT_TRANSMISSION_ENDED
The CALL_EVENT_TRANSMISSION_ENDED event indicates that the application will no longer receive Call events on the instance of the CallListener.

This constant corresponds to this specific circumstance, is passed via a CallEvent event, and is reported to the CallListener.callEventTransmissionEnded method.

See Also:
Constant Field Values
Method Detail

getCall

public Call getCall()
Returns the Call object associated with this Call event.

Returns:
The Call associated with this event.


Copyright © 2005 Avaya All Rights Reserved.