LV_SRE_ActivateGlobalGrammar

You only need to use this function if you have a grammar in the speech port with same name as a grammar in the global space, and you wish to activate the global grammar.

Function

• int LV_SRE_ActivateGlobalGrammar(HPORT hport,const char* gram_name);

Parameters

hport

The handle of the speech port for which you are activating the grammar.

gram_name

The identifier for the grammar being activated. This is the same identifier that was given to the grammar when it was loaded.

Return Values

LV_SUCCESS

No errors; this grammar is now active.

LV_FAILURE

This grammar could not be activated, because the port was shutting down.

LV_INVALID_GRAMMAR_LABEL

The input gram_name specifies a grammar that is not available for activation (either not loaded or has been unloaded).

LV_INVALID_PORT

The input hport is not a valid one.

LV_EXCEPTION

An exception occured while processing the request.

Remarks

Since LV_SRE_ActivateGrammar searches the speech port's loaded grammars, and then searches the application level grammars, you only need to use LV_SRE_ActivateGlobalGrammar if there is a name conflict between your local and app-level grammars, and you need to activate the app-level one.

Detailed error and warning messages are sent to the speech port's logging callback function at priorities 0 and 1, respectively.

See Also

• LV_SRE_ActivateGrammar
• LV_SRE_DeactivateGrammar
• LV_SRE_DeactivateGrammars
• LVSpeechPort::ActivateGlobalGrammar (C++ API)