Properties

 

#define PROP_EX_SAVE_SOUND_FILES                2

#define PROP_EX_LANGUAGE                        3

#define PROP_EX_SRE_SERVERS                     4

#define PROP_EX_CHOOSE_MODEL                    8

#define PROP_EX_SET_SERVER_IP                   10

#define PROP_EX_SET_SERVER_PORT                 11

#define PROP_EX_SEARCH_BEAM_WIDTH               12

#define PROP_EX_CONCEPT_REPETITION_MIN          13

#define PROP_EX_CONCEPT_REPETITION_MAX          14

#define PROP_EX_ENABLE_LATTICE_CONFIDENCE_SCORE 15

#define PROP_EX_MAX_NBEST_RETURNED              16

#define PROP_EX_DECODE_TIMEOUT                  17

#define PROP_EX_MOD_SEL_LOW_THLD                18

#define PROP_EX_MOD_SEL_HIGH_THLD               19

#define PROP_EX_LICENSE_TYPE                    20

 

PROP_EX_SAVE_SOUND_FILES

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_PORT

Default Value: 1

Save request and answer files to disk.

Setting to 1 saves request and answer files for each call to Decode to LVLANG\Responses (Win32) or LVRESPONSES/Responses (Linux).  Setting to 0 stops saving the files.  Turning this property on can quickly fill up a hard drive, but is invaluable for troubleshooting and tuning the application.

 

PROP_EX_LANGUAGE

Value Types:

PROP_EX_VALUE_TYPE_STRING

Targets:

PROP_EX_TARGET_PORT

Default Value: "AmericanEnglish"

The language model to use for decodes.

 

PROP_EX_SRE_SERVERS

Value Types:  PROP_EX_VALUE_TYPE_STRING
Targets:         PROP_EX_TARGET_CLIENT
Default Value: "127.0.0.1:5000"

The list of Speech Engine servers which will handle decodes for this client.  A comma (or semicolon) delimited list of IP addresses (and ports) the client will attempt to connect to. Use a colon to separate IPs and Ports.  5000 is the default port.

Example: "127.0.0.1;10.0.0.1:5001;10.10.0.1"  
Client will attempt to attach to the local machine, port 5000;  IP address "10.0.0.1" port 5001; and IP address "10.10.0.1" port 5000.

 

PROP_EX_SEARCH_BEAM_WIDTH

Value Types:

PROP_EX_VALUE_TYPE_FLOAT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 1e-6

The beam controls how thorough the Speech Engine search is.  Legal values can range from 0.0 to 1.0.  The smaller the value, the more thorough the search is, leading to potentially more accurate searches, but also leading to more time intensive searches.  Use the default at first, and only experiment with this value while tuning your application for speed and accuracy.  Make small changes only.  For instance, try going
from 1e-6 to 1e-9, but not 1e-30.

 

PROP_EX_CONCEPT_REPETITION_MIN

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_GRAMMAR

Default Value: 1

 

PROP_EX_CONCEPT_REPETITION_MAX

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_GRAMMAR

Default Value: -1 (infinity)

PROP_EX_CONCEPT_REPETITION_MIN and PROP_EX_CONCEPT_REPETITION_MAX control the repeat count of concepts in a concept/phrase grammar.  They have no effect on SRGS grammars.  Having a grammar such as:

concept "topping" = "pepperoni | olives | sausage | onions | peppers"

With  MIN=1 MAX=5, is equivalent to an SRGS grammar

root $toppings;
$toppings = $topping<1-5>;
$topping = (pepperoni | olives | sausage | onions | peppers);
 

PROP_EX_ENABLE_LATTICE_CONFIDENCE_SCORE

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 1

The lattice based confidence score is a slightly slower, but more accurate confidence score.   Set it to 0 to turn off the score.

 

PROP_EX_CHOOSE_MODEL

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

Default Value: 0

If this property is set to 1, then the client will decide which acoustic model is most appropriate for the server to use, based on a frequency analysis of the speaker's voice.  Otherwise, two decodes will be done simultaneously, and an answer will be selected based on which model had better "coverage" for the speaker's voice.

 

PROP_EX_MOD_SEL_LOW_THLD

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 135Hz

 

PROP_EX_MOD_SEL_HIGH_THLD

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 155Hz

When property PROP_EX_CHOOSE_MODEL is set to 1, the engine will use the pitch of input audio to determine which acoustic model to use. If the pitch is lower than PROP_EX_MOD_SEL_LOW_THLD, the low pitch model will be used, while a pitch higher than PROP_EX_MOD_SEL_HIGH_THLD indicates using high pitch model. Any value that falls in between will causes the engine to use both models.

 

PROP_EX_MAX_NBEST_RETURNED

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 1

The maximum number of n-best result the engine can return. This property is required to be an integer greater than or equal to 1.

 

PROP_EX_DECODE_TIMEOUT

Value Types:

PROP_EX_VALUE_TYPE_INT

 

PROP_EX_VALUE_TYPE_INT_PTR

Targets:

PROP_EX_TARGET_CLIENT

 

PROP_EX_TARGET_PORT

 

PROP_EX_TARGET_CHANNEL

Default Value: 1

The time out value used by LV_SRE_WaitForDecode and LVSpeechPort::WaitForDecode functions.

PROP_EX_LICENSE_TYPE

 

Value Types:                                    PROP_EX_VALUE_TYPE_STRING

 

Targets:                                            PROP_EX_TARGET_CLIENT

 

Default Value: Auto

The license type to use for opening a port.

 

Possible Values:

PROP_EX_LICENSE_VOXLITE

 

PROP_EX_LICENSE_SPEECHPORT