📄 java.telephony.media.mediaterminalconnection.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Interface java.telephony.media.MediaTerminalConnection</title></head><body><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.media.html">This Package</a> <a href="java.telephony.media.MediaCallObserver.html#_top_">Previous</a> <a href="Package-java.telephony.media.html">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Interface java.telephony.media.MediaTerminalConnection</h1><dl> <dt> public interface <b>MediaTerminalConnection</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a> <dt> extends <a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a></dl>The MediaTerminalConnection interface extends the TerminalConnectioninterface to add media capabilities. Media streams are associated withthe TerminalConnection object in the call model. Therefore, differentTerminals which are part of the same call at the same Address may havetheir own media streams. Additionality, Terminals which are part of morethan one call have separate media streams for each of its calls.<p>The media interface consists of a base media API which supports all ofthe various types of media-based telephony applications. A simplier,voice-based API exist for applications which desire only the mostsimply voice-based media features. The base media API is still underdevelopment. This specification only represent the voice API.<p>The voice API supports the following applications: routing voice datato/from the telephone line to/from a workstation's speaker of microphone;routing voice data to/from the telephone line to/from audio files; startingand stoping of playing and recording; and DTMF tone detection.<p>In this specification, "playing" is defined as sending information to the telephone line. For example, an application would "play" an audio file tothe telephone line for the opposite parties to hear. The term "recording"is defines as receiving information from the telephone line. For example,an application may "record" data from the telephone line into a file ondisk.<p>For playing, applications may either route data from a URL with theusePlayURL() method or from the workstatation's default microphone using theuseDefaultMicrophone() method. Note that if there is more than onemicrophone on the workstation, then the default microphone may be set usingthe java.telephony.phone package. Applications begin playing using thestartPlaying() method and stop playing using the stopPlaying() method.If an application issues a startPlaying() after a stopPlaying(), theimplementation attempts to read from the media where it last left off,if possible. If the application wishes to "rewind" the media to thebeginning, it should re-issue the usePlayURL() method.<p>For recording, applications may either route data to a URL with theuseRecordURL() method or to the workstation's default speaker using theuseDefaultSpeaker() method. Note that if there is more than one speaker onthe workstation, then the default speaker may be set using thejava.telephony.phone package. Applications begin recording using thestartRecording() method and stop recording using the stopRecording() method.If an application issues a startRecording() after a stopRecording(), theimplementation attempts to write to the media where it last left off, ifpossible. If the application wishes to "overwrite" the media from thebeginning, it should re-issue the useRecordURL() method.<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="#AVAILABLE"><b>AVAILABLE</b></a> <dd> Media is currently available on this terminal connection <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#PLAYING"><b>PLAYING</b></a> <dd> There is currently playing on this terminal connection <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#RECORDING"><b>RECORDING</b></a> <dd> There is currently recording on this terminal connection <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o "> <a href="#UNAVAILABLE"><b>UNAVAILABLE</b></a> <dd> Media is currently not available on this terminal connection</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="#generateDtmf(java.lang.String)"><b>generateDtmf</b></a>(String) <dd> <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getMediaAvailability()"><b>getMediaAvailability</b></a>() <dd> Returns the current media availability state, either AVAILABLE orUNAVAILABLE. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getMediaState()"><b>getMediaState</b></a>() <dd> Returns the current state of the terminal connection as a bit maskof PLAYING and RECORDING. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#setDtmfDetection(boolean)"><b>setDtmfDetection</b></a>(boolean) <dd> <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#startPlaying()"><b>startPlaying</b></a>() <dd> Start the playing. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#startRecording()"><b>startRecording</b></a>() <dd> Start the recording. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#stopPlaying()"><b>stopPlaying</b></a>() <dd> Stop the playing. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#stopRecording()"><b>stopRecording</b></a>() <dd> Stop the recording. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#useDefaultMicrophone()"><b>useDefaultMicrophone</b></a>() <dd> Instructs the terminal connection to use the default microphone forplaying to the telephone line. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#useDefaultSpeaker()"><b>useDefaultSpeaker</b></a>() <dd> Instructs the terminal connection to use the default speaker forrecording from the telephone line. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#usePlayURL(java.net.URL)"><b>usePlayURL</b></a>(URL) <dd> Instructs the terminal connection to use a file for playing tothe telephone line. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#useRecordURL(java.net.URL)"><b>useRecordURL</b></a>(URL) <dd> Instructs the terminal connection to use a file for recording fromthe telephone line.</dl><a name="variables"></a><h2> <img src="images/variables.gif" width=153 height=38 alt="Variables"></h2><a name="AVAILABLE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>AVAILABLE</b><pre> public final static int AVAILABLE</pre><dl> <dd> Media is currently available on this terminal connection</dl><a name="UNAVAILABLE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>UNAVAILABLE</b><pre> public final static int UNAVAILABLE</pre><dl> <dd> Media is currently not available on this terminal connection</dl><a name="PLAYING"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>PLAYING</b><pre> public final static int PLAYING</pre><dl> <dd> There is currently playing on this terminal connection</dl><a name="RECORDING"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a><b>RECORDING</b><pre> public final static int RECORDING</pre><dl> <dd> There is currently recording on this terminal connection</dl><a name="methods"></a><h2> <img src="images/methods.gif" width=151 height=38 alt="Methods"></h2><a name="getMediaAvailability()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getMediaAvailability"><b>getMediaAvailability</b></a><pre> public abstract int getMediaAvailability() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the current media availability state, either AVAILABLE orUNAVAILABLE.<p> <dl> <dt> <b>Returns:</b> <dd> The current availability of the media channel. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getMediaState()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -