Interface java.telephony.CallObserver
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface java.telephony.CallObserver

public interface CallObserver
extends Object
The CallObserver interface reports all state changes on the Call object as events. It also reports all state changes in Connections and TerminalConnections which are associated with this Call. Applications instantiate an object which implements this interface and uses the Call.addObserver() method to begin the delivery of events to this object. Applications may use the Call.removeObserver() method to discontinue the delivery of events to an observer object. A list of observers on the Call object can be obtained via the Call.getObservers() method. Events will be delivered to the CallObserver interface only if the Provider is in the Provider.IN_SERVICE state.

The CallObserver interface has one method: callChangedEvent(). This method takes a single argument, an array of CallEv objects. Applications iterate over this array for the individual events. All Call, Connection, and TerminalConnection events must extend the java.telephony.events.CallEv interface.

The CallObserver reports a list of events because several state changes may occur at once. To maintain the consistency between the state changes in the call model and the events reported to the application, several events may need to be delivered at once.

The CallObserver interface reports the following events. The hyper-links below provide access to the specifications for these events.

See Also:
CallEv, ConnEv, TermConnEv, CallActiveEv, CallInvalidEv, ConnAlertingEv, ConnConnectedEv, ConnCreatedEv, ConnDisconnectedEv, ConnFailedEv, ConnInProgressEv, ConnUnknownEv, TermConnActiveEv, TermConnCreatedEv, TermConnDroppedEv, TermConnPassiveEv, TermConnRingingEv

Method Index

 o callChangedEvent(CallEv[])
Reports all events on the CallObserver interface.

Methods

 o callChangedEvent
  public abstract void callChangedEvent(CallEv eventList[])
Reports all events on the CallObserver interface. This method takes an array of CallEv object as its argument which reports all these state changes which have occurred on the Call, Connection, and TerminalConnection object.

Parameters:
eventList - The list of Call events.

All Packages  Class Hierarchy  This Package  Previous  Next  Index