Stop Method

Artigo
07/05/2006

Stops the recognition process and returns recognition results.

listen.Stop()

Remarks

When the Stop method is invoked, the listen element stops recording audio. However, the recognizer returns recognition results on the audio that was received up to the point where recording stopped. The recognizer then initiates an event such as onreco or onnoreco. In contrast, the Cancel method stops the recognition process, but cancel neither returns a recognition result nor initiates any events.

Once the recognition process is complete, all the recognition resources used by the listen element are released, and its grammars deactivated. In other words, the Stop method simply stops the audio stream but speech recognition is still active.

The Stop method does not need to be used explicitly for typical recognitions in automatic mode, because the recognizer stops the recognition on endpoint detection after recognizing a complete sentence.

If a listen has not been started, a call to the Stop method has no effect.

Example

The following code demonstrates the use of the Stop method.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns:salt="http://www.saltforum.org/2002/SALT">
  <head>
    <object id="Speechtags" CLASSID="clsid:DCF68E5B-84A1-4047-98A4-0A72276D19CC" VIEWASTEXT></object>
  </head>
    
  <body>
    <?import namespace="salt" implementation="#Speechtags" />
    <salt:listen id="listen1" reject=".65" babbletimeout="5000" onreco="Handleonreco()" onnoreco="Handleonnoreco()">
      <salt:grammar name="cities"> 
        <grammar version="1.0" tag-format="semantics-ms/1.0" lang="en-US" 
        xmlns="http://www.w3.org/2001/06/grammar" root="root">
          <rule id="root">
            <item repeat="0-1">from </item>
            <ruleref uri="#cities" />
          </rule>
          <rule id="cities">
            <one-of>
              <item>Seattle</item> 
              <item>Boston</item> 
              <item>Houston</item> 
              <item>New York</item> 
            </one-of>
          </rule>
        </grammar>
      </salt:grammar>
     </salt:listen>

    <input type="button" name="BtnListen" value="Start Listening" OnClick="StartListening()" id="StartListen">
    <input type="button" name="BtnStop" value="Stop" OnClick="StopListening()" id="StopListen"
    
    <br><br>
      This is an example of an automatic mode listen.<br>
      Click Start to begin; after speaking, the application will automatically stop.<br>
      Valid city names for recognition are Seattle, Boston, Houston, and New York.
    
    <br><br>
    <input type="text" name="TxtStatus" size = "80" value="Listening for test" id="RecoTxt">
    
    <script language="JScript">
    <!--     
      function StartListening() {
        RecoTxt.value  = "Starting to listen...";
        listen1.Start();
        RecoTxt.value  = "Listening...";
      }
      function StopListening() {
        RecoTxt.value = "Stopped listen";
        listen1.Stop();
      }
      function Handleonreco() {
        RecoTxt.value = "Received onreco.";
        smlResult = event.srcElement.recoresult;
        RecoTxt.value = smlResult.xml;
      }
      function Handleonnoreco() {
        RecoTxt.value = "Received onnoreco";
      }
             
    -->
    </script>
  </body>
</html>

Partilhar via

Stop Method

Remarks

Example

See Also

Recursos adicionais