Untitled Document

<listen ...> element

The listen element is used for speech recognition, for audio recording, or for both.

A listen element which is used for speech recognition contains one or more grammar elements, which are used to specify possible user inputs. A listen element which is used for audio recording contains a record element which is used to configure the recording process. A listen element used for simultaneous recognition and recording holds one or more grammar elements and a record element. In all cases, bind can be used to process the results obtained from recognition and/or recording.

Attributes

Name	Data type	Default
accesskey	`CDATA`	`implied`
babbleTimeOut	`milliseconds`	`implied`
endSilience	`milliseconds`	`implied`
id	`ID`	`implied`
initialTimeOut	`milliseconds`	`implied`
maxTimeOut	`milliseconds`	`implied`
mode	`listen.mode`	`"automatic"`
onError	`script.statement`	`implied`
onNoReco	`script.statement`	`implied`
onReco	`script.statement`	`implied`
onSilence	`script.statement`	`implied`
onSpeechDetected	`script.statement`	`implied`
reject	`confidence.value`	`implied`
style	`CDATA`	`"visibility: hidden"`
xml:lang	`CDATA`	`implied`

Children

Parents

none

Properties

recoresult - Read-only. The results of recognition, held in an XML DOM node object containing the recognition return (see SALT 1.0 Specs 2.2.1.2). In case of no recognition, the return may be empty.
text - Read-only. A string holding the text of the words recognized. A SALT browser must attempt to extract such a string from the return result. Where the result format is known to the browser, this is found in a standard query related to that format, e.g. for NLSML, /result/interpretation[1]/input. For N-Best results, the string holds the text of the first (typically the most likely) utterance in the N-Best list. If the browser is unable to determine the text of the utterance (even after applying the standard query for the default format) the value will be null string.
status - Read-only. Integer holding a status code returned by the recognition platform. The status property is only meaningful after status-setting events are thrown by the listen object, and applications should examine it in the handler of the relevant event.

Properties used when <record ...> element tag is used:

recordlocation - Read-only. String holding the location of the recorded audio in a URI.
recordtype - Read-only. String holding the media type of the recorded audio.
recordduration - Read-only. Integer holding the approximate length of the recording in milliseconds.
recordsize - Read-only. Integer holding the size of the recorded audio file in bytes.

Methods

Examples

<html xmlns:salt="http://www.saltforum.org/2002/SALT">
    <body onload="RunAsk()">
        <form id="travelForm">
            <input name="txtBoxOriginCity" type="text" />
            <input name="txtBoxDestCity" type="text" />
        </form>

         
        <salt:prompt id="askOriginCity">
            Where would you like to leave from?
         </salt:prompt>
        <salt:prompt id="askDestCity">
            Where would you like to go to?
         </salt:prompt>
        <salt:prompt id="sayDidntUnderstand" oncomplete="runAsk()">
            Sorry, I didn't understand.
        </salt:prompt>

        <salt:listen id="recoOriginCity"
                 onReco="procOriginCity()"
                 onNoReco="sayDidntUnderstand.Start()">
            <salt:grammar src="city.xml" />
        </salt:listen>
        <salt:listen id="recoDestCity"
                 onReco="procDestCity()"
                 onNoReco="sayDidntUnderstand.Start()">
            <salt:grammar src="city.xml" />
        </salt:listen>

         
        <script>
            function RunAsk() {
                if (travelForm.txtBoxOriginCity.value=="") {
                    askOriginCity.Start();
                    recoOriginCity.Start();
                } else if (travelForm.txtBoxDestCity.value=="") {
                    askDestCity.Start();
                    recoDestCity.Start();
                }
            }
            function procOriginCity() {
                travelForm.txtBoxOriginCity.value = recoOriginCity.text;
                RunAsk();
            }
            function procDestCity() {
                travelForm.txtBoxDestCity.value = recoDestCity.text;
                travelForm.submit();
            }
        </script>
    </body>
</html>

<html xmlns:salt="http://www.saltforum.org/2002/SALT">
    <head>
        <title>origin and destination</title>
    </head>

    <body>
        <form id="travelForm" action="http://mysite.com/travel/inquire.php"
                 method="post">
            <input name="txtBoxOriginCity" type="text" />
            <input name="txtBoxDestCity" type="text" />
        </form>

        
        <salt:prompt id="askOriginCity" onerror="procError()">
            Where from?
        </salt:prompt>
        <salt:prompt id="askDestCity" onerror="procError()">
            Where to?
        </salt:prompt>
        <salt:prompt id="notUnderstood" onerror="procError()">
            Sorry, I could not understand your input.
        </salt:prompt>
        <salt:prompt id="operator"
                 oncomplete="transferToOperator()"
                 onerror="transferToOperator()">
                
            I am transferring you to an operator.
        </salt:prompt>

         <salt:listen id="recoOriginCity"
                 onReco="procOriginCity()"
                onNoReco="procNothingUnderstood()"
                onSilence="procNothingUnderstood()"
                onError="procError()">
            <salt:grammar src="./city.grxml" />
        </salt:listen>
        <salt:listen id="recoDestCity"
                onReco="procDestCity()"
                onNoReco="procNothingUnderstood()"
                onSilence="procNothingUnderstood()"
                onError="procError()">
            <salt:grammar src="./city.grxml" />
        </salt:listen>

         
        <script>
            function RunAsk() {
                if (txtboxOriginCity.value=="") {
                    askOriginCity.Start();
                    recoOriginCity.Start();
                } else if (txtboxDestCity.value=="") {
                    askDestCity.Start();
                    recoDestCity.Start();
                } else {
                    
                    travelForm.submit();
                 }
            }
            function procOriginCity () {
                txtBoxOriginCity.value = recoOriginCity.value;
                RunAsk();
            }
            function procDestCity () {
                txtBoxDestCity.value = recoDestCity.value;
                RunAsk();
            }
            function procNothingUnderstood(){
                notUnderstood.Start();
                RunAsk();
            }
            function procError() {
                operator.Start();
            }
            function terminate() {
                
                window.close();
            }
        </script>

         
        <script>
        
            callControl.attachEvent("call.disconnected",terminate());
            
            RunAsk();
        </script>
    </body>
</html>

Extra info

For details on usage of this element, see the SALT Specification, Version 1.0.