This file controls settings related to the speech client. This configuration file controls the bulk of functionality for speech recognition options.
It is located by default in /etc/lumenvox/.
See Configuration Files for more information about other configuration files.
The following parameters can be set. The format to use within the configuration file is PROPERTY_NAME = VALUE
SRE_SERVERS
Description: This property sets which Speech Engine servers are used for processing decodes.
Possible Values: A list of IP addresses and optional ports separated by semicolons. For instance, 127.0.0.1;10.0.0.1:5721 specifies a server at 127.0.0.1 using the default port of 5730, and a server at 10.0.0.1 using the port 5721.
Default Value: 127.0.0.1
LICENSE_TYPE
Description: The license type to use when opening a port.
Possible Values: VoxLite, SpeechPort, or Auto.
If the value is set to VoxLite,
the client will get the license from the Lite license pool (these licenses only allow up to 500
vocabulary items per recognition). If the value is set to SpeechPort, the client
will get the license from the Full license pool. By default, the client will auto-pick the license;
it will use up Full licenses before using Lite licenses.
Default Value: Auto
LIC_SERVER_HOSTNAME
Description: The machine name hosting your license server(s) .
Possible Values: IP addresses separated by semicolons.
Default Value: 127.0.0.1
LIC_SERVER_PORTNUM
Description: The port number to use when contacting the license server.
Possible Values: A port number. If you have multiple IP addresses specified for LIC_SERVER_HOSTNAME, the PORTNUM values should also be separated by semicolons.
Default Value: 7569
MAX_NBEST_RETURNED
Description: Specifies the maximum number of n-best results to be returned by the Engine.
Possible Values: Number of n-best results.
Default Value: 1
DECODE_THREAD_PRIORITY
Description: Specifies the priority for the decode thread on the server. Higher priority threads will be processed before other applications on the same machine. Adjusting this parameter is useful for troubleshooting load issues on a machine.
Possible Values: 0 - 2
0 = Low Priority
1 = Normal Priority
2 = High
Priority
Default Value: 1
DECODE_TIMEOUT
Description: In a non-blocking decode, this is the timeout value, in milliseconds, used by LV_SRE_WaitForDecode and LVSpeechPort::WaitForDecode functions. In blocking decode, this is the time to wait until the decode times out and returns an error from LV_SRE_Decode and LVSpeechPort::Decode.
Possible Values: Time in milliseconds.
Default Value: 20000
LOAD_GRAMMAR_TIMEOUT
Description: Specifies how long, in milliseconds, the client should wait for a grammar to load. If the timeout is reached before the grammar is loaded, the LoadGrammar function returns error code -37, LV_LOAD_GRAMMAR_TIMEOUT.
Possible Values: Time in milliseconds.
Default Value: 200000
STRICT_SISR_COMPLIANCE
Description: Controls whether LumenVox will strictly implement the final SISR 1.0 standard for adding tags to grammars. Unless this value is changed, LumenVox normally runs in a backwards compatibility mode, using an older draft of SISR unless the grammar's tag-format is declared as semantics/1.0.2006. If strict compliance is enabled, then LumenVox will treat a tag-format declaration of semantics/1.0 using the newer standard.
Possible Values: 0 (disabled) or 1 (enabled)
Default Value: 0
TRIM_SILENCE_VALUE
Description: Controls how aggressively the Engine trims leading silence in incoming audio.
Possible Values: A number ranging from 0 (very aggressive) to 1000 (not aggressive).
Default Value: 970
SAVE_SOUND_FILES
Description: Controls whether the application will save off .callsre files used with the LumenVox Speech Tuner. Turn this on to capture audio and more information related to each decode. These files will be saved by default to /var/log/lumenvox/client/responses/. See additional info here.
Possible Values: 0 - 3
0 = NONE
1 = BASIC
2 = ADVANCED
3 = ALL
Default Value: 0
DECODE_OPTIMIZATION
Description: Sets whether the Engine should prioritize speed or accuracy while performing a decode. By default (with a avalue of 0), it will switch between modes depending on how much load is happening on the server machine; when the server becomes too busy it will begin optimizing speed over accuracy. The other two values force Speed over Accuracy, or vice versa.
Possible Values: 0 - 2
0 = Auto
1 = Speed
2 = Accuracy
Default Value: 0
NOISE_REDUCTION_ENABLE
Description: Specifies the Noise Reduction Model to be used by the Engine. These strip out background noise in audio being processed by the Engine. For most users the default noise reduction algorithm should work best. For certain noise coditions the Alternate noise reduction algorithm has shown better results. Hence, advanced users can try switching the algorithm to see if it improves their performance in noisy conditions. The Adaptive noise reduction algorithm works best only when the noise is constantly changing such as car or highway noise. For more stationary noises like fan noise, the default algorithm will show the best performance.
Possible Values: 0 - 3
0 = No Noise Reduction
1 = Default
2 = Alternate
3 = Adaptive
Default Value: 1
NOTE: The following two parameters are left out of the configuration file by default. They may be added in and used, but in most cases should not be touched.
LANGUAGE
Description: This is only used when you are using concept/phrase grammars and a language other than English. Using SRGS grammars, this value does nothing.
Possible Values: A string specifying the language name.
Default Value: (null)
SEARCH_BEAM_WIDTH
Description: Changes the size of the speech search beam.
Possible Values: A number between 0 and 1.
Default Value: 1e-6
If you wish to use License Authentication, you must add a new section to the client_property.conf file called [AUTHENTICATION] that appears at the bottom of the file.
This section must have two (and only two) key/value pairs:
AUTHENTICATION_USERNAME
Description: The username to be used by the client when requesting licenses from a License Server (there should be a corresponding entry in the license_authentication.conf file on the server side.
Possible Values: A string specifying the username.
Default Value: (null)
AUTHENTICATION_PASSWORD
Description: The passwod to be used by the client when requesting licenses from a License Server (there should be a corresponding entry in the license_authentication.conf file on the server side.
Possible Values: A string specifying the password.
Default Value: (null)
As an example, if your username is Alice and your password is alicespassword then you should have an [AUTHENTICATION] section that looks like:
[AUTHENTICATION]
AUTHENTICATION_USERNAME=alice
AUTHENTICATION_PASSWORD=alicespassword