Microphone Setup dialog not working for SAPI 4

Last reviewed: 2/12/2003

PRB Article ID: P020302

The information in this article applies to:

  • SpeechKit 4

Symptoms

ShowDialog CDMicTraining does not display the SAPI 4 Microphone Setup wizard

Cause

A SAPI 4 compliant recognizer may or may not support any of the ISRDialogs interface dialogs. The ISRDialogs TrainMicDlg is not supported and the cause of the return code.

SAPI 4 does provide an alternate interface ISTMICWIZARD for invoking the Microphone Setup Wizard. This is supported in SpeechKit 3 via the SetupMicrophone method.

Status

Enhancement in SpeechKit 4 build 4.0.70.0.

The SpeechKit SAPI 4 component interface now invokes ISRDialogs TrainMicDlg if supported and invokes the ISTMICWIZARD if not.

In addition, the Application Framework was enhanced to support a Microphone setup facility to enable applications to optionally prompt end users to train their microphone.

ChantStringProperty Constant Value Description
CSPMicrophone 11 Identifies the name of the microphone. Used to automatically invoke the recognizer’s microphone setup wizard when the application initially connects with the recognizer.
CSPMicrophoneHasRunMicWizard 12 Indicates the microphone wizard has been run previously. Valid values are TRUE or FALSE. Indicates the text message to use when prompting the user whether or not to run the microphone setup wizard.
CSPMicrophonePrompt 13 Indicates the text message to use when prompting the user whether or not to run the microphone setup wizard.
CSPMicrophoneSetupOption 14 Indicates one of the following microphone setup options:
Option Description
ReturnIfRun Do not run if the microphone setup has run previously (e.g., CSPMicrophoneHasRunMicWizard = "TRUE").
PromptIfRun Prompt the user to run if the microphone setup has run previously (e.g., CSPMicrophoneHasRunMicWizard = "TRUE") else if not (e.g., CSPMicrophoneHasRunMicWizard = "FALSE") run.
AlwaysRun Always run the microphone setup wizard.
CSPMicrophoneTitle 15 Indicates the text title to use when prompting the user whether or not to run the microphone setup wizard.

Because of new ChantStringProperty constants, you may need to do the following:

  • Copy new VCL libraries to DelphiX\lib and updated CDLL to Delphi\bin directory;
  • Compiled languages (e.g., C/C++, C#, Java, Pascal (Delphi), Visual Basic) applications must be recompiled;
  • web sites that use the javascript or vbscript include files must uploade replace these with the updated files; and
  • ActiveX applications (e.g., Director, Flash, FoxPro, PowerBuilder) than may have copied constant declarations, need to update these definitions and recompile.

Component Formats Impacted

All formats.