agioperations.html

关于asterisk的java包

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the extension for continuation upon exiting the application.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#setPriority(java.lang.String)">setPriority</A></B>(java.lang.String&nbsp;priority)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the priority or label for continuation upon exiting the application.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#setVariable(java.lang.String, java.lang.String)">setVariable</A></B>(java.lang.String&nbsp;name,
            java.lang.String&nbsp;value)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the value of the given channel variable to a new value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#stopMusicOnHold()">stopMusicOnHold</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stops playing music on hold.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#streamFile(java.lang.String)">streamFile</A></B>(java.lang.String&nbsp;file)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Plays the given file.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;char</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#streamFile(java.lang.String, java.lang.String)">streamFile</A></B>(java.lang.String&nbsp;file,
           java.lang.String&nbsp;escapeDigits)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Plays the given file and allows the user to escape by pressing one of the
 given digit.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#verbose(java.lang.String, int)">verbose</A></B>(java.lang.String&nbsp;message,
        int&nbsp;level)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sends a message to the Asterisk console via the verbose message system.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;char</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/asteriskjava/fastagi/AgiOperations.html#waitForDigit(int)">waitForDigit</A></B>(int&nbsp;timeout)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Waits up to 'timeout' milliseconds to receive a DTMF digit.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="AgiOperations()"><!-- --></A><H3>
AgiOperations</H3>
<PRE>
public <B>AgiOperations</B>()</PRE>
<DL>
<DD>Creates a new instance that operates on the channel attached to the
 current thread.
<P>
</DL>
<HR>

<A NAME="AgiOperations(org.asteriskjava.fastagi.AgiChannel)"><!-- --></A><H3>
AgiOperations</H3>
<PRE>
public <B>AgiOperations</B>(<A HREF="../../../org/asteriskjava/fastagi/AgiChannel.html" title="interface in org.asteriskjava.fastagi">AgiChannel</A>&nbsp;channel)</PRE>
<DL>
<DD>Creates a new instance that operates on the given channel.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>channel</CODE> - the channel to operate on.</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="answer()"><!-- --></A><H3>
answer</H3>
<PRE>
public void <B>answer</B>()
            throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Answers the channel.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="hangup()"><!-- --></A><H3>
hangup</H3>
<PRE>
public void <B>hangup</B>()
            throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Hangs the channel up.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="setAutoHangup(int)"><!-- --></A><H3>
setAutoHangup</H3>
<PRE>
public void <B>setAutoHangup</B>(int&nbsp;time)
                   throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Cause the channel to automatically hangup at the given number of seconds
 in the future.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>time</CODE> - the number of seconds before this channel is automatically
            hung up.
            <p>
            0 disables the autohangup feature.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="setCallerId(java.lang.String)"><!-- --></A><H3>
setCallerId</H3>
<PRE>
public void <B>setCallerId</B>(java.lang.String&nbsp;callerId)
                 throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Sets the caller id on the current channel.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>callerId</CODE> - the raw caller id to set, for example "John Doe<1234>".
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="playMusicOnHold()"><!-- --></A><H3>
playMusicOnHold</H3>
<PRE>
public void <B>playMusicOnHold</B>()
                     throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Plays music on hold from the default music on hold class.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="playMusicOnHold(java.lang.String)"><!-- --></A><H3>
playMusicOnHold</H3>
<PRE>
public void <B>playMusicOnHold</B>(java.lang.String&nbsp;musicOnHoldClass)
                     throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Plays music on hold from the given music on hold class.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>musicOnHoldClass</CODE> - the music on hold class to play music from as
            configures in Asterisk's <code><musiconhold.conf</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="stopMusicOnHold()"><!-- --></A><H3>
stopMusicOnHold</H3>
<PRE>
public void <B>stopMusicOnHold</B>()
                     throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Stops playing music on hold.
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getChannelStatus()"><!-- --></A><H3>
getChannelStatus</H3>
<PRE>
public int <B>getChannelStatus</B>()
                     throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Returns the status of the channel.
 <p>
 Return values:
 <ul>
 <li>0 Channel is down and available
 <li>1 Channel is down, but reserved
 <li>2 Channel is off hook
 <li>3 Digits (or equivalent) have been dialed
 <li>4 Line is ringing
 <li>5 Remote end is ringing
 <li>6 Line is up
 <li>7 Line is busy
 </ul>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the status of the channel.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getData(java.lang.String)"><!-- --></A><H3>
getData</H3>
<PRE>
public java.lang.String <B>getData</B>(java.lang.String&nbsp;file)
                         throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Plays the given file and waits for the user to enter DTMF digits until he
 presses '#'. The user may interrupt the streaming by starting to enter
 digits.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the name of the file to play
<DT><B>Returns:</B><DD>a String containing the DTMF the user entered
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getData(java.lang.String, int)"><!-- --></A><H3>
getData</H3>
<PRE>
public java.lang.String <B>getData</B>(java.lang.String&nbsp;file,
                                int&nbsp;timeout)
                         throws <A HREF="../../../org/asteriskjava/fastagi/AgiException.html" title="class in org.asteriskjava.fastagi">AgiException</A></PRE>
<DL>
<DD>Plays the given file and waits for the user to enter DTMF digits until he
 presses '#' or the timeout occurs. The user may interrupt the streaming