Dtmf Remarks

Specifies input resources, settings and error-handling for touch-tone (dual tone multi-frequency, or DTMF) telephone input.

Grammar resources used by the Dtmf control recognize only the characters found on the telephone keypad.

Use the Dtmf control to specify a grammar containing DTMF-mode rules only. DTMF-mode grammar files recognize DTMF input, and voice-mode grammar files recognize speech input. Do not reference DTMF-mode grammar rules within voice-mode grammars, and do not reference voice-mode grammars rules within DTMF-mode grammars.

DTMF-mode grammars maintain an xml:lang property, but DTMF input always consists of the same 12 keys, regardless of the user's spoken language. For this reason, if a grammar's mode property is dtmf, recognition engines will ignore its xml:lang property. Authors can create dialogs that use a foreign language voice-mode grammar and an English (US) DTMF-mode grammar.

The following grammar contains a rule called dtmfStopRule that is activated by any keypad character.

<grammar root="dtmfStopRule" version="1.0" xmlns="http://www.w3.org/2001/06/grammar"
  mode="dtmf" lang="en-US" tag-format="semantics-ms/1.0" > 
  <rule id="dtmfStopRule" scope="public">
    <one-of>
      <item> 0 </item>
      <item> 1 </item>
      <item> 2 </item>
      <item> 3 </item>
      <item> 4 </item>
      <item> 5 </item>
      <item> 6 </item>
      <item> 7 </item>
      <item> 8 </item>
      <item> 9 </item>
      <item> # </item>
      <item> * </item>
    </one-of>
  </rule>
</grammar>

Markup

<Dtmf properties >

   <Params>
      <speech:Param Name="..." >value</speech:Param>
      ...
   </Params>

   <Grammars>
    <speech:Grammar properties ></speech:Grammar>
      ...
   </Grammars>

</Dtmf>

See Also

Dtmf Class | Dtmf Constructor | Dtmf Members | Dtmf Properties | Dtmf Methods | Dtmf Events