hp.opencall.media.ccapi
Interface ExternalEventScheduler

All Known Implementing Classes:

CCSession

Deprecated. As of OC MP 2.4, no longer supported.

public interface ExternalEventScheduler

Defines methods used for external events handling.

Method Summary

void	addExternalEventListener(ExternalEventListener listener) Deprecated. Adds the specified listener to receive external events.
void	notifyExternalEvent(EventObject event) Deprecated. Notifies an external event to the session/oclet.
void	removeExternalEventListener(ExternalEventListener listener) Deprecated. Removes the specified listener so it no longer receives external events.

Method Detail

addExternalEventListener

public void addExternalEventListener(ExternalEventListener listener)
                              throws TooManyListenersException

Deprecated.

Adds the specified listener to receive external events.

External events are generic events of type EventObject. They can be generated from Application Threads, that is any thread which is not a platform User Thread. For example a timer handler.

A listener object implementing the ExternalEventListener interface must be created in the application to receive external events through onExternalEvent. See Thread Management section in CCSession for more details.

NOTE: Only one listener is currently allowed.

Parameters:

listener - The listener object.

Throws:

TooManyListenersException

Since:

Deprecated

removeExternalEventListener

public void removeExternalEventListener(ExternalEventListener listener)

Deprecated.

Removes the specified listener so it no longer receives external events.

Parameters:

listener - The listener object.

Since:

Deprecated

notifyExternalEvent

public void notifyExternalEvent(EventObject event)

Deprecated.

Notifies an external event to the session/oclet.

This method must be used whenever an external event, such as a timer, has to be processed by the application. An external event is a generic event generated from any thread, i.e. a thread that has been explicetely or implicitely created by the application and which is not a platform User Thread.

The main purpose of this method is to ensure appropriate platform synchronization for processing external events. It will cause a previously registered listener (registered by addExternalEventListener) to receive the event through invocation of onExternalEvent (see ExternalEventListener) in a platform User Thread. Since onExternalEvent is invoked in a User Thread, any Call-control API method can be called then.

Parameters:

event - The external event that must be passed in the call to onExternalEvent.

Since:

Deprecated