SpeechRecognitionEngine Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
İşlem içi konuşma tanıma altyapısına erişme ve yönetme araçlarını sağlar.
public ref class SpeechRecognitionEngine : IDisposable
public class SpeechRecognitionEngine : IDisposable
type SpeechRecognitionEngine = class
interface IDisposable
Public Class SpeechRecognitionEngine
Implements IDisposable
- Devralma
-
SpeechRecognitionEngine
- Uygulamalar
Örnekler
Aşağıdaki örnek, temel konuşma tanımayı gösteren bir konsol uygulamasının bir parçasını gösterir. Bu örnek, Multiple
yönteminin modunu kullandığından RecognizeAsync , konsol penceresini kapatıncaya veya hata ayıklamayı durdurana kadar tanıma işlemini gerçekleştirir.
using System;
using System.Speech.Recognition;
namespace SpeechRecognitionApp
{
class Program
{
static void Main(string[] args)
{
// Create an in-process speech recognizer for the en-US locale.
using (
SpeechRecognitionEngine recognizer =
new SpeechRecognitionEngine(
new System.Globalization.CultureInfo("en-US")))
{
// Create and load a dictation grammar.
recognizer.LoadGrammar(new DictationGrammar());
// Add a handler for the speech recognized event.
recognizer.SpeechRecognized +=
new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);
// Configure input to the speech recognizer.
recognizer.SetInputToDefaultAudioDevice();
// Start asynchronous, continuous speech recognition.
recognizer.RecognizeAsync(RecognizeMode.Multiple);
// Keep the console window open.
while (true)
{
Console.ReadLine();
}
}
}
// Handle the SpeechRecognized event.
static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
{
Console.WriteLine("Recognized text: " + e.Result.Text);
}
}
}
Açıklamalar
Bu sınıfın bir örneğini, yüklü konuşma tanıyıcılarının herhangi biri için oluşturabilirsiniz. Hangi tanıyıcıların yüklendiği hakkında bilgi almak için statik InstalledRecognizers yöntemi kullanın.
Bu sınıf, işlem içi konuşma tanıma altyapılarını çalıştırmak içindir ve konuşma tanımanın çeşitli yönleri üzerinde aşağıdaki gibi denetim sağlar:
İşlem içi konuşma tanıyıcı oluşturmak için SpeechRecognitionEngine oluşturuculardan birini kullanın.
Konuşma tanıma dilmars 'ı yönetmek için,, LoadGrammar , LoadGrammarAsync UnloadGrammar ve UnloadAllGrammars yöntemlerini ve Grammars özelliğini kullanın.
Girişi tanıyıcı için yapılandırmak üzere,,, SetInputToAudioStream SetInputToDefaultAudioDevice SetInputToNull SetInputToWaveFile veya SetInputToWaveStream yöntemini kullanın.
Konuşma tanımayı gerçekleştirmek için Recognize veya RecognizeAsync yöntemini kullanın.
Tanımanın sessizlik veya beklenmedik girişi nasıl işlediğini değiştirmek için,,, BabbleTimeout InitialSilenceTimeout EndSilenceTimeout ve EndSilenceTimeoutAmbiguous özelliklerini kullanın.
Tanıyıcıın döndürdüğü alternatifleri sayısını değiştirmek için MaxAlternates özelliğini kullanın. Tanıyıcı bir nesne içindeki tanıma sonuçlarını döndürür RecognitionResult .
Tanıyıcıda yapılan değişiklikleri eşleştirmek için RequestRecognizerUpdate yöntemini kullanın. Tanıyıcı, görevleri gerçekleştirmek için birden fazla iş parçacığı kullanır.
Girişi tanıyıcıya öykünmek için EmulateRecognize ve EmulateRecognizeAsync yöntemlerini kullanın.
SpeechRecognitionEngineNesnesi, nesneyi örneklendirilmiş işlemin tek kullanımı içindir. Bunun aksine, SpeechRecognizer tek bir tanıyıcıyı kullanmak isteyen herhangi bir uygulamayla paylaşır.
Not
DisposeKonuşma tanıyıcıya son başvurınızı bırakmadan önce her zaman çağırın. Aksi takdirde, kullandığı kaynaklar çöp toplayıcı tanıyıcı nesnesinin yöntemini çağırana kadar serbest bırakılır Finalize
.
Oluşturucular
SpeechRecognitionEngine() |
SpeechRecognitionEngineSistemin varsayılan konuşma tanıyıcıyı kullanarak sınıfının yeni bir örneğini başlatır. |
SpeechRecognitionEngine(CultureInfo) |
SpeechRecognitionEngineBelirtilen bir yerel ayar için varsayılan konuşma tanıyıcıyı kullanarak sınıfının yeni bir örneğini başlatır. |
SpeechRecognitionEngine(RecognizerInfo) |
SpeechRecognitionEngineKullanılacak tanıyıcıyı belirtmek için bir nesnesindeki bilgileri kullanarak yeni bir örneğini başlatır RecognizerInfo . |
SpeechRecognitionEngine(String) |
SpeechRecognitionEngineKullanılacak tanıyıcı adını belirten bir String parametresi ile sınıfının yeni bir örneğini başlatır. |
Özellikler
AudioFormat |
Tarafından alınan sesin biçimini alır SpeechRecognitionEngine . |
AudioLevel |
Tarafından alınan sesin düzeyini alır SpeechRecognitionEngine . |
AudioPosition |
Üzerinde giriş sağlayan cihaz tarafından oluşturulan ses akışındaki geçerli konumu alır SpeechRecognitionEngine . |
AudioState |
Tarafından alınan sesin durumunu alır SpeechRecognitionEngine . |
BabbleTimeout |
SpeechRecognitionEngineTanımayı sonuçlandırmadan önce yalnızca arka plan gürültüsünü içeren girişi kabul eden zaman aralığını alır veya ayarlar. |
EndSilenceTimeout |
SpeechRecognitionEngineBir tanıma işlemini sonuçlandırmadan önce, belirsiz girişin sonunda kabul edeceği sessizlik aralığını alır veya ayarlar. |
EndSilenceTimeoutAmbiguous |
SpeechRecognitionEngineBir tanıma işlemini sonuçlandırmadan önce belirsiz girişin sonunda kabul edeceği sessizlik aralığını alır veya ayarlar. |
Grammars |
GrammarBu örneğe yüklenen nesnelerin bir koleksiyonunu alır SpeechRecognitionEngine . |
InitialSilenceTimeout |
SpeechRecognitionEngineTanımayı sonuçlandırmadan önce yalnızca sessizlik içeren girişi kabul eden zaman aralığını alır veya ayarlar. |
MaxAlternates |
SpeechRecognitionEngineHer bir tanıma işlemi için döndürdüğü diğer tanıma sonuçlarının maksimum sayısını alır veya ayarlar. |
RecognizerAudioPosition |
SpeechRecognitionEngineİşlem yaptığı ses girişinde öğesinin geçerli konumunu alır. |
RecognizerInfo |
Geçerli örneği hakkında bilgi alır SpeechRecognitionEngine . |
Yöntemler
Dispose() |
SpeechRecognitionEngineNesneyi bırakır. |
Dispose(Boolean) |
, SpeechRecognitionEngine Oturum sırasında kullanılan nesneyi ve serbest bırakma kaynaklarını ortadan kaldırdık. |
EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
, Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak konuşma tanıyıcıya belirli sözcüklerin girişini taklit eder ve tanıyıcı, sözcükler ile yüklenen konuşma tanıma dilbilgisinde Unicode karşılaştırmayı nasıl işleyeceğini belirtir. |
EmulateRecognize(String) |
, Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak konuşma tanıyıcısına bir tümcecik girişi öykünür. |
EmulateRecognize(String, CompareOptions) |
, Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak konuşma tanıyıcısına bir tümcecik girişini taklit eder ve tanıyıcı ile yüklenen konuşma tanıma dilbilgisinde Unicode karşılaştırmayı nasıl işleyeceğini belirtir. |
EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) |
, Zaman uyumsuz konuşma tanıma için ses yerine bir dizi nesne kullanarak konuşma tanıyıcıya belirli sözcüklerin girişini taklit eder RecognizedWordUnit ve tanıyıcı, sözcükler ile yüklenen konuşma tanıma dilbilgisinde Unicode karşılaştırmayı nasıl işleyeceğini belirtir. |
EmulateRecognizeAsync(String) |
Zaman uyumsuz konuşma tanıma için ses yerine metin kullanarak konuşma tanıyıcısına bir tümcecik girişi öykünür. |
EmulateRecognizeAsync(String, CompareOptions) |
Zaman uyumsuz konuşma tanıma için ses yerine metin kullanarak konuşma tanıyıcısına bir tümcecik girişini taklit eder ve tanıyıcı ile yüklenen konuşma tanıma dilbilgisinde Unicode karşılaştırmayı nasıl işleyeceğini belirtir. |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
InstalledRecognizers() |
Geçerli sistemdeki tüm yüklü konuşma tanıyıcılarının bilgilerini döndürür. |
LoadGrammar(Grammar) |
Zaman uyumlu olarak bir Grammar nesne yükler. |
LoadGrammarAsync(Grammar) |
Zaman uyumsuz olarak bir konuşma tanıma dilbilgisi yükler. |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
QueryRecognizerSetting(String) |
Tanıyıcı için ayarların değerlerini döndürür. |
Recognize() |
Zaman uyumlu konuşma tanıma işlemini gerçekleştirir. |
Recognize(TimeSpan) |
Belirtilen ilk sessizlik zaman aşımı süresi ile zaman uyumlu bir konuşma tanıma işlemi gerçekleştirir. |
RecognizeAsync() |
Tek, zaman uyumsuz bir konuşma tanıma işlemi gerçekleştirir. |
RecognizeAsync(RecognizeMode) |
Bir veya daha fazla zaman uyumsuz konuşma tanıma işlemi gerçekleştirir. |
RecognizeAsyncCancel() |
Geçerli tanıma işleminin tamamlanmasını beklemeden zaman uyumsuz tanımayı sonlandırır. |
RecognizeAsyncStop() |
Geçerli tanıma işlemi tamamlandıktan sonra zaman uyumsuz tanımayı sonlandırır. |
RequestRecognizerUpdate() |
Tanıyıcının durumunu güncelleştirmek için durakladığını istekler. |
RequestRecognizerUpdate(Object) |
Tanıyıcının durumunu güncelleştirmek için durakladığını ve ilişkili olay için bir kullanıcı belirteci sağladığını ister. |
RequestRecognizerUpdate(Object, TimeSpan) |
Tanıcının durumunu güncelleştirmek için durakladığını ve ilişkili olay için bir konum ve kullanıcı belirteci sağladığını ister. |
SetInputToAudioStream(Stream, SpeechAudioFormatInfo) |
SpeechRecognitionEngineBir ses akışından giriş alacak nesneyi yapılandırır. |
SetInputToDefaultAudioDevice() |
SpeechRecognitionEngineVarsayılan ses cihazından giriş alacak nesneyi yapılandırır. |
SetInputToNull() |
Konuşmayı tanıyıcı için girişi devre dışı bırakır. |
SetInputToWaveFile(String) |
SpeechRecognitionEngineNesneyi bir Waveform ses biçimi (. wav) dosyasından giriş alacak şekilde yapılandırır. |
SetInputToWaveStream(Stream) |
Nesneyi, SpeechRecognitionEngine Waveform ses biçimi (. wav) verilerini içeren bir akıştan giriş alacak şekilde yapılandırır. |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
UnloadAllGrammars() |
Tüm Grammar nesneleri tanıyıcıdan kaldırır. |
UnloadGrammar(Grammar) |
Belirtilen Grammar nesneyi SpeechRecognitionEngine örnekten kaldırır. |
UpdateRecognizerSetting(String, Int32) |
Belirtilen tamsayı değeri ile için belirtilen ayarı güncelleştirir SpeechRecognitionEngine . |
UpdateRecognizerSetting(String, String) |
Belirtilen konuşma tanıma altyapısı ayarını belirtilen dize değeriyle güncelleştirir. |
Ekinlikler
AudioLevelUpdated |
, SpeechRecognitionEngine Kendi ses girişi düzeyini raporladığında tetiklenir. |
AudioSignalProblemOccurred |
SpeechRecognitionEngineSes sinyalinde bir sorun algıladığında tetiklenir. |
AudioStateChanged |
, Tarafından alınmakta olan sesde durum değiştiğinde tetiklenir SpeechRecognitionEngine . |
EmulateRecognizeCompleted |
SpeechRecognitionEngineÖykünülmüş girdinin zaman uyumsuz tanıma işlemini sonlandırdığınızda tetiklenir. |
LoadGrammarCompleted |
, SpeechRecognitionEngine Bir nesnenin zaman uyumsuz yüklemesini tamamladığında tetiklenir Grammar . |
RecognizeCompleted |
SpeechRecognitionEngineZaman uyumsuz tanıma işlemini sonlandırdığınızda tetiklenir. |
RecognizerUpdateReached |
Çalışan SpeechRecognitionEngine değişiklikleri kabul etmek için durakladığında tetiklenir. |
SpeechDetected |
, SpeechRecognitionEngine Konuşma olarak tanımlayabilen girişi algıladığında tetiklenir. |
SpeechHypothesized |
Bir SpeechRecognitionEngine dilbilgisinde birden çok bütün tümcecikte bir bileşen olabilecek bir sözcük veya sözcükleri tanıdığında tetiklenir. |
SpeechRecognitionRejected |
SpeechRecognitionEngineYüklü ve etkin nesnelerinden hiçbiriyle eşleşmeyen girişi aldığında tetiklenir Grammar . |
SpeechRecognized |
SpeechRecognitionEngineYüklü ve etkin nesnelerinden herhangi biriyle eşleşen giriş aldığında tetiklenir Grammar . |