Configuration file
The table below describe the VSDK 7 configuration file located at config/vsdk.json
:
Field | Description/Notes | Optional | Default Value | Type | Possible Values |
version | Version of the whole document | ✘ | String | 2.0 | |
csdk | ✘ | Object | |||
csdk/paths | ✔ | Object | |||
csdk/paths/cache | Absolute or relative to vsdk.json | ✔ | cache | Path | |
csdk/paths/data_root | Absolute or relative to vsdk.json | ✔ | . | Path | |
csdk/paths/acmod | Absolute or relative to data_root | ✔ | acmod | Path | |
csdk/paths/asr | Absolute or relative to data_root | ✔ | asr | Path | |
csdk/paths/clc | Absolute or relative to data_root | ✔ | clc | Path | |
csdk/paths/clc_ruleset | Absolute or relative to data_root | ✔ | clc | Path | |
csdk/paths/dictionary | Absolute or relative to data_root | ✔ | dictionaries | Path | |
csdk/paths/search | Absolute or relative to data_root | ✔ | ctx | Path | |
csdk/paths/sem3 | Absolute or relative to data_root | ✔ | ctx | Path | |
csdk/paths/users | Absolute or relative to data_root | ✔ | users | Path | |
csdk/paths/audio_based_classifier_model | Absolute or relative to data_root | ✔ | abc | Path | |
csdk/paths/confusion_dictionary | Absolute or relative to data_root | ✔ | dictionaries | Path | |
csdk/paths/language_model | Absolute or relative to data_root | ✔ | lm | Path | |
csdk/tts | ✘ | Object | |||
csdk/tts/channels | ✘ | Object | |||
csdk/tts/channels/<channel_name_1> | Name of the channel, used in code | ✘ | String | ||
csdk/tts/channels/<channel_name_1>/voices | ✘ | Array | |||
csdk/tts/channels/<channel_name_1>/voices/0 | ✘ | String | <speaker>,<lang>,<quality> | ||
csdk/asr | ✘ | Object | |||
csdk/asr/recognizers | ✘ | Object | |||
csdk/asr/recognizers/<recognizer_name_1> | Name of the recognizer, used in code | ✘ | String | ||
csdk/asr/recognizers/<recognizer_name_1>/acmods | Recognizers accept multiple acoustic models | ✘ | Array | ||
csdk/asr/recognizers/<recognizer_name_1>/acmods/0 | ✘ | String | |||
csdk/asr/models | ✘ | Object | |||
csdk/asr/models/<model_name_1> | Name of the model, used in code | ✘ | String | ||
csdk/asr/models/<model_name_1>/type | ✘ | String | static, dynamic, | ||
csdk/asr/models/<model_name_1>/file | Compiled model file name, extension is .fcf | ✘ | File | ||
csdk/asr/models/<model_name_1>/sem3 | Compiled semantic model file name, extension is .s3c | ✔ | "" | String | |
csdk/asr/models/<model_name_1>/settings | ✔ | Object | |||
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_STREAM_RESULT_MODE | The mode in which intermediate results are displayed during recognition. 1 means partial result are activated | ✔ | 0 | Int | 0, 1 |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_ACCURACY | Trade-off between CPU- load, memory requirements and the obtained accuracy of the search | ✔ | 10000 | Int | [100 ; 50000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_MAXNBEST | Maximum number of hypotheses returned in a result | ✔ | 3 | Int | [1 ; 1000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_TSILENCE | Minimum amount of trailing silence, in milliseconds. Use a higher value for non- WUW models | ✔ | 100 | Int | [100 ; 10000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_IG_LOWCONF | Maximum amount of confidence level that indicates that a spoken utterance is out of grammar | ✔ | 5000 | Int | [0 ; 10000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_IG_HIGHCONF | Minimum amount of confidence level that indicates that a spoken utterance is in grammar | ✔ | 5000 | Int | [0 ; 10000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_INITBEAMWIDTH | Init beam width. This parameter affects low- level behavior of the algorithm | ✔ | 2500 | Int | [0 ; 10000] |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_TANYSPEECH | Allows the recognizer to stop the recognition process during the trailing AnySpeech state | ✔ | LH_FALSE | String | LH_TRUE, LH_FALSE |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_NBESTRESULT_SETHIDDENKEYS | When enabled additional information is included on the ASR result that can be used for the FM use case | ✔ | LH_FALSE | String | LH_TRUE, LH_FALSE |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_ONDEMANDLOADING | Context on-demand loading | ✔ | LH_FALSE | Int | LH_TRUE, LH_FALSE |
csdk/asr/models/<model_name_1>/settings/LH_SEARCH_PARAM_SPEECH_TIMEOUT | Speech duration timeout in milliseconds | ✔ | 0 | Int | 0, [100 ; 60000] |
csdk/asr/models/<model_name_1>/acmod | ∗Only for dynamic models. Must match with the one configured on the recognizer that will apply this model | ✘∗ | String | ||
csdk/asr/models/<model_name_1>/slots | ∗Only for dynamic models. | ✘∗ | Object | ||
csdk/asr/models/<model_name_1>/slots/<slot_name_1> | Name of the slot, used in the code | ✘ | Object | ||
csdk/asr/models/<model_name_1>/slots/<slot_name_1>/slot | Grammar name is marked after !grammar and slot name is after !slot in your BNF grammar | ✘ | String | <grammar-name>#<slot-name> | |
csdk/asr/models/<model_name_1>/slots/<slot_name_1>/category | ✔ | normal | String | normal, name, artist | |
csdk/asr/models/<model_name_1>/slots/<slot_name_1>/allow_custom_phonetic | Setting to true will allow for custom phonetic to be provided for this slot | ✔ | false | Bool | |
csdk/asr/models/<model_name_1>/lexicon | ∗Only for dynamic models. | ✘∗ | String | ||
csdk/asr/models/<model_name_1>/lexicon/clc | Used during runtime compilation. Use a language that match the rest of the grammar and the recognizer this model will be applied on | ✘ | File | ||
csdk/asr/models/<model_name_1>/lexicon/settings | ✔ | Object | |||
csdk/asr/models/<model_name_1>/extra_models | ∗Only for free-speech models. All models for a given language must be listed or the program won't function properly | ✘∗ | Object | ||
csdk/asr/models/<model_name_1>/extra_models/<name> | ✘ | File | |||
tnl | ✘ | Object | |||
tnl/paths | ✔ | Object | |||
tnl/paths/cache | Absolute or relative to vsdk.json | ✔ | cache | Path | |
tnl/paths/models | Absolute or relative to vsdk.json | ✔ | . | Path | |
tnl/asr | ✘ | Object | |||
tnl/asr/recognizers | ✘ | String | |||
tnl/asr/recognizers/<recognizer_name_1> | Name of the recognizer, used in the code | ✘ | String | ||
tnl/asr/recognizers/<recognizer_name_1>/audio_buffer_size_seconds | In seconds, so multiply by 16000 to get the actual memory space allocated | ✔ | 10 | Int | > 0 |
tnl/asr/models | ✘ | Object | |||
tnl/asr/models/<model_name_1> | Name of the model, used in the code | ✘ | Object | ||
tnl/asr/models/<model_name_1>/type | ✘ | String | static, dynamic | ||
tnl/asr/models/<model_name_1>/file | Compiled model file name, extension is .snsr | ✘ | File | ||
tnl/asr/models/<model_name_1>/slots | ∗Only for dynamic models | ✘∗ | Object | ||
tnl/asr/models/<model_name_1>/slots/<slot_name_1> | Name of the slot, used in the code | ✘ | Object | ||
tnl/asr/concurrent_model | ∗Only needed if you want to call File name of a concurrent template model, extension is | ✔∗ | File | ||
vasr | ✘ | Object | |||
vasr/paths | ✔ | Object | |||
vasr/paths/data_root | Absolute or relative to vsdk.json | ✔ | . | Path | |
vasr/paths/acmod | Absolute or relative to data_root | ✔ | acmod | Path | |
vasr/paths/graph | Absolute or relative to data_root | ✔ | graph | Path | |
vasr/log | ✔ | Object | |||
vasr/log/<logger_name> | ✔ | Object | *, perf | ||
vasr/log/<logger_name>/level | Level of the debugging information printed | ✔ | String | info, debug | |
vasr/asr | ✘ | Object | |||
vasr/asr/recognizers | ✘ | Object | |||
vasr/asr/recognizers/<recognizer_name_1> | Name of the recognizer, used in the code | ✘ | Object | ||
vasr/asr/recognizers/<recognizer_name_1>/acmods | Array containing all acmods used | ✘ | Array | ||
vasr/asr/recognizers/<recognizer_name_1>/acmods/0 | Acmod file name | ✘ | String | ||
vasr/asr/recognizers/<recognizer_name_1>/settings | Object containing optional settings | ✔ | Object | ||
vasr/asr/recognizers/<recognizer_name_1>/settings/<settings_1> | Optionnal setting | ✔ | Object | ||
vasr/asr/models | ✘ | Object | |||
vasr/asr/models/<model_name_1> | Name of the model, used in the code | ✘ | String | ||
vasr/asr/models/<model_name_1>/type | ✘ | String | static, dynamic, | ||
vasr/asr/models/<model_name_1>/file | Absolute or relative to paths/models | ✘ | Path | ||
vasr/asr/models/<model_name_1>/recognizer | ∗Only for dynamic models. Absolute or relative to recognizer | ✘∗ | File | ||
vasr/asr/models/<model_name_1>/slots | ∗Only for dynamic models. | ✘∗ | Array | ||
vasr/asr/models/<model_name_1>/slots/<slot_name_1> | Name of the slot, used in the code | ✘ | String | ||
baratinoo | ✘ | Object | |||
baratinoo/paths | ✔ | Object | |||
baratinoo/paths/data_root | Absolute or relative to vsdk.json | ✔ | Path | ||
baratinoo/tts | ✘ | Object | |||
baratinoo/tts/channels | ✘ | Object | |||
baratinoo/tts/channels/<channel_name_1> | ✘ | Object | |||
baratinoo/tts/channels/<channel_name_1>/voices | ✘ | Array | |||
baratinoo/tts/channels/<channel_name_1>/voices/0 | ✘ | String | <speaker> | ||
vtapi | ✘ | Object | |||
vtapi/paths | ✔ | Object | |||
vtapi/paths/data_root | Absolute or relative to vsdk.json | ✔ | Path | ||
vtapi/tts | ✘ | Object | |||
vtapi/tts/channels | ✘ | Object | |||
vtapi/tts/channels/<channel_name_1> | ✘ | Object | |||
vtapi/tts/channels/<channel_name_1>/voices | ✘ | Array | |||
vtapi/tts/channels/<channel_name_1>/voices/0 | ✘ | String | <speaker>,<quality> | ||
tssv | ✘ | Object | |||
tssv/biometrics | ✘ | Object | |||
tssv/biometrics/generated_models_path | Absolute or relative to the program's working directory | ✘ | Path | ||
tssv/biometrics/background_model_TD | Absolute or relative to the program's working directory | ✘ | File | ||
tssv/biometrics/background_model_TI | Absolute or relative to the program's working directory | ✘ | File | ||
idvoice | ✘ | Object | |||
idvoice/biometrics | ✘ | Object | |||
idvoice/biometrics/generated_models_path | Absolute or relative to the program's working directory | ✘ | Path | ||
idvoice/biometrics/background_model_TD | Absolute or relative to the program's working directory | ✘ | File | ||
idvoice/biometrics/background_model_TI | Absolute or relative to the program's working directory | ✘ | File | ||
vafe | ✘ | Object | |||
vafe/afe | ✘ | Object | |||
vafe/afe/analyzers | ✘ | Object | |||
vafe/afe/analyzers/<name_1> | ✘ | Object | |||
vafe/afe/analyzers/<name_1>/type | ✘ | String | snr, rt60, mos | ||
vafe/afe/analyzers/<name_1>/bitspersample | ∗Only for rt60 analyzers. | ✘∗ | Int | Power of 2, [16 ; 1024] | |
vafe/afe/analyzers/<name_1>/model | ∗Only for mos analyzers. Absolute path to the mos configuration file, extension is .json | ✘∗ | Path | ||
vafe/afe/filters | ✘ | Object | |||
vafe/afe/filters/<name_1> | ✘ | Object | |||
vafe/afe/filters/<name_1>/type | ✘ | String | bandpass, lowpass, highpass | ||
vafe/afe/filters/<name_1>/lowfrequency | ∗Only for bandpass filters. | ✘∗ | Int | [1 ; 16000] | |
vafe/afe/filters/<name_1>/highfrequency | ∗Only for bandpass filters. | ✘∗ | Int | [1 ; 16000] | |
vafe/afe/filters/<name_1>/frequency | ∗Only for lowpass and highpass filters. | ✘∗ | Int | [1 ; 16000] |