<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+AGICommand_STREAM+FILE">Asterisk 10 AGICommand_STREAM FILE</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="Asterisk10AGICommand_STREAMFILE-STREAMFILE"></a>STREAM FILE</h1>
<h3><a name="Asterisk10AGICommand_STREAMFILE-Synopsis"></a>Synopsis</h3>
<p>Sends audio file on channel.</p>
<h3><a name="Asterisk10AGICommand_STREAMFILE-Description"></a>Description</h3>
<p>Send the given file, allowing playback to be interrupted by the given digits, if any. Returns <tt>0</tt> if playback completes without a digit being pressed, or the ASCII numerical value of the digit if one was pressed, or <tt>-1</tt> on error or if the channel was disconnected.</p>
<h3><a name="Asterisk10AGICommand_STREAMFILE-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>STREAM FILE FILENAME ESCAPE_DIGITS [SAMPLE_OFFSET]</pre>
</div></div>
<h5><a name="Asterisk10AGICommand_STREAMFILE-Arguments"></a>Arguments</h5>
<ul>
        <li><tt>FILENAME</tt> - File name to play. The file extension must not be included in the <em>filename</em>.</li>
        <li><tt>ESCAPE_DIGITS</tt> - Use double quotes for the digits if you wish none to be permitted.</li>
        <li><tt>SAMPLE_OFFSET</tt> - If sample offset is provided then the audio will seek to sample offset before play starts.</li>
</ul>
<h3><a name="Asterisk10AGICommand_STREAMFILE-SeeAlso"></a>See Also</h3>
<p><a href="/wiki/display/AST/Asterisk+10+AGICommand_CONTROL+STREAM+FILE" title="Asterisk 10 AGICommand_CONTROL STREAM FILE">Asterisk 10 AGICommand_CONTROL STREAM FILE</a></p>
<h3><a name="Asterisk10AGICommand_STREAMFILE-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-10-r340810.</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+AGICommand_STREAM+FILE">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+AGICommand_STREAM+FILE?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>