1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Asterisk Project : 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>
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
<tr>
<td valign="top" class="pagebody">
<div class="pageheader">
<span class="pagetitle">
Asterisk Project : Application_Record
</span>
</div>
<div class="pagesubheading">
This page last changed on Mar 30, 2011 by <font color="#0050B2">wikibot</font>.
</div>
<h1><a name="Application_Record-Record%28%29"></a>Record()</h1>
<h3><a name="Application_Record-Synopsis"></a>Synopsis</h3>
<p>Record to a file.</p>
<h3><a name="Application_Record-Description"></a>Description</h3>
<p>If filename contains <tt>%d</tt>, these characters will be replaced with a number incremented by one each time the file is recorded. Use <tt>core show file formats</tt> to see the available formats on your system User can press <tt>#</tt> 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><tt>RECORDED_FILE</tt> - Will be set to the final filename of the recording.</li>
<li><tt>RECORD_STATUS</tt> - This is the final status of the command
<ul>
<li><tt>DTMF</tt> - A terminating DTMF was received ('#' or '*', depending upon option 't')</li>
<li><tt>SILENCE</tt> - The maximum silence occurred in the recording.</li>
<li><tt>SKIP</tt> - The line was not yet answered and the 's' option was specified.</li>
<li><tt>TIMEOUT</tt> - The maximum length was reached.</li>
<li><tt>HANGUP</tt> - The channel was hung up.</li>
<li><tt>ERROR</tt> - An unrecoverable error occurred, which resulted in a WARNING to the logs.</li>
</ul>
</li>
</ul>
<h3><a name="Application_Record-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Record(filenameformat[,silence[,maxduration[,options]]])</pre>
</div></div>
<h5><a name="Application_Record-Arguments"></a>Arguments</h5>
<ul>
<li><tt>filename</tt>
<ul>
<li><tt>filename</tt></li>
<li><tt>format</tt> - Is the format of the file type to be recorded (wav, gsm, etc).</li>
</ul>
</li>
<li><tt>silence</tt> - Is the number of seconds of silence to allow before returning.</li>
<li><tt>maxduration</tt> - Is the maximum recording duration in seconds. If missing or 0 there is no maximum.</li>
<li><tt>options</tt>
<ul>
<li><tt>a</tt> - Append to existing recording rather than replacing.</li>
<li><tt>n</tt> - Do not answer, but record anyway if line not yet answered.</li>
<li><tt>q</tt> - quiet (do not play a beep tone).</li>
<li><tt>s</tt> - skip recording if the line is not yet answered.</li>
<li><tt>t</tt> - use alternate '*' terminator key (DTMF) instead of default '#'</li>
<li><tt>x</tt> - Ignore all terminator keys (DTMF) and keep recording until hangup.</li>
<li><tt>k</tt> - Keep recorded file upon hangup.</li>
<li><tt>y</tt> - Terminate recording if <b>any</b> DTMF digit is received.</li>
</ul>
</li>
</ul>
<h3><a name="Application_Record-SeeAlso"></a>See Also</h3>
<h3><a name="Application_Record-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-1.8-r311874.</p>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td height="12" background="https://wiki.asterisk.org/wiki/images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
</tr>
<tr>
<td align="center"><font color="grey">Document generated by Confluence on Oct 04, 2011 12:42</font></td>
</tr>
</table>
</body>
</html>
|
