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ı 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 örnekte bir konsol uygulamasının temel konuşma tanımayı gösteren bölümü gösterilmektedir. Bu örnek yönteminin Multiple modunu kullandığından RecognizeAsync , konsol penceresini kapatana veya hata ayıklamayı durdurana kadar tanıma 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
Yüklü konuşma tanıyıcılarından herhangi biri için bu sınıfın bir örneğini oluşturabilirsiniz. Hangi tanıyıcıların yüklendiği hakkında bilgi almak için statik InstalledRecognizers yöntemini kullanın.
Bu sınıf, konuşma tanıma altyapılarını çalışırken çalıştırmaya yöneliktir 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ısı oluşturmak için oluşturuculardan SpeechRecognitionEngine birini kullanın.
Konuşma tanıma dil bilgisini yönetmek için , , ve UnloadAllGrammars yöntemlerini ve Grammars özelliğini kullanınLoadGrammar. UnloadGrammarLoadGrammarAsync
Tanıyıcıya girişi yapılandırmak için , , SetInputToDefaultAudioDevice, SetInputToNull, SetInputToWaveFileveya SetInputToWaveStream yöntemini kullanınSetInputToAudioStream.
Konuşma tanıma gerçekleştirmek için veya RecognizeAsync yöntemini kullanınRecognize.
Tanımanın sessizliği veya beklenmeyen girişi işleme biçimini değiştirmek için , InitialSilenceTimeout, EndSilenceTimeoutve EndSilenceTimeoutAmbiguous özelliklerini kullanınBabbleTimeout.
Tanıyıcının döndürdüğü alternatiflerin sayısını değiştirmek için özelliğini kullanın MaxAlternates . Tanıyıcı bir RecognitionResult nesnede tanıma sonuçları döndürür.
Değişiklikleri tanıyıcıya eşitlemek için yöntemini kullanın RequestRecognizerUpdate . Tanıyıcı, görevleri gerçekleştirmek için birden fazla iş parçacığı kullanır.
Tanıyıcıya giriş öykünmek için ve EmulateRecognizeAsync yöntemlerini kullanınEmulateRecognize.
SpeechRecognitionEngine nesnesi, yalnızca nesnenin örneğini oluşturan işlemin kullanımına yöneliktir. Buna karşılık, SpeechRecognizer tek bir tanıyıcıyı kullanmak isteyen herhangi bir uygulamayla paylaşır.
Uyarı
Konuşma tanımaya son başvurunuzu yayınlamadan önce her zaman arayın Dispose . Aksi takdirde, atık toplayıcı tanıyıcı nesnesinin Finalize yöntemini çağırana kadar kullandığı kaynaklar serbest kalır.
Oluşturucular
| Name | Description |
|---|---|
| SpeechRecognitionEngine() |
Sistem için varsayılan konuşma tanıyıcısını SpeechRecognitionEngine kullanarak sınıfın yeni bir örneğini başlatır. |
| SpeechRecognitionEngine(CultureInfo) |
Belirtilen yerel ayar için varsayılan konuşma tanıyıcısını kullanarak sınıfın yeni bir örneğini SpeechRecognitionEngine başlatır. |
| SpeechRecognitionEngine(RecognizerInfo) |
Kullanılacak tanıyıcıyı SpeechRecognitionEngine belirtmek için nesnedeki bilgileri kullanarak öğesinin yeni bir RecognizerInfo örneğini başlatır. |
| SpeechRecognitionEngine(String) |
Kullanılacak tanıyıcının SpeechRecognitionEngine adını belirten bir dize parametresiyle sınıfının yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| AudioFormat |
tarafından SpeechRecognitionEnginealınan sesin biçimini alır. |
| AudioLevel |
tarafından SpeechRecognitionEnginealınan ses düzeyini alır. |
| AudioPosition |
öğesine giriş SpeechRecognitionEnginesağlayan cihaz tarafından oluşturulan ses akışındaki geçerli konumu alır. |
| AudioState |
tarafından SpeechRecognitionEnginealınan sesin durumunu alır. |
| BabbleTimeout |
Tanımayı sonlandırmadan önce, bir SpeechRecognitionEngine girişin yalnızca arka plan gürültüsü içeren girişi kabul ettiği zaman aralığını alır veya ayarlar. |
| EndSilenceTimeout |
Bir tanıma işlemini sonlandırmadan önce belirsiz girişin sonunda kabul edeceği sessizlik SpeechRecognitionEngine aralığını alır veya ayarlar. |
| EndSilenceTimeoutAmbiguous |
Bir tanıma işlemini sonlandırmadan önce belirsiz girişin sonunda kabul edeceği sessizlik SpeechRecognitionEngine aralığını alır veya ayarlar. |
| Grammars |
Bu SpeechRecognitionEngine örnekte yüklenen nesnelerin bir koleksiyonunu Grammar alır. |
| InitialSilenceTimeout |
Tanımayı sonlandırmadan önce yalnızca sessizlik içeren girişi SpeechRecognitionEngine kabul ettiği zaman aralığını alır veya ayarlar. |
| MaxAlternates |
Her tanıma işlemi için döndürdüğü SpeechRecognitionEngine en fazla alternatif tanıma sonucunu alır veya ayarlar. |
| RecognizerAudioPosition |
İşlediğini ses girişindeki geçerli konumunu SpeechRecognitionEngine alır. |
| RecognizerInfo |
geçerli örneği SpeechRecognitionEnginehakkında bilgi alır. |
Yöntemler
| Name | Description |
|---|---|
| Dispose() |
Nesnesini atar SpeechRecognitionEngine . |
| Dispose(Boolean) |
Nesnesini atar SpeechRecognitionEngine ve oturum sırasında kullanılan kaynakları serbest bırakır. |
| EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak belirli sözcüklerin girişini konuşma tanıyıcısına öyküner ve tanıyıcının sözcüklerle yüklenen konuşma tanıma dil bilgisi arasındaki Unicode karşılaştırmasını nasıl işlediğini belirtir. |
| EmulateRecognize(String, CompareOptions) |
Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak bir tümceciğin girişini konuşma tanıyıcısına öyküner ve tanıyıcının tümcecikle yüklenen konuşma tanıma dil bilgisi arasındaki Unicode karşılaştırmasını nasıl işlediğini belirtir. |
| EmulateRecognize(String) |
Zaman uyumlu konuşma tanıma için ses yerine metin kullanarak bir tümceciğin girişini konuşma tanıyıcısına öyküner. |
| EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) |
Zaman uyumsuz konuşma tanıma için ses yerine bir nesne dizisi RecognizedWordUnit kullanarak konuşma tanıyıcısına belirli sözcüklerin girişini öyküner ve tanıyıcının sözcüklerle yüklenen konuşma tanıma dil bilgisi arasındaki Unicode karşılaştırmasını nasıl işlediğini belirtir. |
| EmulateRecognizeAsync(String, CompareOptions) |
Zaman uyumsuz konuşma tanıma için ses yerine metin kullanarak bir tümceciğin girişini konuşma tanıyıcıya öyküner ve tanıyıcının tümcecik ile yüklenen konuşma tanıma dil bilgisi arasında Unicode karşılaştırmasını nasıl işlediğini belirtir. |
| EmulateRecognizeAsync(String) |
Zaman uyumsuz konuşma tanıma için ses yerine metin kullanarak bir tümceciğin girişini konuşma tanıyıcısına öyküner. |
| 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() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| InstalledRecognizers() |
Geçerli sistemdeki tüm yüklü konuşma tanıyıcıları için bilgileri döndürür. |
| LoadGrammar(Grammar) |
Bir nesneyi zaman uyumlu olarak Grammar yükler. |
| LoadGrammarAsync(Grammar) |
Konuşma tanıma dil bilgisini zaman uyumsuz olarak yükler. |
| MemberwiseClone() |
Geçerli Objectbasit 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 bir konuşma tanıma işlemi gerçekleştirir. |
| Recognize(TimeSpan) |
Belirtilen ilk sessizlik zaman aşımı süresiyle 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ı durdurur. |
| RequestRecognizerUpdate() |
Tanıyıcının durumunu güncelleştirmek için duraklatma isteğinde bulunur. |
| RequestRecognizerUpdate(Object, TimeSpan) |
Tanıyıcının durumunu güncelleştirmek için duraklamasını ve ilişkili olay için bir uzaklık ve kullanıcı belirteci sağlamasını istemektedir. |
| RequestRecognizerUpdate(Object) |
Tanıyıcının durumunu güncelleştirmek için duraklamasını ve ilişkili olay için bir kullanıcı belirteci sağlamasını istemektedir. |
| SetInputToAudioStream(Stream, SpeechAudioFormatInfo) |
SpeechRecognitionEngine Nesneyi bir ses akışından giriş alacak şekilde yapılandırılır. |
| SetInputToDefaultAudioDevice() |
SpeechRecognitionEngine Nesneyi, varsayılan ses cihazından giriş alacak şekilde yapılandırılır. |
| SetInputToNull() |
Konuşma tanımaya girişi devre dışı bırakır. |
| SetInputToWaveFile(String) |
SpeechRecognitionEngine Nesneyi Waveform ses biçimi (.wav) dosyasından giriş alacak şekilde yapılandırılır. |
| SetInputToWaveStream(Stream) |
SpeechRecognitionEngine Nesnesini Waveform ses biçimi (.wav) verileri içeren bir akıştan giriş alacak şekilde yapılandırılır. |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
| UnloadAllGrammars() |
Tanıyıcıdan tüm Grammar nesneleri kaldırır. |
| UnloadGrammar(Grammar) |
Belirtilen Grammar bir nesneyi örnekten SpeechRecognitionEngine kaldırır. |
| UpdateRecognizerSetting(String, Int32) |
için SpeechRecognitionEngine belirtilen ayarı belirtilen tamsayı değeriyle güncelleştirir. |
| UpdateRecognizerSetting(String, String) |
Belirtilen konuşma tanıma altyapısı ayarını belirtilen dize değeriyle güncelleştirir. |
Ekinlikler
| Name | Description |
|---|---|
| AudioLevelUpdated |
ses girişinin SpeechRecognitionEngine düzeyini bildirdiğinde yükseltildi. |
| AudioSignalProblemOccurred |
ses sinyalinde SpeechRecognitionEngine bir sorun algıladığında yükseltildi. |
| AudioStateChanged |
tarafından alınan seste durum değiştiğinde yükseltildi SpeechRecognitionEngine. |
| EmulateRecognizeCompleted |
öykünülmüş SpeechRecognitionEngine girişin zaman uyumsuz bir tanıma işlemini sonlandırdığında oluşturulur. |
| LoadGrammarCompleted |
bir nesnenin SpeechRecognitionEngine zaman uyumsuz yüklemesini Grammar tamamladığında tetiklenir. |
| RecognizeCompleted |
zaman uyumsuz bir tanıma işlemini sonlandırdığında SpeechRecognitionEngine oluşturulur. |
| RecognizerUpdateReached |
Çalışan SpeechRecognitionEngine bir değişiklik kabul etmek için duraklatıldığında oluşturulur. |
| SpeechDetected |
konuşma olarak tanımlayabildiği girişi algıladığında SpeechRecognitionEngine yükseltildi. |
| SpeechHypothesized |
SpeechRecognitionEngine, bir dil bilgisi içindeki birden çok tam tümceciğin bileşeni olabilecek bir sözcüğü veya sözcükleri tanıdığında oluşturulur. |
| SpeechRecognitionRejected |
SpeechRecognitionEngine yüklenen ve etkinleştirilmiş Grammar nesnelerinden herhangi biriyle eşleşmeyen girişi aldığında oluşturulur. |
| SpeechRecognized |
SpeechRecognitionEngine yüklenen ve etkinleştirilmiş Grammar nesnelerinden herhangi biri ile eşleşen girişi aldığında oluşturulur. |