swirec_compute_implicit_root

Activates all public rules in a speech grammar as the root rule.

Value

Boolean. Use 1 to enable implicit root activation.

Default

0 (disabled)

How to set

Shown in precedence order (see Rules of parameter precedence):

Set in the browser, using the Vendor-Specific-Parameters header in a RECOGNIZE or SET-PARAMS method.

In Management Station set on the Nuance recognition service. If not using Management Station, set in a Recognizer configuration file (User-nrsxx.xml).

Usage

This parameter is for convenience in the case where grammars do not declare a root. It is rarely used because most grammars declare a root explicitly.

By default, Recognizer requires an explicit root declaration inside the grammar (the root attribute of the grammar element) or as part of the activation URI (for example, myuri.grxml#myroot). This is the most portable reading of the specifications since neither the VoiceXML nor the SRGS grammar specifications define how to determine a root implicitly.

However, when you enable this parameter, the Recognizer defines an implicit root as the union of all the public rules in a grammar. For example, if a grammar named G.grxml contains the public rules R1 and R2 but no root declaration, then the grammar can be activated with the root R1 ("G.grxml#R1"), with the root R2 ("G.grxml#R2"), or with both rules ("G.grxml").