📄 java.telephony.callcontrol.callcontrolcall.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Interface java.telephony.callcontrol.CallControlCall</title></head><body><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.callcontrol.html">This Package</a> <a href="java.telephony.callcontrol.CallControlAddressObserver.html#_top_">Previous</a> <a href="java.telephony.callcontrol.CallControlCallObserver.html#_top_">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Interface java.telephony.callcontrol.CallControlCall</h1><dl> <dt> public interface <b>CallControlCall</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a> <dt> extends <a href="java.telephony.Call.html#_top_">Call</a></dl>The CallControlCall interface extends the core Call interface. TheCallControlCall interface provides more functionality on the Call objectfor the purposes of the CallControl package.<p>Particularly, it provides the addParty() method call to conferencein an additional party, the drop() method to drop the entire Call, theconference() method to conference two calls together, the transfer()method to transfer a telephone call, and the consult() method to begina consultation telephone Call.<hr><a name="index"></a><h2> <img src="images/method-index.gif" width=207 height=38 alt="Method Index"></h2><dl> <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#addParty(java.lang.String)"><b>addParty</b></a>(String) <dd> Adds an additional party to an existing telephone Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#conference(java.telephony.Call)"><b>conference</b></a>(Call) <dd> Merges two Calls together resulting in the union of the parties involvedwith both calls belong to a single telephone call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#consult(java.telephony.TerminalConnection, java.lang.String)"><b>consult</b></a>(TerminalConnection, String) <dd> Begins a consultation Call with the existing Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#consult(java.telephony.TerminalConnection)"><b>consult</b></a>(TerminalConnection) <dd> This overloaded version of consult() is similar to the other versionof consult, except it does not take a destination string address asan argument. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#drop()"><b>drop</b></a>() <dd> Drops the entire Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getCalledAddress()"><b>getCalledAddress</b></a>() <dd> Returns the called Address associated with this Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getCallingAddress()"><b>getCallingAddress</b></a>() <dd> Returns the calling Address associated with this call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getCallingTerminal()"><b>getCallingTerminal</b></a>() <dd> Returns the calling Terminal associated with this Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getConferenceController()"><b>getConferenceController</b></a>() <dd> Gets the TerminalConnection which is current acting as the "conferencecontroller." The conference controller is a TerminalConnection on atelephone Call object whose Terminal is also part of another telephonecall. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getConferenceEnable()"><b>getConferenceEnable</b></a>() <dd> Return true if conferencing is enabled, false otherwise. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getLastRedirectedAddress()"><b>getLastRedirectedAddress</b></a>() <dd> Returns the last redirected Address associated with this Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTransferController()"><b>getTransferController</b></a>() <dd> Gets the TerminalConnection which is current acting as the "transfercontroller." The transfer controller is a TerminalConnection on atelephone Call object whose Terminal is also part of another telephonecall. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTransferEnable()"><b>getTransferEnable</b></a>() <dd> Return true if transfering is enabled, false otherwise. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#offHook(java.telephony.Address, java.telephony.Terminal)"><b>offHook</b></a>(Address, Terminal) <dd> Takes the originating end of a telephone call off-hook. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#setConferenceController(java.telephony.TerminalConnection)"><b>setConferenceController</b></a>(TerminalConnection) <dd> Sets the TerminalConnection which is current acting as the "conferencecontroller." The conference controller is a TerminalConnection on atelephone Call object whose Terminal is also part of another telephonecall. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#setConferenceEnable(boolean)"><b>setConferenceEnable</b></a>(boolean) <dd> Controls whether this Call object is permitted or able to performthe conferencing feature. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#setTransferController(java.telephony.TerminalConnection)"><b>setTransferController</b></a>(TerminalConnection) <dd> Sets the TerminalConnection which is current acting as the "transfercontroller." The transfer controller is a TerminalConnection on atelephone Call object whose Terminal is also part of another telephonecall. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#setTransferEnable(boolean)"><b>setTransferEnable</b></a>(boolean) <dd> Controls whether this Call object is permitted or able to performthe transfering feature. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#transfer(java.telephony.Call)"><b>transfer</b></a>(Call) <dd> This flavor of the transfer() method transfer all parties currentlyassociated with the Call to another telephone Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#transfer(java.lang.String)"><b>transfer</b></a>(String) <dd> This flavor of the transfer() method transfer all parties currentlyassociated with the Call to another telephony number address.</dl><a name="methods"></a><h2> <img src="images/methods.gif" width=151 height=38 alt="Methods"></h2><a name="getCallingAddress()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getCallingAddress"><b>getCallingAddress</b></a><pre> public abstract <a href="java.telephony.callcontrol.CallControlAddress.html#_top_">CallControlAddress</a> getCallingAddress() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the calling Address associated with this call. The callingAddress is defined as the Address which placed the telephone call.<p>If the calling address is unknown or not yet known, this method returnsnull.<p> <dl> <dt> <b>Returns:</b> <dd> The calling Address. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> Some platform-specific exception occured. </dl></dl><a name="getCallingTerminal()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getCallingTerminal"><b>getCallingTerminal</b></a><pre> public abstract <a href="java.telephony.callcontrol.CallControlTerminal.html#_top_">CallControlTerminal</a> getCallingTerminal() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the calling Terminal associated with this Call. The callingTerminal is defined as the Terminal which placed the telephone call.<p>If the calling Terminal is unknown or not yet know, this method returnsnull.<p> <dl> <dt> <b>Returns:</b> <dd> The calling Terminal. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> Some platform-specific exception occured. </dl></dl><a name="getCalledAddress()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getCalledAddress"><b>getCalledAddress</b></a><pre> public abstract <a href="java.telephony.callcontrol.CallControlAddress.html#_top_">CallControlAddress</a> getCalledAddress() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the called Address associated with this Call. The calledAddress is defined as the Address to which the call has been originallyplaced.<p>If the called address is unknown or not yet known, this method returnsnull.<p> <dl> <dt> <b>Returns:</b> <dd> s The called Address. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> Some platform-specific exception occured. </dl></dl><a name="getLastRedirectedAddress()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getLastRedirectedAddress"><b>getLastRedirectedAddress</b></a><pre> public abstract <a href="java.telephony.callcontrol.CallControlAddress.html#_top_">CallControlAddress</a> getLastRedirectedAddress() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the last redirected Address associated with this Call.The last redirected Address is the Address at which the current telephonecall was placed immediately before the current Address. This is commonif a Call is forwarded to several Addresses before being answered.<p>If the the last redirected address is unknown or not yet known, thismethod returns null.<p> <dl> <dt> <b>Returns:</b> <dd> s The last redirected Address for this telephone Call. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> Some platform-specific exception occured. </dl></dl><a name="addParty(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="addParty"><b>addParty</b></a><pre> public abstract <a href="java.telephony.callcontrol.CallControlConnection.html#_top_">CallControlConnection</a> addParty(<a href="java.lang.String.html#_top_">String</a> newParty) throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.InvalidPartyException.html#_top_">InvalidPartyException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Adds an additional party to an existing telephone Call. This is sometimescalled a "single-step conference" because a party is conferenced into atelephone call directly. The telephony address provided must becomplete and valid.<p>The Call must be ACTIVE before this method is valid. This Call must alsohave at least two Connections in the CONNECTED state. An additionrestriction requires that at most one other Connection may be in eitherthe INPROGRESS state or ALERTING state. The Provider must also beIN_SERVICE. The pre-conditions for this method are given by the following:<p><OL><LI>(call.getProvider()).getState() == IN_SERVICE<LI>call.getState() == ACTIVE<LI>c = call.getConnections() && c.length >= 2<LI>c = call.getConnections() && two connections.getState() == CONNECTED<LI>there exists at most one c = call.getConnections() such that c.getState() equals ALERTING or INPROGRESS.</OL><p>This method creates a new Connection and associates it with the Call andthe Address object associated with the new party. This Connection isin the IDLE state and is the return value for this method. Thepost-conditions which are true when this method returns are as follows,where 'c' is the returned connection.<p><OL><LI>(call.getProvider()).getState() == IN_SERVICE<LI>call.getState() == ACTIVE<LI>c.getState() == IDLE</OL><p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -