Share via


SpeechRecognizer Profile Property (SAPI 5.3)

Microsoft Speech API 5.3

Interface: ISpeechRecognizer

Profile Property

The Profile property specifies the speech recognition engine's current recognition profile.

A recognition profile represents a single user and training sessions on the system. The user can manually create, delete, and set the current profile using Speech properties in Control Panel.

A profile should not be set while the engine is active. Doing so while a recognition engine is active can cause unexpected results, depending on how and when the speech recognition engine reads the profile information.

The newly-installed profile is not a permanent change but is valid only for the life span of the recognizer. To set it as the default, use SpObjectTokenCategory.Default.

Syntax

Set: SpeechRecognizer.Profile = SpObjectToken
Get: SpObjectToken = SpeechRecognizer.Profile

Parts

  • SpeechRecognizer
    The owning object.
  • SpObjectToken
    Set: An SpObjectToken variable that sets the profile. If no value is stated, the default of Nothing will be passed in.
    Get: An SpObjectToken variable that gets the current profile.

Example

See ISpeechRecognizer.GetProfilesfor a complete example.