diff --git a/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java b/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java index cb5cf2b5c..f7e7325af 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallChangeListener.java @@ -9,11 +9,32 @@ import java.util.*; /** - * Allows notification for new call participants, theme changes and - * other call state events. + * A call change listener receives events indicating that a call has changed and + * a participant has either left or joined. + * * @author Emil Ivov */ -public class CallChangeListener - implements EventListener +public interface CallChangeListener + extends EventListener { + /** + * Indicates that a new call participant has joined the source call. + * @param evt the CallParticipantEvent containing the source call + * and call participant. + */ + public void callParticipantAdded(CallParticipantEvent evt); + + /** + * Indicates that a call participant has left the source call. + * @param evt the CallParticipantEvent containing the source call + * and call participant. + */ + public void callParticipantRemoved(CallParticipantEvent evt); + + /** + * Indicates that a change has occurred in the state of the source call. + * @param evt the CallChangeEvent instance containing the source + * calls and its old and new state. + */ + public void callStateChanged(CallChangeEvent evt); } diff --git a/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java b/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java index ceb90b108..511f42629 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallParticipantListener.java @@ -10,10 +10,50 @@ /** + * Receives events notifying of changes that have occurred within a + * CallParticipant. Such changes may pertain to current call + * participant state, their display name, address, image and (possibly in the + * future) others. + * * @author Emil Ivov */ public interface CallParticipantListener extends EventListener { - public void participantChange(CallParticipantChangeEvent evt); + + /** + * Indicates that a change has occurred in the status of the source + * CallParticipant. + * + * @param evt The CallParticipantChangeEvent instance containing + * the source event as well as its previous and its new status. + */ + public void participantStateChanged(CallParticipantChangeEvent evt); + + /** + * Indicates that a change has occurred in the display name of the source + * CallParticipant. + * + * @param evt The CallParticipantChangeEvent instance containing + * the source event as well as its previous and its new display names. + */ + public void participantDisplayNameChanged(CallParticipantChangeEvent evt); + + /** + * Indicates that a change has occurred in the address of the source + * CallParticipant. + * + * @param evt The CallParticipantChangeEvent instance containing + * the source event as well as its previous and its new address. + */ + public void participantAddressChanged(CallParticipantChangeEvent evt); + + /** + * Indicates that a change has occurred in the image of the source + * CallParticipant. + * + * @param evt The CallParticipantChangeEvent instance containing + * the source event as well as its previous and its new image. + */ + public void participantImageChanged(CallParticipantChangeEvent evt); }