This can optionally be called to set the ID string used in call logging. This may be useful if advanced call identification is needed.
This is an optional, advanced function, which can be used to set the ID that will be associated with the call log file, if needed. Note that in most cases, users will not need to access this information directly, but this routine is provided for advanced functionality if desired. One such advanced use of setting this value would be to assign the MRCP or call session ID to files generated by ASR and TTS portions of a call. If the ID is not set using LV_TTS_SetCustomCallGuid, a default unique identifier will automatically be assigned.
To further clarify this advanced functionality, if a user assigned the same custom call_guid to both ASR and TTS portions of a call (one for the ASR port, and again for the TTS port associated with the call) then all ASR and TTS events would be logged to the same call log file, which may be convenient for tracking and analysis purposes.
One additional reason for calling this would be if there is some external reference identifier, associated with some external application or platform, this can be used to associate the call log file to that external reference in a convenient way.
- LV_TTS_RETURN_CODE LV_TTS_SetCustomCallGuid(HTTSCLIENT client_handle, const char * call_guid);
Handle to the active TTS client object.
Pointer to a valid string containing the custom guid to be used in call logging.
The specified TTS client handle is not a valid one.
The specified call_guid is not valid.
An exception occurred while processing the request.
If this function is not used, a globally unique id will be generated automatically.