<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>MeetMe()</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><link rel="start" href="index.html" title="Asterisk™: The Future of Telephony" /><link rel="up" href="asterisk-APP-B.html" title="Appendix B. Application Reference" /><link rel="prev" href="asterisk-APP-B-106.html" title="MailboxExists()" /><link rel="next" href="asterisk-APP-B-111.html" title="MeetMeAdmin()" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">MeetMe()</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="asterisk-APP-B-106.html">Prev</a> </td><th width="60%" align="center">Appendix B. Application Reference</th><td width="20%" align="right"> <a accesskey="n" href="asterisk-APP-B-111.html">Next</a></td></tr></table><hr /></div><div class="refentry" lang="en" xml:lang="en"><a id="asterisk-APP-B-109"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>MeetMe() — Puts the caller in to a MeetMe conference
bridge</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><a id="I_programlisting_tt2278"></a><pre class="programlisting">MeetMe([<em class="replaceable"><code>confno</code></em>[,<em class="replaceable"><code>options</code></em>[,<em class="replaceable"><code>PIN</code></em>]]])</pre></div><div class="refsect1" lang="en" xml:lang="en"><a id="id4188307"></a><h2></h2><p><a id="I_indexterm_tt2279" class="indexterm"></a>Places the caller in to the audio conference bridge
specified by the <em class="replaceable"><code>confno</code></em> argument. If the
conference number is omitted, the user will be prompted to enter
one.</p><p>If the <em class="replaceable"><code>PIN</code></em> argument is passed, the
caller must enter that PIN number to successfully enter the
conference.</p><p>The <em class="replaceable"><code>options</code></em> string may contain zero or
more of the characters in the following list:</p><div class="variablelist"><dl><dt><span class="term">
<code class="literal">a</code>
</span></dt><dd><p>Sets admin mode.</p></dd><dt><span class="term">
<code class="literal">A</code>
</span></dt><dd><p>Sets marked mode.</p></dd><dt><span class="term">
<code class="literal">b</code>
</span></dt><dd><p>Runs the AGI script specified in <code class="literal">${MEETME_AGI_BACKGROUND}</code>; default:
<span class="emphasis"><em>conf-background.agi</em></span>. (Note: this does not
work with non-Zap channels in the same conference.)</p></dd><dt><span class="term">
<code class="literal">c</code>
</span></dt><dd><p>Announces user(s) count upon joining a conference.</p></dd><dt><span class="term">
<code class="literal">d</code>
</span></dt><dd><p>Dynamically adds conference.</p></dd><dt><span class="term">
<code class="literal">D</code>
</span></dt><dd><p>Dynamically adds conference, prompting for a PIN.</p></dd><dt><span class="term">
<code class="literal">e</code>
</span></dt><dd><p>Selects an empty conference.</p></dd><dt><span class="term">
<code class="literal">E</code>
</span></dt><dd><p>Selects an empty Pinless conference.</p></dd><dt><span class="term">
<code class="literal">F</code>
</span></dt><dd><p>Passes DTMF digits through the conference to other
participants. DTMF digits used to enable conference features will
not be passed through.</p></dd><dt><span class="term">
<code class="literal">i</code>
</span></dt><dd><p>Announces user join/leave with review.</p></dd><dt><span class="term">
<code class="literal">I</code>
</span></dt><dd><p>Announces user join/leave without review.</p></dd><dt><span class="term">
<code class="literal">l</code>
</span></dt><dd><p>Sets listen only mode (listen only, no talking).</p></dd><dt><span class="term">
<code class="literal">m</code>
</span></dt><dd><p>Sets the participant as initially muted.</p></dd><dt><span class="term">
<code class="literal">M</code>
</span></dt><dd><p>Enables music on hold when the conference has a single
caller.</p></dd><dt><span class="term">
<code class="literal">o</code>
</span></dt><dd><p>Turns on talker optimization. With talker optimization,
Asterisk treats talkers who aren’t speaking as being muted,
meaning that no encoding is done on transmission and that received
audio that is not registered as talking is omitted, causing no
buildup in background noise.</p></dd><dt><span class="term">
<code class="literal">p</code>
</span></dt><dd><p>Allows user to exit the conference by pressing <code class="literal">#</code>.</p></dd><dt><span class="term">
<code class="literal">P</code>
</span></dt><dd><p>Always prompts for the PIN even if it is specified.</p></dd><dt><span class="term">
<code class="literal">q</code>
</span></dt><dd><p>Sets quiet mode. In quiet mode, Asterisk won’t play sounds
as conference participants enter or leave.</p></dd><dt><span class="term">
<code class="literal">r</code>
</span></dt><dd><p>Records conference (as <code class="literal">${MEETME_RECORDINGFILE}</code> using format
<code class="literal">${MEETME_RECORDINGFORMAT}</code>). The
default filename is <span class="emphasis"><em>meetme-conf-rec-</em></span><code class="literal">${CONFNO}</code><span class="emphasis"><em>-</em></span><code class="literal">{UNIQUEID}</code> and the default format is
<span class="emphasis"><em>.wav</em></span>.</p></dd><dt><span class="term">
<code class="literal">s</code>
</span></dt><dd><p>Presents the menu (user menu or admin menu, depending on
whether the caller is marked as an administrator) when <code class="literal">*</code> is received.</p></dd><dt><span class="term">
<code class="literal">t</code>
</span></dt><dd><p>Sets talk-only mode (talk only, no listening).</p></dd><dt><span class="term">
<code class="literal">T</code>
</span></dt><dd><p>Sets talker detection. Asterisk will sends events on the
Manager Interface identifying the channel that is talking. The
talker will also be identified on the output of the <code class="literal">meetme list</code> CLI command.</p></dd><dt><span class="term">
<code class="literal">w[(seconds)]</code>
</span></dt><dd><p>Waits for a marked admin to join the conference. If
<em class="replaceable"><code>seconds</code></em> is not specified, the
conference will wait indefinitely for the admin to join. If
<em class="replaceable"><code>seconds</code></em> is specified, the conference
will wait the specified number of seconds. If the admin still
hasn’t joined, the call will continue on with the next priority in
the dialplan.</p></dd><dt><span class="term">
<code class="literal">x</code>
</span></dt><dd><p>Closes the conference when the last marked user
exits.</p></dd><dt><span class="term">
<code class="literal">X</code>
</span></dt><dd><p>Allows user to exit the conference by entering a valid
single-digit extension (set via the variable <code class="literal">${MEETME_EXIT_CONTEXT}</code>), or the number
of an extension in the current context if that variable is not
defined.</p></dd><dt><span class="term">
<code class="literal">1</code>
</span></dt><dd><p>Doesn’t play initial message when the first person joins the
conference.</p></dd></dl></div><a id="I_programlisting_tt2280"></a><pre class="programlisting">exten => 123,1,Answer()
; add the caller to conference number 501 with pin 1234
<span class="strong"><strong>exten => 123,2,MeetMe(501,DpM,1234)</strong></span>
</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a id="asterisk-APP-B-NOTE-63"></a>Warning</h3><p>A suitable Zaptel timing interface must be installed for MeetMe
conferencing to work.</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="asterisk-APP-B-110"></a><h2>See Also</h2><p><a href="asterisk-APP-B-111.html" title="MeetMeAdmin()"><span class="refentrytitle">MeetMeAdmin()</span></a>, <a href="asterisk-APP-B-113.html" title="MeetMeCount()"><span class="refentrytitle">MeetMeCount()</span></a></p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="asterisk-APP-B-106.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="asterisk-APP-B.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="asterisk-APP-B-111.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">MailboxExists() </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> MeetMeAdmin()</td></tr></table></div><div xmlns="" id="svn-footer"><hr /><p>You are reading <em>Asterisk: The Future of Telephony</em> (2nd Edition for Asterisk 1.4), by Jim van Meggelen, Jared Smith, and Leif Madsen.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-Noncommercial-No Derivative Works License v3.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://oreilly.com/catalog/9780596510480/">http://www.oreilly.com/</a>.</p></div></body></html>
