dingyu
/
Asterisk


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
							<!DOCTYPE html>
<html>
    <head>
        <title>Asterisk Project : Asterisk 13 Application_Record</title>
        <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>

    <body class="theme-default aui-theme-default">
        <div id="page">
            <div id="main" class="aui-page-panel">
                <div id="main-header">
                    <div id="breadcrumb-section">
                        <ol id="breadcrumbs">
                            <li class="first">
                                <span><a href="index.html">Asterisk Project</a></span>
                            </li>
                                                    <li>
                                <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
                            </li>
                                                    <li>
                                <span><a href="Asterisk-13-Dialplan-Applications_29394285.html">Asterisk 13 Dialplan Applications</a></span>
                            </li>
                                                </ol>
                    </div>
                    <h1 id="title-heading" class="pagetitle">
                                                <span id="title-text">
                            Asterisk Project : Asterisk 13 Application_Record
                        </span>
                    </h1>
                </div>

                <div id="content" class="view">
                    <div class="page-metadata">
                        
        
            Created by <span class='author'> wikibot</span> on Aug 08, 2014
                        </div>
                    <div id="main-content" class="wiki-content group">
                    <h1 id="Asterisk13Application_Record-Record()">Record()</h1>

<h3 id="Asterisk13Application_Record-Synopsis">Synopsis</h3>

<p>Record to a file.</p>

<h3 id="Asterisk13Application_Record-Description">Description</h3>

<p>If filename contains <code>%d</code>, these characters will be replaced with a number incremented by one each time the file is recorded. Use <code>core show file formats</code> to see the available formats on your system User can press <code>#</code> to terminate the recording and continue to the next priority. If the user hangs up during a recording, all data will be lost and the application will terminate.</p>

<ul>
	<li><code>RECORDED_FILE</code> - Will be set to the final filename of the recording.</li>
	<li><code>RECORD_STATUS</code> - This is the final status of the command
	<ul>
		<li>DTMF - A terminating DTMF was received ('#' or '*', depending upon option 't')</li>
		<li>SILENCE - The maximum silence occurred in the recording.</li>
		<li>SKIP - The line was not yet answered and the 's' option was specified.</li>
		<li>TIMEOUT - The maximum length was reached.</li>
		<li>HANGUP - The channel was hung up.</li>
		<li>ERROR - An unrecoverable error occurred, which resulted in a WARNING to the logs.</li>
	</ul>
	</li>
</ul>


<h3 id="Asterisk13Application_Record-Syntax">Syntax</h3>


<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Record(filename.format,[silence,[maxduration,[options]]])</pre>
</div></div>

<h5 id="Asterisk13Application_Record-Arguments">Arguments</h5>

<ul>
	<li><code>filename</code>
	<ul>
		<li><code>filename</code></li>
		<li><code>format</code> - Is the format of the file type to be recorded (wav, gsm, etc).</li>
	</ul>
	</li>
	<li><code>silence</code> - Is the number of seconds of silence to allow before returning.</li>
	<li><code>maxduration</code> - Is the maximum recording duration in seconds. If missing or 0 there is no maximum.</li>
	<li><code>options</code>
	<ul>
		<li><code>a</code> - Append to existing recording rather than replacing.</li>
		<li><code>n</code> - Do not answer, but record anyway if line not yet answered.</li>
		<li><code>o</code> - Exit when 0 is pressed, setting the variable <code>RECORD_STATUS</code> to <code>OPERATOR</code> instead of <code>DTMF</code></li>
		<li><code>q</code> - quiet (do not play a beep tone).</li>
		<li><code>s</code> - skip recording if the line is not yet answered.</li>
		<li><code>t</code> - use alternate '*' terminator key (DTMF) instead of default '#'</li>
		<li><code>x</code> - Ignore all terminator keys (DTMF) and keep recording until hangup.</li>
		<li><code>k</code> - Keep recorded file upon hangup.</li>
		<li><code>y</code> - Terminate recording if <strong>any</strong> DTMF digit is received.</li>
	</ul>
	</li>
</ul>


<h3 id="Asterisk13Application_Record-SeeAlso">See Also</h3>


<h3 id="Asterisk13Application_Record-ImportVersion">Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
                    </div>

                    
                </div>             </div> 
            <div id="footer">
                <section class="footer-body">
                    <p>Document generated by Confluence on Aug 11, 2014 13:45</p>
                </section>
            </div>
        </div>     </body>
</html>