SpeechRecognitionEngine.UpdateRecognizerSetting Methode

Definitie

Naamruimte:
System.Speech.Recognition
Assembly:
System.Speech.dll

Hiermee wordt de waarde van een instelling voor de recognizer bijgewerkt.

Overloads

Name Description
UpdateRecognizerSetting(String, Int32)

Hiermee werkt u de opgegeven instelling voor de SpeechRecognitionEngine opgegeven gehele waarde bij.
UpdateRecognizerSetting(String, String)

Hiermee wordt de opgegeven instelling voor de spraakherkenningsengine bijgewerkt met de opgegeven tekenreekswaarde.

Opmerkingen

Recognizer-instellingen kunnen tekenreeks-, 64-bits geheel getal- of geheugenadresgegevens bevatten. In de volgende tabel worden de instellingen beschreven die zijn gedefinieerd voor een Microsoft SAPI-compatibele recognizer (Speech API). De volgende instellingen moeten hetzelfde bereik hebben voor elke recognizer die ondersteuning biedt voor de instelling. Een SAPI-compatibele recognizer is niet vereist om deze instellingen te ondersteunen en kan andere instellingen ondersteunen.

Name Description
ResourceUsage Hiermee geeft u het CPU-verbruik van de recognizer. Het bereik is van 0 tot 100. De standaardwaarde is 50.
ResponseSpeed Geeft de lengte van stilte aan het einde van ondubbelzinnige invoer aan voordat de spraakherkenning een herkenningsbewerking voltooit. Het bereik is van 0 tot 10.000 milliseconden (ms). Deze instelling komt overeen met de eigenschap van EndSilenceTimeout de recognizer. Standaard = 150 ms.
ComplexResponseSpeed Geeft de lengte van stilte in milliseconden (ms) aan het einde van dubbelzinnige invoer aan voordat de spraakherkenning een herkenningsbewerking voltooit. Het bereik is van 0 tot 10.000 ms. Deze instelling komt overeen met de eigenschap van EndSilenceTimeoutAmbiguous de recognizer. Standaard = 500 ms.
AdaptationOn Geeft aan of aanpassing van het akoestische model AAN (waarde = 1) of OFF (waarde = ) is 0. De standaardwaarde is 1 (AAN).
PersistedBackgroundAdaptation Geeft aan of achtergrondaanpassing is ingeschakeld (waarde = 1) of UIT (waarde = 0) en de instelling in het register persistent maakt. De standaardwaarde is 1 (AAN).

Als u een van de instellingen van de recognizer wilt retourneren, gebruikt u de QueryRecognizerSetting methode.

Met uitzondering van PersistedBackgroundAdaptation, eigenschapswaarden ingesteld met behulp van de UpdateRecognizerSetting methoden blijven alleen van kracht voor het huidige exemplaar van SpeechRecognitionEngine, waarna ze terugkeren naar hun standaardinstellingen.

U kunt wijzigen hoe de spraakherkenning reageert op niet-spraakinvoer met behulp van de BabbleTimeout, InitialSilenceTimeouten EndSilenceTimeouteigenschappen EndSilenceTimeoutAmbiguous .

UpdateRecognizerSetting(String, Int32)

Hiermee werkt u de opgegeven instelling voor de SpeechRecognitionEngine opgegeven gehele waarde bij.

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)

Parameters

settingName
String

De naam van de instelling die moet worden bijgewerkt.

updatedValue
Int32

De nieuwe waarde voor de instelling.

Uitzonderingen

ArgumentNullException

settingName is null.

ArgumentException

settingName is de lege tekenreeks ("").

KeyNotFoundException

De recognizer heeft geen instelling met die naam.

Voorbeelden

Het volgende voorbeeld maakt deel uit van een consoletoepassing die de waarden uitvoert voor een aantal instellingen die zijn gedefinieerd voor de recognizer die ondersteuning biedt voor de en-US landinstelling. In het voorbeeld worden de instellingen op betrouwbaarheidsniveau bijgewerkt en wordt vervolgens een query uitgevoerd op de recognizer om de bijgewerkte waarden te controleren. In het voorbeeld wordt de volgende uitvoer gegenereerd.

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();
    }
  }
}

Opmerkingen

Met uitzondering van , eigenschapswaarden die zijn ingesteld met behulp van PersistedBackgroundAdaptationde UpdateRecognizerSetting methode blijven alleen van kracht voor het huidige exemplaar van SpeechRecognitionEngine, waarna ze terugkeren naar hun standaardinstellingen. Zie UpdateRecognizerSetting voor beschrijvingen van ondersteunde instellingen.

Zie ook

Van toepassing op

UpdateRecognizerSetting(String, String)

Hiermee wordt de opgegeven instelling voor de spraakherkenningsengine bijgewerkt met de opgegeven tekenreekswaarde.

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)

Parameters

settingName
String

De naam van de instelling die moet worden bijgewerkt.

updatedValue
String

De nieuwe waarde voor de instelling.

Uitzonderingen

ArgumentNullException

settingName is null.

ArgumentException

settingName is de lege tekenreeks ("").

KeyNotFoundException

De recognizer heeft geen instelling met die naam.

Opmerkingen

Met uitzondering van , eigenschapswaarden die zijn ingesteld met behulp van PersistedBackgroundAdaptationde UpdateRecognizerSetting methode blijven alleen van kracht voor het huidige exemplaar van SpeechRecognitionEngine, waarna ze terugkeren naar hun standaardinstellingen. Zie UpdateRecognizerSetting voor beschrijvingen van ondersteunde instellingen.

Zie ook

Van toepassing op