Browse
 
Tools
Rss Categories

LVTTSClient::SetCustomCallGuid

Reference Number: AA-01043 Views: 9314 0 Rating/ Voters

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 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.

Function

  • LV_TTS_RETURN_CODE SetCustomCallGuid(const char* call_guid)

Parameters

call_guid

Pointer to a valid string containing the custom guid to be used in call logging.

Return Values

LV_SUCCESS

No errors.

LV_INVALID_TTS_HANDLE

The TTS client handle is invalid (either Initialize has not been called or Destroy has already been called).

LV_INVALID_API_PARAMETER

The specified call_guid is not valid.

LV_EXCEPTION

An exception occurred while processing the request.

Remarks

If this method is not used, a globally unique id will be generated automatically.