<html>
<head>
    <base href="https://wiki.asterisk.org/wiki">
            <link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&amp;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+11+Application_SpeechBackground">Asterisk 11 Application_SpeechBackground</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="Asterisk11Application_SpeechBackground-SpeechBackground%28%29"></a>SpeechBackground()</h1>

<h3><a name="Asterisk11Application_SpeechBackground-Synopsis"></a>Synopsis</h3>

<p>Play a sound file and wait for speech to be recognized.</p>
<h3><a name="Asterisk11Application_SpeechBackground-Description"></a>Description</h3>



<p>This application plays a sound file and waits for the person to speak. Once they start speaking playback of the file stops, and silence is heard. Once they stop talking the processing sound is played to indicate the speech recognition engine is working. Once results are available the application returns and results (score and text) are available using dialplan functions.</p>

<p>The first text and score are ${SPEECH_TEXT(0)} AND ${SPEECH_SCORE(0)} while the second are ${SPEECH_TEXT(1)} and ${SPEECH_SCORE(1)}.</p>

<p>The first argument is the sound file and the second is the timeout integer in seconds.</p>

<p>Hangs up the channel on failure. If this is not desired, use TryExec.</p>

<h3><a name="Asterisk11Application_SpeechBackground-Syntax"></a>Syntax</h3>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>SpeechBackground(sound_file,timeout,options)</pre>
</div></div>
<h5><a name="Asterisk11Application_SpeechBackground-Arguments"></a>Arguments</h5>


<ul>
        <li>sound_file</li>
        <li>timeout - Timeout integer in seconds. Note the timeout will only start once the sound file has stopped playing.</li>
        <li>options
        <ul>
                <li>n - Don't answer the channel if it has not already been answered.</li>
        </ul>
        </li>
</ul>



<h3><a name="Asterisk11Application_SpeechBackground-ImportVersion"></a>Import Version</h3>

<p>This documentation was imported from Asterisk Version SVN-trunk-r370322</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+11+Application_SpeechBackground">View Online</a>
              |
       <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_SpeechBackground?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>