112 lines
4.8 KiB
Plaintext
112 lines
4.8 KiB
Plaintext
Sample Speech Recognition Engine
|
|
|
|
Demonstrates
|
|
============
|
|
The sample speech recognition (SR) engine demonstrates the design, compilation,
|
|
installation, and testing for engines. This sample engine implements some
|
|
functionality of an SR engine and can be created and used in applications, but
|
|
it does not actually perform any recognition, instead it generates valid, but
|
|
random, results. This is very useful example code for understanding how a real
|
|
SR engine might be implemented. The following is basic information you should
|
|
know about this sample SR engine:
|
|
|
|
1. The sample engine provides a basic idea about how to develop an SR engine
|
|
to interact with SAPI.
|
|
2. The engine does not perform the recognition based on an acoustic or
|
|
language model. Instead, it retrieves the CFG information from SAPI and
|
|
constructs random results.
|
|
3. The sample engine does not pass the compliance tests.
|
|
4. If you experience unexpected results for the real SR activity, make sure
|
|
that the sample engine is not in use and that the sample engine has not
|
|
been set as the default engine.
|
|
|
|
Sample Language Implementations
|
|
===============================
|
|
This sample is available in C++.
|
|
|
|
Files
|
|
=====
|
|
SampleSrEngine.cpp Implementation of DLL Exports.
|
|
|
|
SampleSrEngine.idl This file will be processed by the MIDL tool to produce
|
|
the type library (SampleSrEngine.tlb) and marshalling
|
|
code.
|
|
|
|
stdafx.h Contains the standard system include files and project
|
|
specific include files that are used frequently, but are
|
|
changed infrequently.
|
|
|
|
stdafx.cpp Generates the precompiled header.
|
|
|
|
srengobj.h Contains the declaration of the CSrEngine class, which
|
|
is the main recognition object
|
|
|
|
srengobj.cpp Implementation of the CSrEngine class.
|
|
|
|
srengalt.h Contains the declaration of the CSrEngineAlternates
|
|
class which implements the interface ISpSRAlternates.
|
|
|
|
srengalt.cpp Implementation of the CSrEngineAlternates class.
|
|
|
|
srengext.h Contains the declaration of the CSampleSRExtension class
|
|
which implements the custom interface
|
|
ISampleSRExtension.
|
|
|
|
srengext.cpp Implementation of the CSampleSRExtension class.
|
|
|
|
srengui.h Contains the declaration of the CSrEngineUI class which
|
|
implements ISpTokenUI. This is used by applications to
|
|
display UI.
|
|
|
|
srengui.cpp Implementation of the CSrEngineUI class.
|
|
|
|
srengver.h Version information.
|
|
|
|
SampleSrEngine.def Export definition file.
|
|
|
|
SampleSrEngine.rgs Registration scripts.
|
|
srengalt.rgs
|
|
srengext.rgs
|
|
srengui.rgs
|
|
|
|
resource.h Microsoft Developer Studio generated include file. Used
|
|
by SampleSrEngine.rc.
|
|
|
|
SampleSrEngine.rc Resource scripts.
|
|
version.rc2
|
|
|
|
SampleSrEngine.sln Microsoft Visual Studio solution file.
|
|
|
|
SampleSrEngine.vcproj Visual C++ project file.
|
|
|
|
Readme.txt This file.
|
|
|
|
To build the sample using Visual Studio 2005 or Visual Studio 2008:
|
|
==================================================================
|
|
1. Open Windows Explorer and navigate to the directory.
|
|
2. On Windows 7 open Visual Studio 2005 (or VS 2008) as administrator by
|
|
right clicking the Visual Studio icon and selecting "Run as
|
|
administrator". Then open the solution file from the
|
|
"File -> Open ->Project/Solution" menu.
|
|
3. In the Build menu, select Build Solution. The sample engine will be built
|
|
in the "Debug" or "Release" directory for 32-bit platforms, "x64\Debug"
|
|
or "x64\Release" directory for 64-bit platforms. It will automatically
|
|
register itself in the Post-Build event.
|
|
|
|
To run the sample:
|
|
=================
|
|
There are various ways to see the sample engine running:
|
|
1. Use the reco.exe sample which allows you to experiment speech recognition
|
|
engines. Select the "SAPI Developer Sample Engine" to use this sample
|
|
engine. Or,
|
|
2. Programatically create and use this sample engine. Or,
|
|
3. On Windows 7, go to the "Control Panel -> Ease of Access -> Speech
|
|
Recognition Options -> Advanced Speech Options" and select the "SAPI
|
|
Developer Sample Engine" in the language section. Next time you start
|
|
Windows Speech Recognition it will use this sample engine which will take
|
|
random actions as you speak.
|
|
|
|
Note:
|
|
====
|
|
The Speech Recognition Engine sample utilizes the Microsoft Speech API (SAPI)
|
|
version 5.3 available on Windows Vista or later Operating System versions. |