How Tos

Last reviewed: 7/15/2011

Article ID: H071142

HOW: Managing SAPI 4 Grammars

The information in this article applies to:

  • Developer Workbench 2011
  • GrammarKit 4
  • SpeechKit 7


Chant Developer Workbench 2011, GrammarKit 4, and SpeechKit 7 provide support for SAPI 4 grammars.

More Information

The SAPI 4 grammar text file format is similar to .inf or .ini files and is adapted for speech recognition by Microsoft.

Creating, Editing, and Testing SAPI 4 Grammars

Chant Developer Workbench 2011 continues support for creating, editing, and testing SAPI 4 grammars. The editor provides intelliprompt assistance for fast syntax input and editing.

The steps to create a SAPI 4 grammar with Chant Developer Workbench and GrammarKit are as follows:

  1. Select the File->New->Speech Recognition Grammar->SAPI 4 Grammar menu item or click the New Standard toolbar button and select SAPI 4 Grammar to create one in a document window. Note if you do not see any grammar types listed in the menu, then you need to run the Chant Software Unlock utility to begin your evaluation, your GrammarKit evaluation has expired, or you need to register and unlock your licensed copy with a serial number.
  2. Save your new grammar to a file by selecting the File->Save menu item or click the Save Standard toolbar button. You are prompted to confirm the file name.

Dynamically Generating SAPI 4 Grammars

GrammarKit 4 introduces support for dynamically generating and compiling SAPI 4 grammars.

The following example illustrates generating a SAPI 4 grammar:

private Chant.GrammarKit.NChantGM NChantGM1;
private NChantGrammar _NChantGrammar = null;
// Instantiate NChantGM object
NChantGM1 = new NChantGM(this);
// Build Colors grammar
_NChantGrammar = NChantGM1.CreateGrammar("Colors");
_NChantGrammar.AddComment("This is the list of colors");
NChantGrammarRule nChantGrammarRule = _NChantGrammar.AddRule("Color");
NChantGrammarList nChantGrammarList = nChantGrammarRule.AddList("colorlist");
string[] colors = { "red", "blue", "green", "yellow", "pink", "purple", "brown", "orange" };
for (int i = 0; i < colors.Length; i++)
string grammarSource = _NChantGrammar.GenerateGrammar(ChantGrammarSyntax.CGSSAPI4CFG);

Recognizing with SAPI 4 Grammars

SpeechKit 7 introduces support for recognizing with SAPI 4 grammars through Microsoft SAPI 5.3 and higher.

The following example illustrates defining, enabling, and disabling a SAPI 4 grammar resource for speech recognition.

private Chant.SpeechKit.NChantSR NChantSR1;
// Instantiate NChantSR object
NChantSR1 = new NChantSR(this);
// Define a grammar vocabulary
int grammarVocabID = NChantSR1.DefineResource(ChantSpeechResource.CSRGrammarVocab, "mygrammar.cfg");
// Load and enable grammar vocabulary
NChantSR1.EnableResource(ChantSpeechResource.CSRGrammarVocab, grammarVocabID);
// Disable it
NChantSR1.DisableResource(ChantSpeechResource.CSRGrammarVocab, grammarVocabID);