java.telephony.callcontrol.callcontrolcall.html

JTAPI_html 用于JTAPI的HTML文档.

    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="transfer(java.telephony.Call)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="transfer"><b>transfer</b></a>
<pre>
  public abstract void transfer(<a href="java.telephony.Call.html#_top_">Call</a> otherCall) throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</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> This flavor of the transfer() method transfer all parties currently
associated with the Call to another telephone Call. Here, all parties
associated with the Call provided as the argument are moved to this
Call object.
<p>
There must be a Terminal which is part of both calls on the same Address.
This Terminal has a TerminalConnection to each of the telephone calls. If
more than one such Terminal exists, the implementation choose are suitable
one. If no such Terminal exists, this method throws an exception. Let
us call the TerminalConnection associated with this call 'termconn' and
the TerminalConnection associated with otherCall, 'scndtermconn'. 
<p>
These two TerminalConnections (and the Terminal) drop off of the Call
once the transfer takes place. The fact that this Terminal drops from the
call is a distinguishing feature between this transfer() method and
conference(). The TerminalConnections must either be in the TALKING or
HELD state (these are CallControlTerminalConnection states). The Provider
must be IN_SERVICE. These pre-conditions are listed below:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>otherCall.getState() == ACTIVE
<LI>termconn element of (call.getConnections()).getTerminalConnections()
<LI>termconn.getState() == TALKING or HELD
<LI>scndtermconn element of
(otherCall.getConnections()).getTerminalConnections()
<LI>scndtermconn.getState() == TALKING or HELD
</OL>
<p>
This method moves the termconn and scndtermconn into the DROPPED state,
and if it is the only TerminalConnection on the Connection, the
Connection moves to the DISCONNECTED state. The sncdtermconn object
also moves into the TerminalConnection state and does not get moved to
this Call object. All other Connections and TerminalConnections which are
part of otherCall are moved to this Call object in the same state as
they were in otherCall. New Connection objects are created, and the old
Connection and TerminalConnection objects on otherCall move to
DISCONNECTED and DROPPED, respectively. The otherCall object becomes
INVALID. The post-conditions of this method are as follows:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn.getState() == DROPPED
<LI>(termconn.getConnection()).getTerminalConnections is of length 1, then
(termconn.getConnection()).getState() == DISCONNECTED
<LI>scndtermconn.getState() == DROPPED
<LI>For all connections in otherCall.getConnections(),call.getConnections()
has an element in the same state and the same Address reference.
<LI>For all terminalconnection in 
(otherCall.getConnections()).getTerminalConnections(), this call object
has the same number of TerminalConnections minus scndtermconn in the
same state and associated with the same Connection and Terminal.
<LI>For all connections in otherCall.getConnections(),
connections.getState() == DISCONNECTED
<LI>For all terminalconnections in connections.getTerminalConnections(),
terminalconnections.getState() == DROPPED
<LI>otherCall.getState() == INVALID
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> otherCall - The other Call which to transfer to this Call.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The TerminalConnection
controlling the transfer is not valid or does not exists or the other
telephone call is not valid.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-specific exception occurred.
<p>
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="transfer(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="transfer"><b>transfer</b></a>
<pre>
  public abstract <a href="java.telephony.callcontrol.CallControlConnection.html#_top_">CallControlConnection</a> transfer(<a href="java.lang.String.html#_top_">String</a> address) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <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> This flavor of the transfer() method transfer all parties currently
associated with the Call to another telephony number address. Typically,
the participants of call will hear the new address alerting. The telephone
address provided must be valid and complete.
<p>
The transfer() method is associated with some TerminalConnection which
is part of the current telephony Call. This TerminalConnection specifies
from which Terminal is transfer is being invoked. This Terminal and
TerminalConnection drop off from the call once transferred. This special
TerminalConnection is called the "transfer controller" and is optionally
set by the setTransferController() method. If applications do not select
a transfer controller, then the implementations will select a suitable
one. For the purposes of this method, this transfer controller
TerminalConnection will be denoted as 'termconn'.
<p>
The transfer controller must be in the ACTIVE state and be part of this
telephone call. The Provider must also be IN_SERVICE. The pre-conditions
for this method are:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn element of (call.getConnections()).getTerminalConnections()
<LI>termconn.getState() == ACTIVE
</OL>
<p>
This method moves the termconn into the DROPPED state, and if it is
the only TerminalConnection on the Connection, the Connection moves to
the DISCONNECTED state. The transfer() method then creates a new
Connection in the IDLE state to an Address object corresponding to
the string telephone number address provided. The transfer() method
returns this new Connection. The post-conditions of this method are
as follows, given the returned Connection is denoted by 'connection':
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn.getState() == DROPPED
<LI>(termconn.getConnection()).getTerminalConnections is of length 1, then
(termconn.getConnection()).getState() == DISCONNECTED
<LI>if connection != null, connection is an element of call.getConnections()
<LI>if connection != null, then connection.getState() == IDLE
</OL>
<p>
An application can expect the new connection to transition through the
Connection states similiar to a destination Connection does after a
Call.connect() is invoked.
<p>
Note that the new Connection created and returned may be null. This
Connection will be null in the case that the Call has transferred out of
the Provider's domain.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> address - The destination address where the Call is being
transferred.
    <dt> <b>Returns:</b>
    <dd> The new Connection associated with the destination or null.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The TerminalConnection provided as
controlling the transfer is not valid or part of this telephone Call.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidPartyException.html#_top_">InvalidPartyException</a>
    <dd> The new party to transfer to is invalid.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="setConferenceController(java.telephony.TerminalConnection)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setConferenceController"><b>setConferenceController</b></a>
<pre>
  public abstract void setConferenceController(<a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> termconn) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Sets the TerminalConnection which is current acting as the "conference
controller." The conference controller is a TerminalConnection on a
telephone Call object whose Terminal is also part of another telephone
call. When performing a conference of two telephone Call objects, this
TerminalConnection and the Terminal's TerminalConnection which is part
of the second call are merged into one in the merged Call object.
<p>
The Call must be in the ACTIVE state in order for this method not to
throw an exception. The TerminalConnection supplied as the conference
controller must be in the Call and must not be in the DROPPED state. The
Provider must also be IN_SERVICE. These pre-conditions are given below.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn union (call.getConnections()).getTerminalConnections() ==
termconn
<LI>termconn.getState() != DROPPED
</OL>
<p>
If these pre-conditions are met, this method sets the given
TerminalConnection as the conference controller, where the following
post-conditions are met:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn union (call.getConnections()).getTerminalConnections() ==
termconn
<LI>termconn.getState() != DROPPED
<LI>termconn == call.getConferenceController()
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> termconn - The TerminalConnection to use as the conference controller