item Element (Microsoft.Speech)

Contains any valid rule expansion. A valid rule expansion can consist of a word or other entity that can be spoken, such as content in a token Element (Microsoft.Speech), a ruleref Element (Microsoft.Speech), a tag Element (Microsoft.Speech), or any logical combination of these. When an item element contains a combination of rule expansions (for example, a combination of words), the sequence in which words occur in the speech input must match the sequence of rule expansions in the item element for recognition to be successful.

Syntax

<item
    repeat = (n | m-n | m- | 0-1)
    repeat-prob = (n | n. | n.nnnn | .nnnn)
    weight = (n | n. | .n | n.n) 
</item>

Attributes

The item element takes the following attributes:

Remarks

Use the repeat attribute to define a rule expansion in an item element as either optional or repeatable. A value of n- indicates that the item must occur a minimum of n times and can be repeated an infinite number of times. For example, a value of 1- indicates that the content of the item element can occur from one to any number of times. A value of 0-1 indicates that the occurrence of the content of the item element in the speech input is optional (a speaker can utter the content either zero times or one time). If repeat is omitted, the content of the item element must occur exactly once in the speech input for successful recognition.

For item elements that contain alternatives within a one-of Element (Microsoft.Speech), use the weight attribute to assign a bias to each alternative relative to other alternatives. You can assign values to the weight attribute that are greater than or less than 1.0 to each alternative in an expansion. An alternative’s weight in comparison to other alternatives in an expansion determines its bias. For example, if the alternatives in an expansion have weights of .2, .5, and .7, the alternative with the weight of .7 would have the highest bias, even though its weight is less than 1.0. If another alternative in the same expansion did not have an assigned weight (it receives the default weight 1.0), it would have a higher bias than the alternatives with weights of .2, .5, and .7. In the example below, "medium" has a higher bias than "small", but a lower bias than "large".

The effects of a tag Element (Microsoft.Speech) contained within an item element are applied to the entire contents of the item element.

Unlike the Speech Recognition Grammar Specification (SRGS) Version 1.0 specification, the Microsoft Speech Platform SDK 11 does not support the use of the xml:lang attribute on the item element. Grammars in the Speech Platform SDK 11 can contain only one language, and this must be declared in the grammar Element (Microsoft.Speech).

Example

<grammar root="pizzaSize" version="1.0" xmlns="http://www.w3.org/2001/06/grammar"
 xml:lang="en-US" tag-format="semantics/1.0">

  <rule id="pizzaSize" scope="public">
   <item repeat="0-1" repeat-prob=".4"> I would like </item>
    a
    <one-of>
      <item weight=".5"> small </item> 
      <item> medium </item> 
      <item weight="2"> large </item> 
    </one-of>
    pizza
  </rule>

</grammar>