net.java.sip.communicator.service.protocol
Interface OperationSetTelephonyConferencing

All Superinterfaces:

OperationSet

All Known Implementing Classes:

AbstractOperationSetTelephonyConferencing, OperationSetTelephonyConferencingGibberishImpl, OperationSetTelephonyConferencingJabberImpl, OperationSetTelephonyConferencingSipImpl

public interface OperationSetTelephonyConferencing
extends OperationSet

Provides operations necessary to create and handle conferencing calls.

Author:

Emil Ivov, Lubomir Marinov

Method Summary

Call	createConfCall(String[] callees) Creates a conference call with the specified callees as call peers.
Call	createConfCall(String[] callees, CallGroup group) Creates a conference call with the specified callees as call peers.
CallPeer	inviteCalleeToCall(String uri, Call call) Invites the callee represented by the specified uri to an already existing call.

Method Detail

createConfCall

Call createConfCall(String[] callees)
                    throws OperationFailedException,
                           OperationNotSupportedException

Creates a conference call with the specified callees as call peers.

Parameters:

callees - the list of addresses that we should call

Returns:

the newly created conference call containing all CallPeers

Throws:

OperationFailedException - if establishing the conference call fails

OperationNotSupportedException - if the provider does not have any conferencing features.

createConfCall

Call createConfCall(String[] callees,
                    CallGroup group)
                    throws OperationFailedException,
                           OperationNotSupportedException

Creates a conference call with the specified callees as call peers.

Parameters:

callees - the list of addresses that we should call

group - the CallGroup or null

Returns:

the newly created conference call containing all CallPeers

Throws:

OperationFailedException - if establishing the conference call fails

OperationNotSupportedException - if the provider does not have any conferencing features.

inviteCalleeToCall

CallPeer inviteCalleeToCall(String uri,
                            Call call)
                            throws OperationFailedException,
                                   OperationNotSupportedException

Invites the callee represented by the specified uri to an already existing call. The difference between this method and createConfCall is that inviteCalleeToCall allows a user to transform an existing 1 to 1 call into a conference call, or add new peers to an already established conference.

Parameters:

uri - the callee to invite to an existing conf call.

call - the call that we should invite the callee to.

Returns:

the CallPeer object corresponding to the callee represented by the specified uri.

Throws:

OperationFailedException - if inviting the specified callee to the specified call fails

OperationNotSupportedException - if allowing additional callees to a pre-established call is not supported.