Start Method

Starts the recognition process.

listen.Start();

Remarks

The Start method uses as active grammars all the top-level rules for the recognition context that have not been explicitly deactivated. The Start method initiates one of the following four recognition events:

Event	Reason for Occurrence
onreco	Occurs when speech is recognized.
onnoreco	Occurs when speech is not recognized.
onsilence	Occurs when only silence is detected after a period of time established using the initialtimeout attribute.
onspeechdetected	Occurs when speech is detected.
onerror	Occurs when any error occurs. The status property provides a status code that indicates the cause of the error.

A call to the Start method is ignored if the same listen element is already started and in the active state. A Start call to another listen element raises an error and sets the status value to -9.

Example

The following code demonstrates the use of the Start method.

<html xmlns:salt="http://www.saltforum.org/2002/SALT">
<META HTTP-EQUIV="Content-Type" Content="text/html; charset=Windows-1252">
  <head>
    <title>My Test Page</title>
    <object id="Speechtags" CLASSID="clsid:DCF68E5B-84A1-4047-98A4-0A72276D19CC" VIEWASTEXT></object>
  </head>
  <body>
    <!--Importing the namespace from the implementation -->
    <?import namespace="salt" implementation="#Speechtags" />

    <!--SALT speech recognition object -->
    <salt:listen id="TestReco" onreco="Handleonreco()" onnoreco="Handleonnoreco()"
    onspeechdetected="Handleonspeechdetected()" onsilence="Handleonsilence()">
 
      <salt:grammar name="numbers"> 
        <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="#numbers" />
          </rule>
          <rule id="numbers">
            <one-of>
              <item>one</item> 
              <item>two</item> 
              <item>three</item> 
              <item>four</item> 
              <item>five</item>               
            </one-of>
          </rule>
        </grammar>
      </salt:grammar>
    </salt:listen>
    <form>
      <input type="button" value="Start a single recognition" name="StartRecognitionButton"
      onClick="StartRecognition()">
    </form>

    Say a number from one through five, inclusive.

    <form id="StatusForm">
      Status:  <input size="55" name="StatusTextbox"> 
    </form>

    <form id="ResultForm">
      Result:  <input size="55" name="ResultTextbox">
    </form>

    <script id="script1" language="jscript">
    <!--        
      function StartRecognition() {
        try {
          StatusForm.StatusTextbox.value = "Listening...";
          ResultForm.ResultTextbox.value = "";
          TestReco.Start();
        } catch(e) {
            alert("Recognition error");
        }            
      }
      function Handleonreco() {
        try {
          StatusForm.StatusTextbox.value = "Received recognition result";
          ResultForm.ResultTextbox.value = event.srcElement.text;
        } catch(e) {
          alert("Recognition error");
        }
      }
      function Handleonnoreco() {
        var Status;
        try {
          Status = event.srcElement.status;
          StatusForm.StatusTextbox.value = "No recognition, status: " + Status;                                
        } catch(e) {
          alert("No recognition");
        }
      }
      function Handleonspeechdetected() {
        var Status;
        try {
          Status = event.srcElement.status;
          StatusForm.StatusTextbox.value = "Speech detected";                            
        } catch(e) {
          alert("No recognition");
        }
      }
      function Handleonsilence() {
        var Status;
        try {
          Status = event.srcElement.status;
          StatusForm.StatusTextbox.value = "Silence detected, status: " + Status;                                
        } catch(e) {
          alert("No recognition");
        }
      }
    -->
    </script>
  </body>
</html>

Start Method

Remarks

Example

See Also

Zusätzliche Ressourcen