SpeechRecognitionEngine.UpdateRecognizerSetting Metode

Definisi

Ruang nama:

System.Speech.Recognition

Rakitan:

System.Speech.dll

Paket:

System.Speech v11.0.0-preview.2.26159.112

Memperbarui nilai pengaturan untuk pengenal.

Overload

Nama	Deskripsi
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.

Keterangan

Pengaturan recognizer dapat berisi string, bilangan bulat 64-bit, atau data alamat memori. Tabel berikut menjelaskan pengaturan yang ditentukan untuk pengenal yang mematuhi Microsoft Speech API (SAPI). Pengaturan berikut harus memiliki rentang yang sama untuk setiap pengenal yang mendukung pengaturan. Pengenal yang mematuhi SAPI tidak diperlukan untuk mendukung pengaturan ini dan dapat mendukung pengaturan lain.

Nama	Deskripsi
ResourceUsage	Menentukan konsumsi CPU recognizer. Kisarannya adalah dari 0 hingga 100. Nilai defaultnya adalah 50.
ResponseSpeed	Menunjukkan panjang keheningan di akhir input yang tidak ambigu sebelum pengenal ucapan menyelesaikan operasi pengenalan. Kisarannya adalah dari 0 hingga 10.000 milidetik (ms). Pengaturan ini sesuai dengan properti recognizer EndSilenceTimeout . Default = 150ms.
ComplexResponseSpeed	Menunjukkan panjang keheningan dalam milidetik (md) di akhir input ambigu sebelum pengenal ucapan menyelesaikan operasi pengenalan. Rentangnya adalah dari 0 hingga 10.000ms. Pengaturan ini sesuai dengan properti recognizer EndSilenceTimeoutAmbiguous . Default = 500ms.
AdaptationOn	Menunjukkan apakah adaptasi model akustik adalah ON (value = 1) atau OFF (value = 0). Nilai defaultnya adalah 1 (AKTIF).
PersistedBackgroundAdaptation	Menunjukkan apakah adaptasi latar belakang AKTIF (nilai = 1) atau NONAKTIF (nilai = 0), dan mempertahankan pengaturan dalam registri. Nilai defaultnya adalah 1 (AKTIF).

Untuk mengembalikan salah satu pengaturan recognizer, gunakan QueryRecognizerSetting metode .

Dengan pengecualian PersistedBackgroundAdaptation, nilai properti yang ditetapkan menggunakan UpdateRecognizerSetting metode tetap berlaku hanya untuk instans saat ini dari SpeechRecognitionEngine, setelah itu mereka kembali ke pengaturan default mereka.

Anda dapat memodifikasi bagaimana pengenalan ucapan merespons input non-ucapan menggunakan BabbleTimeoutproperti , , InitialSilenceTimeoutEndSilenceTimeout, dan EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Sumber:

SpeechRecognitionEngine.cs

Memperbarui pengaturan yang ditentukan untuk SpeechRecognitionEngine dengan nilai bilangan bulat yang ditentukan.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, int updatedValue);

public void UpdateRecognizerSetting(string settingName, int updatedValue);

member this.UpdateRecognizerSetting : string * int -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As Integer)

Parameter

settingName

String

Nama pengaturan yang akan diperbarui.

updatedValue

Int32

Nilai baru untuk pengaturan.

Pengecualian

ArgumentNullException

settingName adalah null.

ArgumentException

settingName adalah string kosong ("").

KeyNotFoundException

Pengenal tidak memiliki pengaturan dengan nama tersebut.

Contoh

Contoh berikut adalah bagian dari aplikasi konsol yang menghasilkan nilai untuk sejumlah pengaturan yang ditentukan untuk recognizer yang mendukung lokal en-US. Contoh memperbarui pengaturan tingkat keyakinan, lalu meminta pengenal untuk memeriksa nilai yang diperbarui. Contoh menghasilkan output berikut.

Settings for recognizer MS-1033-80-DESK:

  ResourceUsage                  is not supported by this recognizer.
  ResponseSpeed                  = 150
  ComplexResponseSpeed           = 500
  AdaptationOn                   = 1
  PersistedBackgroundAdaptation  = 1

Updated settings:

  ResourceUsage                  is not supported by this recognizer.
  ResponseSpeed                  = 200
  ComplexResponseSpeed           = 300
  AdaptationOn                   = 0
  PersistedBackgroundAdaptation  = 0

Press any key to exit...

using System;
using System.Globalization;
using System.Speech.Recognition;

namespace RecognizerSettings
{
  class Program
  {
    static readonly string[] settings = new string[] {
      "ResourceUsage",
      "ResponseSpeed",
      "ComplexResponseSpeed",
      "AdaptationOn",
      "PersistedBackgroundAdaptation",
    };

    static void Main(string[] args)
    {
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))
      {
        Console.WriteLine("Settings for recognizer {0}:",
          recognizer.RecognizerInfo.Name);
        Console.WriteLine();

        // List the current settings.
        ListSettings(recognizer);

        // Change some of the settings.
        recognizer.UpdateRecognizerSetting("ResponseSpeed", 200);
        recognizer.UpdateRecognizerSetting("ComplexResponseSpeed", 300);
        recognizer.UpdateRecognizerSetting("AdaptationOn", 1);
        recognizer.UpdateRecognizerSetting("PersistedBackgroundAdaptation", 0);

        Console.WriteLine("Updated settings:");
        Console.WriteLine();

        // List the updated settings.
        ListSettings(recognizer);
      }

      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }

    private static void ListSettings(SpeechRecognitionEngine recognizer)
    {
      foreach (string setting in settings)
      {
        try
        {
          object value = recognizer.QueryRecognizerSetting(setting);
          Console.WriteLine("  {0,-30} = {1}", setting, value);
        }
        catch
        {
          Console.WriteLine("  {0,-30} is not supported by this recognizer.",
            setting);
        }
      }
      Console.WriteLine();
    }
  }
}

Keterangan

Dengan pengecualian PersistedBackgroundAdaptation, nilai properti yang ditetapkan menggunakan UpdateRecognizerSetting metode tetap berlaku hanya untuk instans saat ini dari SpeechRecognitionEngine, setelah itu mereka kembali ke pengaturan default mereka. Lihat UpdateRecognizerSetting untuk deskripsi pengaturan yang didukung.

Lihat juga

• QueryRecognizerSetting(String)

UpdateRecognizerSetting(String, String)

Sumber:

SpeechRecognitionEngine.cs

Memperbarui pengaturan mesin pengenalan ucapan yang ditentukan dengan nilai string yang ditentukan.

public:
 void UpdateRecognizerSetting(System::String ^ settingName, System::String ^ updatedValue);

public void UpdateRecognizerSetting(string settingName, string updatedValue);

member this.UpdateRecognizerSetting : string * string -> unit

Public Sub UpdateRecognizerSetting (settingName As String, updatedValue As String)

Parameter

settingName

String

Nama pengaturan yang akan diperbarui.

updatedValue

String

Nilai baru untuk pengaturan.

Pengecualian

ArgumentNullException

settingName adalah null.

ArgumentException

settingName adalah string kosong ("").

KeyNotFoundException

Pengenal tidak memiliki pengaturan dengan nama tersebut.

Keterangan

Dengan pengecualian PersistedBackgroundAdaptation, nilai properti yang ditetapkan menggunakan UpdateRecognizerSetting metode tetap berlaku hanya untuk instans saat ini dari SpeechRecognitionEngine, setelah itu mereka kembali ke pengaturan default mereka. Lihat UpdateRecognizerSetting untuk deskripsi pengaturan yang didukung.

Lihat juga

• QueryRecognizerSetting(String)