java.telephony.callcontrol.callcontrolcall.html

JTAPI_html 用于JTAPI的HTML文档.

    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The TerminalConnection object
provided is not associated with this Call object.
    <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.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="getConferenceController()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getConferenceController"><b>getConferenceController</b></a>
<pre>
  public abstract <a href="java.telephony.callcontrol.CallControlTerminalConnection.html#_top_">CallControlTerminalConnection</a> getConferenceController() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Gets 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>
When a Call is initially created, the conference controller is set
to null. This method returns non-null only if the application has
previously successfully invoked the setConferenceController() method.
If a TerminalConnection, which is currently the conference controller, 
moves into the DROPPED state in the Call, the conference controller is
then set to null once again.
<p>
This method requires that the Provider is IN_SERVICE and the call is
either IDLE or ACTIVE. The pre-conditions are listed below.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE or call.getState() == ACTIVE
</OL>
<p>
The post conditions for this method ensure that the returned
TerminalConnection, if not null, is in the call and not in the DROPPED
state as given below, where 'termconn' is the TerminalConnection returned
from this method:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE or call.getState() == ACTIVE
<LI>if termconn != null, then termconn is an element of
(call.getConnections()).getTerminalConnections()
<LI>if termconn != null, then termconn.getState() != DROPPED
</OL>
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The current TerminalConnection acting as the conference
controller, null if one is not set.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="setTransferController(java.telephony.TerminalConnection)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTransferController"><b>setTransferController</b></a>
<pre>
  public abstract void setTransferController(<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 "transfer
controller." The transfer controller is a TerminalConnection on a
telephone Call object whose Terminal is also part of another telephone
call. When performing a transfer of telephone Call objects, this
TerminalConnection and the Terminal's TerminalConnection which is part
of the second call are dropped.
<p>
The Call must be in the ACTIVE state in order for this method not to
throw an exception. The TerminalConnection supplied as the terminal
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 transfer 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.getTransferController()
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> termconn - The TerminalConnection to use as the transfer controller
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The TerminalConnection object
provided is not associated with this Call object.
    <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.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="getTransferController()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTransferController"><b>getTransferController</b></a>
<pre>
  public abstract <a href="java.telephony.callcontrol.CallControlTerminalConnection.html#_top_">CallControlTerminalConnection</a> getTransferController() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Gets the TerminalConnection which is current acting as the "transfer
controller." The transfer controller is a TerminalConnection on a
telephone Call object whose Terminal is also part of another telephone
call. When performing a transfer of two telephone Call objects, this
TerminalConnection and the Terminal's TerminalConnection which is part
of the second call are dropped in the merged call.
<p>
When a Call is initially created, the transfer controller is set
to null. This method returns non-null only if the application has
previously successfully invoked the setTransferController() method.
If a TerminalConnection, which is currently the transfer controller, 
moves into the DROPPED state in the Call, the transfer controller is
then set to null once again.
<p>
This method requires that the Provider is IN_SERVICE and the call is
either IDLE or ACTIVE. The pre-conditions are listed below.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE or call.getState() == ACTIVE
</OL>
<p>
The post conditions for this method ensure that the returned
TerminalConnection, if not null, is in the call and not in the DROPPED
state as given below, where 'termconn' is the TerminalConnection returned
from this method:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE or call.getState() == ACTIVE
<LI>if termconn != null, then termconn is an element of
(call.getConnections()).getTerminalConnections()
<LI>if termconn != null, then termconn.getState() != DROPPED
</OL>
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The current TerminalConnection acting as the transfer
controller, null if one is not set.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="setConferenceEnable(boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setConferenceEnable"><b>setConferenceEnable</b></a>
<pre>
  public abstract void setConferenceEnable(boolean enable) 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.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Controls whether this Call object is permitted or able to perform
the conferencing feature. If the 'enable' argument is true, this
method attempts to turn on the conferencing ability. If 'false' this
method turns disallows the conferencing feature. If the implementation
is unable to support conferencing, a setConferenceEnable(true) will
throw an exception.
<p>
This method must be called when the Call object is first create and
in the IDLE state. The provider must also be in service. The pre-
conditions are as follows:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE
</OL>
<p>
The post-conditions are as follows, given an exception is not thrown
and the variable 'enable' represents the value of the parameter passed
to this method.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE
<LI>enable = call.getConferenceEnable();
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> enable - True turns conferencing on, false turns conferencing off.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The Connection object provided is
not associated with this Address object.
    <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.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getConferenceEnable()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getConferenceEnable"><b>getConferenceEnable</b></a>
<pre>
  public abstract boolean getConferenceEnable() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Return true if conferencing is enabled, false otherwise. Applications
may use this method initially to obtain the default value set by the
implementation and may attempt to change this value using the
CallControlCall.setConferenceEnable() method.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> True if conferencing is enabled, false otherwise.