📄 java.telephony.terminalconnection.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Interface java.telephony.TerminalConnection</title></head><body><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.html">This Package</a> <a href="java.telephony.Terminal.html#_top_">Previous</a> <a href="java.telephony.TerminalObserver.html#_top_">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Interface java.telephony.TerminalConnection</h1><dl> <dt> public interface <b>TerminalConnection</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a></dl>The TerminalConnection interface describes the relationship between aCall and a Terminal. A TerminalConnection object must always be associatedwith some Connection object. A TerminalConnection object cannot existwithout being part of a Connection object. The TerminalConnection objecthas a state. Similar to the Connection state, the TerminalConnection statedescribes the relationship between the Terminal and the Call.TerminalConnections are the means by which the call model describesexactly which Terminals are part of the Call. In order for aTerminalConnection to be associated with a Terminal, the Terminal must haveas one of its Address objects the Address object pointed to by theConnection object.<p>There are six states on the TerminalConnection object: IDLE, RINGING,PASSIVE, ACTIVE, DROPPED, and UNKNOWN.<p>The IDLE state is the initial state for all TerminalConnections. TerminalConnections do not stay in this state for long. They typically transitioninto another state quickly.<p>The RINGING state indicates the a Terminal is ringing, indicating that theTerminal has an incoming Call.<p>The PASSIVE state indicates that a Terminal is part of a telephone callbut not in an active fashion. This may imply that a resource of the Terminalis being used and may limit actions on the Terminal.<p>The ACTIVE state indicates that a Terminal is actively part of a telephonecall. This usually implies that the party speaking on that Terminal is partyof the telephone call.<p>The DROPPED state indicates that a particular Terminal has permanently leftthe telephone call.<p>The UNKNOWN state indiciates that the implementation is unable to determinethe state of the TerminalConnection. TerminalConnections may transitioninto and out of the UNKNOWN state at any time.<p>These states are partially described by the allowable transitions from oneto another. The following chart describes these allowable transitions.Each state on the left many transition into the listed states on the right.<p><UL><LI>IDLE ---> PASSIVE, RINGING, ACTIVE, DROPPED, UNKNOWN<LI>PASSIVE ---> ACTIVE, DROPPED, UNKNOWN<LI>RINGING ---> DROPPED, PASSIVE, ACTIVE, UNKNOWN<LI>ACTIVE ---> PASSIVE, DROPPED, UNKNOWN<LI>DROPPED ---> no state transition allowed.<LI>UNKNOWN ---> IDLE, PASSIVE, RINGING, ACTIVE, DROPPED</UL><p>These TerminalConnection states also depend upon the Connection states. Inthe description of the <EM>Call.connect()</EM> method theseTerminalConnections are created and transition states during certainstages outlined in the <EM>Call.connect()</EM> method. Below is a chartwhich relates Connection states w.r.t allowable TerminalConnection states.In other words, if a Connection is in a certain state, allTerminalConnection objects associated with it must be in certain states asdefined below. The states on the left represent Connection states and thestates on the right represent TerminalConnection states.<p><UL><LI>IDLE ---> no connection states may exist<LI>CONNECTED ---> PASSIVE | ACTIVE | DROPPED <LI>INPROGRESS ---> no connection states may exist<LI>ALERTING ---> RINGING<LI>DISCONNECTED ---> DROPPED<LI>FAILED ---> DROPPED<LI>UNKNOWN ---> UNKNOWN</UL><p>A TerminalConnection may answer incoming telephone calls with the<EM>answer()</EM> method. It may answer telephony calls only if theTerminalConnection is in the TerminalConnection.RINGING state. This is moreformally described by the pre-conditions of the <EM>answer()</EM> method.<p><dl> <dt> <b>See Also:</b> <dd> <a href="java.telephony.CallObserver.html#_top_">CallObserver</a>, <a href="java.telephony.TerminalObserver..html#_top_"></a></dl><hr><a name="index"></a><h2> <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index"></h2><dl> <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#ACTIVE"><b>ACTIVE</b></a> <dd> The ACTIVE state indicates that a Terminal is actively part of atelephone call. <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#DROPPED"><b>DROPPED</b></a> <dd> The DROPPED state indicates that a particular Terminal has permanentlyleft the telephone call. <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#IDLE"><b>IDLE</b></a> <dd> The IDLE state is the initial state for all TerminalConnection objects. <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#PASSIVE"><b>PASSIVE</b></a> <dd> The PASSIVE state indicates that a Terminal is part of a telephone callbut not in an active fashion. <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#RINGING"><b>RINGING</b></a> <dd> The RINGING state indicates the a Terminal is ringing, indicating that theTerminal has an incoming Call. <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#UNKNOWN"><b>UNKNOWN</b></a> <dd> The UNKNOWN state indicates that the implementation is unable to determinethe state of the TerminalConnection.</dl><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="#answer()"><b>answer</b></a>() <dd> Answers a telephone call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getConnection()"><b>getConnection</b></a>() <dd> Returns the Connection object associated with this TerminalConnection. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getState()"><b>getState</b></a>() <dd> Returns the state of the TerminalConnection object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTerminal()"><b>getTerminal</b></a>() <dd> Returns the Terminal associated with this TerminalConnection object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTerminalConnectionCapabilities(java.telephony.Terminal, java.telephony.Address)"><b>getTerminalConnectionCapabilities</b></a>(Terminal, Address) <dd> Gets the TerminalConnectionCapabilities object with respect to a Terminal and anAddress.</dl><a name="variables"></a><h2> <img src="images/variables.gif" width=153 height=38 alt="Variables"></h2><a name="IDLE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>IDLE</b><pre> public final static int IDLE</pre><dl> <dd> The IDLE state is the initial state for all TerminalConnection objects.</dl><a name="RINGING"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>RINGING</b><pre> public final static int RINGING</pre><dl> <dd> The RINGING state indicates the a Terminal is ringing, indicating that theTerminal has an incoming Call.</dl><a name="PASSIVE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>PASSIVE</b><pre> public final static int PASSIVE</pre><dl> <dd> The PASSIVE state indicates that a Terminal is part of a telephone callbut not in an active fashion. This may imply that a resource of theTerminal is being used and may limit actions on the Terminal.</dl>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -