Untitled Document

<dtmf ...> element

The dtmf element is used in telephony applications to specify possible DTMF inputs and a means of dealing with the collected results and other DTMF events. Like listen, its main elements are grammar and bind, and it holds resources for configuring the DTMF collection process and handling DTMF platform and collection events.

Attributes

Name	Data type	Default
endSilience	`milliseconds`	`implied`
id	`ID`	`implied`
initialTimeOut	`milliseconds`	`implied`
interDigitTimeOut	`milliseconds`	`implied`
onError	`script.statement`	`implied`
onKeyPress	`script.statement`	`implied`
onNoReco	`script.statement`	`implied`
onReco	`script.statement`	`implied`
onSilence	`script.statement`	`implied`
preFlush	`boolean`	`"false"`

Name

Data type

Default

endSilience

milliseconds

implied

ID

implied

initialTimeOut

milliseconds

implied

interDigitTimeOut

milliseconds

implied

onError

script.statement

implied

onKeyPress

script.statement

implied

onNoReco

script.statement

implied

onReco

script.statement

implied

onSilence

script.statement

implied

preFlush

boolean

"false"

Children

Parents

none

Properties

dtmfresult - Read only. XML node holding the DTMF result. This is updated at the end of DTMF collection, and holds an XML document containing semantic markup language. Semantic markup language is discussed in section 2.2.1.2 of the SALT 1.0 Specs.

text - Read-only string containing tokens of the actual keys pressed during recognition. This string is appended with every key press event (in-grammar or out-of-grammar) received by the dtmf object, so it is updated on every onKeyPress, onReco and onNoReco event. The string does not hold white space between tokens.

status - Read-only. Integer holding the status code returned by DTMF collection. The status property is only meaningful after status-setting events are thrown by the dtmf object, and applications should examine it in the handler of the relevant event.

Methods

Examples

<html xmlns:salt="http://www.saltforum.org/2002/SALT">
...
    <body onload="RunAsk()">
        <form id="f1" action="http://www.example.com/savewaveform.aspx"
                 method="get">
            <input name="vmail" type="hidden" />
        </form>

         
        <salt:prompt id="p_record" oncomplete="l_recordvm.Start()">
            Please speak after the tone. You may press any key to end your recording.
        </salt:prompt>
        <salt:prompt id="p_save">
            Do you want to save this voicemail?
        </salt:prompt>

        
        
        <salt:listen id="l_recordvm"
                initialtimeout="3000"
                endsilence="1500"
                babbletimeout="60000"
                onreco="saveAudio()"
                onnoreco="saveAudio()"
                onsilence="RunAsk()" >
            <salt:record />
        </salt:listen>

         
        <salt:listen id="l_save" onreco="processSave()">
            <salt:grammar src="./yesno.grxml" />
        </salt:listen>

        
        <salt:dtmf id="d_stop_rec" onReco="saveAudio()">
            <grammar src="alldigits.grxml" />
        </salt:dtmf>

         
        <script>
            function RunAsk() {
                if (voicemail.value=="") {
                    p_record.Start();
                }
            }
            // Ask user if they are satisfied with their recording
            function saveAudio () {
                p_save.Start();
                l_save.Start();
            }
            // If user is satisfied post file name back to web server
            // otherwise start again
            function processSave () {
                smlResult = event.srcElement.recoresult;
                origNode = smlResult.selectSingleNode("//answer/text()");
                if (origNode.value == "Yes") {
                    vmail.value = l_recordvm.recordlocation;
                    f1.submit();
                } else {
                    RunAsk();
                }
            }
        </script>
    </body>
</html>

Extra info