|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ThirdPartyCall
This interface provides the ability to setup, end and determine the status of a call.
Method Summary | |
---|---|
void |
cancelCallRequest(java.lang.String callIdentifier)
The invocation of cancelCall cancels the previously requested call identified by callIdentifier. |
void |
endCall(java.lang.String callIdentifier)
The invocation of endCall terminates the call identified by callIdentifier. |
CallInformation |
getCallInformation(java.lang.String callIdentifier)
The invocation of getCallInformation retrieves the current status, callInformation, of the call identified by CallIdentifier. |
java.lang.String |
makeCall(java.net.URI callingParty,
java.net.URI calledParty,
ChargingInformation charging)
The invocation of makeCall requests to set-up a voice call between two addresses, callingParty and calledParty, provided that the invoking application is allowed to connect them. |
Method Detail |
---|
java.lang.String makeCall(java.net.URI callingParty, java.net.URI calledParty, ChargingInformation charging) throws java.rmi.RemoteException, PolicyException, ServiceException
The invocation of makeCall requests to set-up a voice call between two addresses, callingParty and calledParty, provided that the invoking application is allowed to connect them. Optionally the application can also indicate the charging information (charging).
By invoking this operation the application may monitor the status of the requested call. The returned parameter, callIdentifier, can be used to identify the call. In order to receive the information on call status the application has to explicitly invoke getCallInformation.
ServiceException from ES 202 391-1 [2]:
* SVC0001 - Service error.
* SVC0002 - Invalid input value.
PolicyException from ES 202 391-1 [2]:
* POL0001 - Policy error.
* POL0008 - Charging not supported.
callingParty
- xsd:anyURI
It contains the address of the first user involved in the callcalledParty
- xsd:anyURI
It contains the address of the second user involved in the callcharging
- common:ChargingInformation
Charge to apply to the call
java.rmi.RemoteException
PolicyException
ServiceException
CallInformation getCallInformation(java.lang.String callIdentifier) throws java.rmi.RemoteException, PolicyException, ServiceException
The invocation of getCallInformation retrieves the current status, callInformation, of the call identified by CallIdentifier. This method can be invoked multiple times by the application even if the call has already ended. However, after the call has ended, status information will be available only for a limited period of time that is specified in the service policy 'StatusRetentionTime'.
ServiceException from ES 202 391-1 [2]:
* SVC0001 - Service error.
* SVC0002 - Invalid input value.
PolicyException from ES 202 391-1 [2]:
* POL0001 - Policy error.
callIdentifier
- xsd:string
It identifies a specific call request
java.rmi.RemoteException
PolicyException
ServiceException
void endCall(java.lang.String callIdentifier) throws java.rmi.RemoteException, PolicyException, ServiceException
The invocation of endCall terminates the call identified by callIdentifier. If the call is still in the initial state this method has the same effect as the cancelCall operation.
ServiceException from ES 202 391-1 [2]:
* SVC0001 - Service error.
* SVC0002 - Invalid input value.
* SVC0261 - Call already terminated.
PolicyException from ES 202 391-1 [2]:
* POL0001 - Policy error.
callIdentifier
- xsd:string
It identifies a specific call request
java.rmi.RemoteException
PolicyException
ServiceException
void cancelCallRequest(java.lang.String callIdentifier) throws java.rmi.RemoteException, PolicyException, ServiceException
The invocation of cancelCall cancels the previously requested call identified by callIdentifier. Note that this method differs from the endCall operation since it only attempts to prevent the call from starting but it does not have any effect if the call has already started.
ServiceException from ES 202 391-1 [2]:
* SVC0001 - Service error.
* SVC0002 - Invalid input value.
* SVC0260 - Call already connected.
PolicyException from ES 202 391-1 [2]:
* POL0001 - Policy error.
callIdentifier
- xsd:string
It identifies a specific call request
java.rmi.RemoteException
PolicyException
ServiceException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |