Browse
 
Tools
Rss Categories

LumenVox API Log

Reference Number: AA-01765 Views: 8079 0 Rating/ Voters

The LVSpeechPortAPILog.txt file is advanced log that contains every call made into the LumenVox API. With full verbosity, it also includes the returns from those functions (0 or greater indicates success; a negative number indicates a failure). It makes it invaluable for troubleshooting applications built using the LumenVox C or C++ API, and because the LumenVox Media Server uses this API, it is also useful when dealing with the Media Server.

However, because the LumenVox API is quite extensive, knowledge of that API will be helpful in reading the log (for more information, you can see the Introduction to the SpeechPort API document).

But even users who do not know every detail of the API can find this log useful. Here is a basic recognition sequence through the Media Server:

12/18/2012 12:12:12,983,0,LV_SRE_Startup
12/18/2012 12:12:15,020,0,LV_SRE_GetIntProperty(HPORT 0, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_CLIENT, int * 0x00000000025A6DF0)
12/18/2012 12:12:15,020,0,LV_SRE_GetIntProperty(HPORT 0, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_CLIENT, int * 0x00000000025A6DF0 -> 0): returned 0 (Success)
12/18/2012 12:12:15,020,0,LV_SRE_CreateClient(int* 0x00000000025A6C00 -> -29, ExportLogMsg 000000000DDBF0E8, void* 0x00000000025A6AC0, int 0)
12/18/2012 12:12:15,024,0,LV_SRE_CreateClient(int* 0x00000000025A6C00 -> 0, ExportLogMsg 000000000DDBF0E8, void* 0x00000000025A6AC0, int 0): returned HPORT identifier 11: returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_SetPropertyEx(HPORT 11, PROP_EX_SAVE_SOUND_FILES, PROP_EX_VALUE_TYPE_INT, void* 0x0000000000000000 -> SAVE_SOUND_FILES_NONE, PROP_EX_TARGET_PORT): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_SetPropertyEx(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_VALUE_TYPE_INT, void* 0x0000000000000000 -> OFF, PROP_EX_TARGET_PORT): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_SetCustomCallGuid(HPORT 11, const char* E7BD586EF438A454BCF8)
12/18/2012 12:12:15,024,0,LV_SRE_SetCustomCallGuid(HPORT 11, const char* E7BD586EF438A454BCF8): returned -1 (Speech Port not Opened)
12/18/2012 12:12:15,024,0,LV_SRE_AddEventEx(HPORT 11, const char* START_DECODE_SEQ, const char* (null))
12/18/2012 12:12:15,024,0,LV_SRE_AddEventEx(HPORT 11, const char* START_DECODE_SEQ, const char* (null)): returned -46 (Invalid SRE event.)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetStateChangeCallBack(HPORT 11, LV_SRE_StreamStateChangeFn* 0000000140047980, void* 0x00000000025A6AC0)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetStateChangeCallBack(HPORT 11, LV_SRE_StreamStateChangeFn* 0x0000000140047980, void* 0x00000000025A6AC0): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_SetPropertyEx(HPORT 11, PROP_EX_MAX_NBEST_RETURNED, PROP_EX_VALUE_TYPE_INT, void* 0x0000000000000001 -> 1, PROP_EX_TARGET_PORT): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_DETECT_BARGE_IN, unsigned int 1)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_DETECT_BARGE_IN, unsigned int 1): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_DETECT_END_OF_SPEECH, unsigned int 1)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_DETECT_END_OF_SPEECH, unsigned int 1): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VOICE_CHANNEL, unsigned int 1)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VOICE_CHANNEL, unsigned int 1): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_GRAMMAR_SET, unsigned int -1)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_GRAMMAR_SET, unsigned int -1): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_AUTO_DECODE, unsigned int 0)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_AUTO_DECODE, unsigned int 0): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_EOS_DELAY, unsigned int 800)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_EOS_DELAY, unsigned int 800): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_WIND_BACK, unsigned int 480)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_WIND_BACK, unsigned int 480): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_BARGE_IN_TIMEOUT, unsigned int 15000)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_BARGE_IN_TIMEOUT, unsigned int 15000): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_END_OF_SPEECH_TIMEOUT, unsigned int 20000)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_END_OF_SPEECH_TIMEOUT, unsigned int 20000): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_VOLUME_SENSITIVITY, unsigned int 50)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_VOLUME_SENSITIVITY, unsigned int 50): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_SNR_SENSITIVITY, unsigned int 50)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_SNR_SENSITIVITY, unsigned int 50): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_STREAM_INIT_DELAY, unsigned int 100)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_STREAM_INIT_DELAY, unsigned int 100): returned 0 (Success)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_BARGEIN_THRESHOLD, unsigned int 50)
12/18/2012 12:12:15,024,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_BARGEIN_THRESHOLD, unsigned int 50): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_StreamStartListening(HPORT 11)
12/18/2012 12:12:15,026,0,LV_SRE_StreamStartListening(HPORT 11): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_EOS_DELAY, unsigned int 800)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_EOS_DELAY, unsigned int 800): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_VOLUME_SENSITIVITY, unsigned int 50)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_VAD_VOLUME_SENSITIVITY, unsigned int 50): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_SetPropertyEx(HPORT 11, PROP_EX_SPEED_VS_ACCURACY, PROP_EX_VALUE_TYPE_INT, void* 0x0000000000000032 -> 50, PROP_EX_TARGET_PORT): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_BARGE_IN_TIMEOUT, unsigned int -1)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_BARGE_IN_TIMEOUT, unsigned int -1): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_SetPropertyEx(HPORT 11, PROP_EX_MAX_NBEST_RETURNED, PROP_EX_VALUE_TYPE_INT, void* 0x0000000000000001 -> 1, PROP_EX_TARGET_PORT): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_SOUND_FORMAT, unsigned int 1)
12/18/2012 12:12:15,026,0,LV_SRE_StreamSetParameter(HPORT 11, const char* STREAM_PARM_SOUND_FORMAT, unsigned int 1): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBEDC0)
12/18/2012 12:12:15,026,0,LV_SRE_DeactivateGrammars(HPORT 11)
12/18/2012 12:12:15,026,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBEDC0 -> 0): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_DeactivateGrammars(HPORT 11): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_RegisterGrammarForPendingStream(HPORT 11, const char* builtin:grammar/digits)
12/18/2012 12:12:15,026,0,LV_SRE_RegisterGrammarForPendingStream(HPORT 11, const char* builtin:grammar/digits): returned 0 (Success)
12/18/2012 12:12:15,026,0,LV_SRE_LoadGrammarWithParameters(HPORT 11, const char* , const char* )
12/18/2012 12:12:15,028,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160)
12/18/2012 12:12:15,028,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160): returned 0 (Success)
12/18/2012 12:12:15,029,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160)
12/18/2012 12:12:15,029,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160): returned 0 (Success)
12/18/2012 12:12:15,029,0,LV_SRE_LoadGrammarWithParameters(HPORT 11, const char* , const char* ): returned 0 (Success)
12/18/2012 12:12:15,029,0,LV_SRE_ActivateGrammar(HPORT 11, const char* builtin:grammar/digits)
12/18/2012 12:12:15,030,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160)
12/18/2012 12:12:15,030,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160): returned 0 (Success)
12/18/2012 12:12:15,030,0,LV_SRE_ActivateGrammar(HPORT 11, const char* builtin:grammar/digits): returned 0 (Success)
12/18/2012 12:12:15,031,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160)
12/18/2012 12:12:15,031,0,LV_SRE_StreamSendData(HPORT 11, void* 0x000000000A6F8EBC, int 160): returned 0 (Success)
12/18/2012 12:12:19,224,0,LV_SRE_Decode(HPORT 11, int 1, int -1, unsigned int 512)
12/18/2012 12:12:19,225,0,LV_SRE_Decode(HPORT 11, int 1, int -1, unsigned int 512): returned 0 (Success)
12/18/2012 12:12:19,225,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_DECODE_TIMEOUT, PROP_EX_TARGET_PORT, int * 0x000000000E5BF7A0)
12/18/2012 12:12:19,225,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_DECODE_TIMEOUT, PROP_EX_TARGET_PORT, int * 0x000000000E5BF7A0 -> 20000): returned 0 (Success)
12/18/2012 12:12:19,264,0,LV_SRE_WaitForEngineToIdle(HPORT 11, int 1, int 1)
12/18/2012 12:12:19,683,0,LV_SRE_WaitForEngineToIdle(HPORT 11, int 1, int 1): returned 0 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetLastDecodeError(HPORT 11, int 1)
12/18/2012 12:12:19,683,0,LV_SRE_GetLastDecodeError(HPORT 11, int 1): returned 0 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetNumberOfNBestAlternatives(HPORT 11, int 1)
12/18/2012 12:12:19,683,0,LV_SRE_GetNumberOfNBestAlternatives(HPORT 11, int 1): returned 1 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_SwitchToNBestAlternative(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_SwitchToNBestAlternative(HPORT 11, int 1, int 0): returned 0 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetNumberOfInterpretations(HPORT 11, int 1)
12/18/2012 12:12:19,683,0,LV_SRE_GetNumberOfInterpretations(HPORT 11, int 1): returned 1 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_CreateInterpretation(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationInputString(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationInputString(HPORT 11, int 1, int 0): returned a string
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationString(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationString(HPORT 11, int 1, int 0): returned a string
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationMode(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationMode(HPORT 11, int 1, int 0): returned voice
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationGrammarLabel(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationGrammarLabel(HPORT 11, int 1, int 0): returned builtin:grammar/digits
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationScore(HPORT 11, int 1, int 0)
12/18/2012 12:12:19,683,0,LV_SRE_GetInterpretationScore(HPORT 11, int 1, int 0): returned 893 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetLastDecodeError(HPORT 11, int 1)
12/18/2012 12:12:19,683,0,LV_SRE_GetLastDecodeError(HPORT 11, int 1): returned 0 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBF320)
12/18/2012 12:12:19,683,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBF320 -> 0): returned 0 (Success)
12/18/2012 12:12:19,683,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBF010)
12/18/2012 12:12:19,683,0,LV_SRE_GetIntProperty(HPORT 11, PROP_EX_SECURE_CONTEXT, PROP_EX_TARGET_PORT, int * 0x000000000DDBF010 -> 0): returned 0 (Success)
12/18/2012 12:12:19,753,0,LV_SRE_StreamSetStateChangeCallBack(HPORT 11, LV_SRE_StreamStateChangeFn* 0000000000000000, void* 0x0000000000000000)
12/18/2012 12:12:19,753,0,LV_SRE_StreamSetStateChangeCallBack(HPORT 11, LV_SRE_StreamStateChangeFn* 0x0000000000000000, void* 0x0000000000000000): returned 0 (Success)
12/18/2012 12:12:19,753,0,LV_SRE_AddEventEx(HPORT 11, const char* END_DECODE_SEQ, const char* (null))
12/18/2012 12:12:19,753,0,LV_SRE_AddEventEx(HPORT 11, const char* END_DECODE_SEQ, const char* (null)): returned -46 (Invalid SRE event.)
12/18/2012 12:12:19,753,0,LV_SRE_DestroyClient(HPORT 11)
12/18/2012 12:12:19,753,0,LV_SRE_DestroyClient(HPORT 11): returned 0 (Success)

As you can see, it is a lot of information, but the basics are pretty easy to follow. First, the Media Server calls the Startup function, and then checks the status of some properties of values set in the configuration files using the GetIntProperty function call. Then the connection between client and server is established with CreateClient and a number of properties are set. The audio begins streaming with StreamStartListening, and then a speech Decode takes places. There is some work to get the answers and interpretations from the ASR, and ultimately everything is cleaned up.

If you compare this log to the client_asr.txt log file, you can see that in some ways the LVSpeechPortAPILog.txt file is an expanded version of client_asr.txt. The LVSpeechPortAPILog.txt is a more advanced log file in some ways, but the level of detail can be useful when troubleshooting particularly difficult or obscure problems.