SpeechRecognitionEngine Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan sarana untuk mengakses dan mengelola mesin pengenalan ucapan dalam proses.
public ref class SpeechRecognitionEngine : IDisposablepublic class SpeechRecognitionEngine : IDisposabletype SpeechRecognitionEngine = class
interface IDisposablePublic Class SpeechRecognitionEngine
Implements IDisposable- Warisan
-
SpeechRecognitionEngine
- Penerapan
Contoh
Contoh berikut menunjukkan bagian dari aplikasi konsol yang menunjukkan pengenalan ucapan dasar. Karena contoh ini menggunakan Multiple mode RecognizeAsync metode , ia melakukan pengenalan hingga Anda menutup jendela konsol atau menghentikan penelusuran kesalahan.
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);
}
}
}
Keterangan
Anda dapat membuat instans kelas ini untuk salah satu pengenal ucapan yang diinstal. Untuk mendapatkan informasi tentang pengenal mana yang diinstal, gunakan metode statis InstalledRecognizers .
Kelas ini untuk menjalankan mesin pengenalan ucapan dalam proses, dan memberikan kontrol atas berbagai aspek pengenalan ucapan, sebagai berikut:
Untuk membuat pengenal ucapan dalam proses, gunakan salah SpeechRecognitionEngine satu konstruktor.
Untuk mengelola tata bahasa pengenalan ucapan, gunakan LoadGrammarmetode , , LoadGrammarAsyncUnloadGrammar, dan UnloadAllGrammars , dan Grammars properti .
Untuk mengonfigurasi input ke pengenal, gunakan SetInputToAudioStreammetode , , SetInputToDefaultAudioDeviceSetInputToNull, SetInputToWaveFile, atau SetInputToWaveStream .
Untuk melakukan pengenalan ucapan, gunakan Recognize metode atau RecognizeAsync .
Untuk memodifikasi bagaimana pengenalan menangani keheningan atau input yang tidak terduga, gunakan BabbleTimeoutproperti , , InitialSilenceTimeoutEndSilenceTimeout, dan EndSilenceTimeoutAmbiguous .
Untuk mengubah jumlah alternatif yang dikembalikan recognizer, gunakan MaxAlternates properti . Pengenal mengembalikan hasil pengenalan dalam objek RecognitionResult .
Untuk menyinkronkan perubahan pada pengenal, gunakan RequestRecognizerUpdate metode . Pengenal menggunakan lebih dari satu utas untuk melakukan tugas.
Untuk meniru input ke pengenal, gunakan EmulateRecognize metode dan EmulateRecognizeAsync .
Objek SpeechRecognitionEngine ini untuk penggunaan satu-satunya proses yang membuat objek. Sebaliknya, SpeechRecognizer berbagi satu pengenal dengan aplikasi apa pun yang ingin menggunakannya.
Nota
Selalu panggil Dispose sebelum Anda merilis referensi terakhir Anda ke pengenal ucapan. Jika tidak, sumber daya yang digunakannya tidak akan dibebaskan sampai pengumpul sampah memanggil metode objek Finalize recognizer.
Konstruktor
| Nama | Deskripsi |
|---|---|
| SpeechRecognitionEngine() |
Menginisialisasi instans SpeechRecognitionEngine baru kelas menggunakan pengenal ucapan default untuk sistem. |
| SpeechRecognitionEngine(CultureInfo) |
Menginisialisasi instans SpeechRecognitionEngine baru kelas menggunakan pengenal ucapan default untuk lokal tertentu. |
| SpeechRecognitionEngine(RecognizerInfo) |
Menginisialisasi instans baru menggunakan SpeechRecognitionEngine informasi dalam RecognizerInfo objek untuk menentukan pengenal yang akan digunakan. |
| SpeechRecognitionEngine(String) |
Menginisialisasi instans SpeechRecognitionEngine baru kelas dengan parameter string yang menentukan nama pengenal yang akan digunakan. |
Properti
| Nama | Deskripsi |
|---|---|
| AudioFormat |
Mendapatkan format audio yang diterima oleh SpeechRecognitionEngine. |
| AudioLevel |
Mendapatkan tingkat audio yang diterima oleh SpeechRecognitionEngine. |
| AudioPosition |
Mendapatkan lokasi saat ini di aliran audio yang dihasilkan oleh perangkat yang memberikan input ke SpeechRecognitionEngine. |
| AudioState |
Mendapatkan status audio yang diterima oleh SpeechRecognitionEngine. |
| BabbleTimeout |
Mendapatkan atau mengatur interval waktu di mana menerima input yang SpeechRecognitionEngine hanya berisi kebisingan latar belakang, sebelum menyelesaikan pengenalan. |
| EndSilenceTimeout |
Mendapatkan atau mengatur interval keheningan yang SpeechRecognitionEngine akan diterima di akhir input yang tidak ambigu sebelum menyelesaikan operasi pengenalan. |
| EndSilenceTimeoutAmbiguous |
Mendapatkan atau mengatur interval keheningan yang SpeechRecognitionEngine akan diterima di akhir input ambigu sebelum menyelesaikan operasi pengenalan. |
| Grammars |
Mendapatkan koleksi Grammar objek yang dimuat dalam instans ini SpeechRecognitionEngine . |
| InitialSilenceTimeout |
Mendapatkan atau mengatur interval waktu di mana menerima input yang SpeechRecognitionEngine hanya berisi keheningan sebelum menyelesaikan pengenalan. |
| MaxAlternates |
Mendapatkan atau mengatur jumlah maksimum hasil pengenalan alternatif yang SpeechRecognitionEngine dikembalikan untuk setiap operasi pengenalan. |
| RecognizerAudioPosition |
Mendapatkan lokasi saat ini dari SpeechRecognitionEngine dalam input audio yang sedang diproses. |
| RecognizerInfo |
Mendapatkan informasi tentang instans saat ini dari SpeechRecognitionEngine. |
Metode
| Nama | Deskripsi |
|---|---|
| Dispose() |
SpeechRecognitionEngine Membuang objek. |
| Dispose(Boolean) |
SpeechRecognitionEngine Membuang objek dan merilis sumber daya yang digunakan selama sesi. |
| EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
Meniru input kata-kata tertentu ke pengenal ucapan, menggunakan teks sebagai pengganti audio untuk pengenalan ucapan yang sinkron, dan menentukan bagaimana pengenal menangani perbandingan Unicode antara kata dan tata bahasa pengenalan ucapan yang dimuat. |
| EmulateRecognize(String, CompareOptions) |
Meniru input frasa ke pengenal ucapan, menggunakan teks sebagai pengganti audio untuk pengenalan ucapan sinkron, dan menentukan bagaimana pengenal menangani perbandingan Unicode antara frasa dan tata bahasa pengenalan ucapan yang dimuat. |
| EmulateRecognize(String) |
Meniru input frasa ke pengenal ucapan, menggunakan teks sebagai pengganti audio untuk pengenalan ucapan sinkron. |
| EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) |
Meniru input kata-kata tertentu ke pengenal ucapan, menggunakan array RecognizedWordUnit objek sebagai pengganti audio untuk pengenalan ucapan asinkron, dan menentukan bagaimana pengenal menangani perbandingan Unicode antara kata dan tata bahasa pengenalan ucapan yang dimuat. |
| EmulateRecognizeAsync(String, CompareOptions) |
Meniru input frasa ke pengenal ucapan, menggunakan teks sebagai pengganti audio untuk pengenalan ucapan asinkron, dan menentukan bagaimana pengenal menangani perbandingan Unicode antara frasa dan tata bahasa pengenalan ucapan yang dimuat. |
| EmulateRecognizeAsync(String) |
Meniru input frasa ke pengenal ucapan, menggunakan teks sebagai pengganti audio untuk pengenalan ucapan asinkron. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| InstalledRecognizers() |
Mengembalikan informasi untuk semua pengenal ucapan yang diinstal pada sistem saat ini. |
| LoadGrammar(Grammar) |
Secara sinkron memuat Grammar objek. |
| LoadGrammarAsync(Grammar) |
Secara asinkron memuat tata bahasa pengenalan ucapan. |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| QueryRecognizerSetting(String) |
Mengembalikan nilai pengaturan untuk pengenal. |
| Recognize() |
Melakukan operasi pengenalan ucapan sinkron. |
| Recognize(TimeSpan) |
Melakukan operasi pengenalan ucapan sinkron dengan periode batas waktu keheningan awal yang ditentukan. |
| RecognizeAsync() |
Melakukan satu operasi pengenalan ucapan asinkron. |
| RecognizeAsync(RecognizeMode) |
Melakukan satu atau beberapa operasi pengenalan ucapan asinkron. |
| RecognizeAsyncCancel() |
Mengakhiri pengenalan asinkron tanpa menunggu operasi pengenalan saat ini selesai. |
| RecognizeAsyncStop() |
Menghentikan pengenalan asinkron setelah operasi pengenalan saat ini selesai. |
| RequestRecognizerUpdate() |
Meminta agar pengenal berhenti sejenak untuk memperbarui statusnya. |
| RequestRecognizerUpdate(Object, TimeSpan) |
Meminta agar recognizer berhenti sejenak untuk memperbarui statusnya dan menyediakan offset dan token pengguna untuk peristiwa terkait. |
| RequestRecognizerUpdate(Object) |
Meminta agar recognizer berhenti sejenak untuk memperbarui statusnya dan menyediakan token pengguna untuk peristiwa terkait. |
| SetInputToAudioStream(Stream, SpeechAudioFormatInfo) |
SpeechRecognitionEngine Mengonfigurasi objek untuk menerima input dari aliran audio. |
| SetInputToDefaultAudioDevice() |
SpeechRecognitionEngine Mengonfigurasi objek untuk menerima input dari perangkat audio default. |
| SetInputToNull() |
Menonaktifkan input ke pengenal ucapan. |
| SetInputToWaveFile(String) |
SpeechRecognitionEngine Mengonfigurasi objek untuk menerima input dari file format audio Waveform (.wav). |
| SetInputToWaveStream(Stream) |
SpeechRecognitionEngine Mengonfigurasi objek untuk menerima input dari aliran yang berisi data format audio Waveform (.wav). |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| UnloadAllGrammars() |
Membongkar semua Grammar objek dari pengenal. |
| UnloadGrammar(Grammar) |
Membongkar objek tertentu Grammar dari SpeechRecognitionEngine instans. |
| UpdateRecognizerSetting(String, Int32) |
Memperbarui pengaturan yang ditentukan untuk SpeechRecognitionEngine dengan nilai bilangan bulat yang ditentukan. |
| UpdateRecognizerSetting(String, String) |
Memperbarui pengaturan mesin pengenalan ucapan yang ditentukan dengan nilai string yang ditentukan. |
Acara
| Nama | Deskripsi |
|---|---|
| AudioLevelUpdated |
Dimunculkan saat SpeechRecognitionEngine melaporkan tingkat input audionya. |
| AudioSignalProblemOccurred |
Dimunculkan ketika SpeechRecognitionEngine mendeteksi masalah dalam sinyal audio. |
| AudioStateChanged |
Dimunculkan ketika status berubah dalam audio yang diterima oleh SpeechRecognitionEngine. |
| EmulateRecognizeCompleted |
Dimunculkan ketika SpeechRecognitionEngine menyelesaikan operasi pengenalan asinkron dari input yang ditiru. |
| LoadGrammarCompleted |
Dimunculkan ketika SpeechRecognitionEngine selesai memuat Grammar objek asinkron. |
| RecognizeCompleted |
Dimunculkan saat SpeechRecognitionEngine menyelesaikan operasi pengenalan asinkron. |
| RecognizerUpdateReached |
Dimunculkan saat berjalan SpeechRecognitionEngine berhenti sejenak untuk menerima modifikasi. |
| SpeechDetected |
Dimunculkan saat SpeechRecognitionEngine mendeteksi input yang dapat diidentifikasi sebagai ucapan. |
| SpeechHypothesized |
Dimunculkan ketika SpeechRecognitionEngine telah mengenali kata atau kata yang mungkin merupakan komponen dari beberapa frasa lengkap dalam tata bahasa. |
| SpeechRecognitionRejected |
Dimunculkan ketika SpeechRecognitionEngine menerima input yang tidak cocok dengan objek yang dimuat dan diaktifkan Grammar . |
| SpeechRecognized |
Dimunculkan saat SpeechRecognitionEngine menerima input yang cocok dengan salah satu objek yang dimuat dan diaktifkan Grammar . |
