How Tos

Last reviewed: 7/15/2011

Article ID: H071106

HOW: Managing JSGF 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 Java Speech Grammar Format (JSGF) grammars.

More Information

The Java Speech Grammar Format (JSGF) grammar text file format is a Backus-Naur Form (BNF) grammar adapted for speech recognition. The W3C specification is Recognition Grammar Specification Version 1.0.

Creating, Editing, and Testing Java Speech Grammar Format (JSGF) Grammars

Chant Developer Workbench 2011 introduces support for creating, editing, and testing Java Speech Grammar Format (JSGF) grammars. The new editor provides intelliprompt assistance for fast syntax input and editing.

The steps to create a Java Speech Grammar Format (JSGF) grammar with Chant Developer Workbench and GrammarKit are as follows:

  1. Select the File->New->Speech Recognition Grammar->L&H JSGF Grammar menu item or click the New Standard toolbar button and select L&H JSGF 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 Java Speech Grammar Format (JSGF) Grammars

GrammarKit 4 introduces support for dynamically generating and compiling Java Speech Grammar Format (JSGF) grammars.

The following example illustrates generating a Java Speech Grammar Format (JSGF) 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.CGSVoConJSGF);

Recognizing with Java Speech Grammar Format (JSGF) Grammars

SpeechKit 7 introduces support for recognizing with Java Speech Grammar Format (JSGF) grammars through Nuance VoCon 3200 V4.

The following example illustrates defining, enabling, and disabling a Java Speech Grammar Format (JSGF) grammar resource for speech recognition.

private Chant.SpeechKit.NChantSR NChantSR1;
// Instantiate NChantSR object
NChantSR1 = new NChantSR(this);
NChantSR1.SetNumberProperty(ChantNumberProperty.CNPEngineAPI, (int)ChantEngineAPI.CEVoCon4);
// Win32 - Set the path to the VoCon runtime libraries
NChantSR1.SetStringProperty(ChantStringProperty.CSPEnginePath, "C:\\Program Files\\Nuance\\vocon3200\\EDS_v4_1\\bin\\winx86rls");
// Win32 - Set the file name of CLC model
NChantSR1.SetStringProperty(ChantStringProperty.CSPCLCModel, "C:\\Program Files\\Nuance\\vocon3200\\EDS_v4_1\\models\\clc_enu_cfg3_v1_0_0.dat");
// Win32 - Or set the file name of DDG2P model
//NChantSR1.SetStringProperty(ChantStringProperty.CSPDDG2PModel, "C:\\Program Files\\Nuance\\vocon3200\\EDS_v4_1\\models\\ddg2p_enu_vadvde_ttsasr_large_v2_1_3.dat");
// Define a grammar vocabulary
int grammarVocabID = NChantSR1.DefineResource(ChantSpeechResource.CSRGrammarVocab, "mygrammar.jsgf");
// Load and enable grammar vocabulary
NChantSR1.EnableResource(ChantSpeechResource.CSRGrammarVocab, grammarVocabID);
// Disable it
NChantSR1.DisableResource(ChantSpeechResource.CSRGrammarVocab, grammarVocabID);