net.java.sip.communicator.service.protocol
Interface OperationSetAdvancedTelephony<T extends ProtocolProviderService>

Type Parameters:

T - the implementation specific provider class like for example ProtocolProviderServiceSipImpl.

All Superinterfaces:

OperationSet, OperationSetBasicTelephony<T>

All Known Implementing Classes:

OperationSetBasicTelephonyJabberImpl, OperationSetBasicTelephonySipImpl

public interface OperationSetAdvancedTelephony<T extends ProtocolProviderService>
extends OperationSetBasicTelephony<T>

Extends OperationSetBasicTelephony with advanced telephony operations such as call transfer.

Author:

Lyubomir Marinov

Field Summary

Fields inherited from interface net.java.sip.communicator.service.protocol.OperationSetBasicTelephony

HANGUP_REASON_ENCRYPTION_REQUIRED, HANGUP_REASON_NORMAL_CLEARING, HANGUP_REASON_TIMEOUT, MAX_MEDIA_PORT_NUMBER_PROPERTY_NAME, MIN_MEDIA_PORT_NUMBER_PROPERTY_NAME

Method Summary

void	setTransferAuthority(TransferAuthority authority) Transfer authority used for interacting with user for unknown call transfer requests.
void	transfer(CallPeer peer, CallPeer target) Transfers (in the sense of call transfer) a specific CallPeer to a specific callee address which already participates in an active Call.
void	transfer(CallPeer peer, String target) Transfers (in the sense of call transfer) a specific CallPeer to a specific callee address which may or may not already be participating in an active Call.

Methods inherited from interface net.java.sip.communicator.service.protocol.OperationSetBasicTelephony

addCallListener, answerCallPeer, createCall, createCall, createCall, createCall, createRecorder, getActiveCalls, getProtocolProvider, hangupCallPeer, hangupCallPeer, putOffHold, putOnHold, removeCallListener, setMute

Method Detail

transfer

void transfer(CallPeer peer,
              CallPeer target)
              throws OperationFailedException

Transfers (in the sense of call transfer) a specific CallPeer to a specific callee address which already participates in an active Call.

The method is suitable for providing the implementation of attended call transfer (though no such requirement is imposed).

Parameters:

peer - the CallPeer to be transfered to the specified callee address

target - the address in the form of CallPeer of the callee to transfer peer to

Throws:

OperationFailedException - if something goes wrong.

transfer

void transfer(CallPeer peer,
              String target)
              throws OperationFailedException

Transfers (in the sense of call transfer) a specific CallPeer to a specific callee address which may or may not already be participating in an active Call.

The method is suitable for providing the implementation of unattended call transfer (though no such requirement is imposed).

Parameters:

peer - the CallPeer to be transfered to the specified callee address

target - the address of the callee to transfer peer to

Throws:

OperationFailedException - if something goes wrong.

setTransferAuthority

void setTransferAuthority(TransferAuthority authority)

Transfer authority used for interacting with user for unknown call transfer requests.

Parameters:

authority - transfer authority asks user for accepting a particular transfer request.