RecognizerUpdateReachedEventArgs クラス

定義

RecognizerUpdateReached または RecognizerUpdateReached イベントからのデータを返します。Returns data from a RecognizerUpdateReached or a RecognizerUpdateReached event.

public ref class RecognizerUpdateReachedEventArgs : EventArgs
public class RecognizerUpdateReachedEventArgs : EventArgs
type RecognizerUpdateReachedEventArgs = class
    inherit EventArgs
Public Class RecognizerUpdateReachedEventArgs
Inherits EventArgs
継承
RecognizerUpdateReachedEventArgs

次の例は、オブジェクトの読み込みとアンロードを行うコンソールアプリケーションを示して Grammar います。The following example shows a console application that loads and unloads Grammar objects. アプリケーションでは、メソッドを使用して RequestRecognizerUpdate 音声認識エンジンが一時停止するように要求し、更新プログラムを受信できるようにします。The application uses the RequestRecognizerUpdate method to request the speech recognition engine to pause so it can receive an update. その後、アプリケーションはオブジェクトを読み込んだりアンロードしたりし Grammar ます。The application then loads or unloads a Grammar object.

各更新時に、イベントのハンドラーによって、 SpeechRecognitionEngine.RecognizerUpdateReached 現在読み込まれているオブジェクトの名前と状態が Grammar コンソールに書き込まれます。At each update, a handler for SpeechRecognitionEngine.RecognizerUpdateReached event writes the name and status of the currently loaded Grammar objects to the console. 文法が読み込まれてアンロードされると、アプリケーションは最初にファームの動物の名前、次にファームの動物の名前と果物の名前を認識し、次に果物の名前のみを認識します。As grammars are loaded and unloaded, the application first recognizes the names of farm animals, then the names of farm animals and the names of fruits, then only the names of fruits.

using System;  
using System.Speech.Recognition;  
using System.Collections.Generic;  
using System.Threading;  

namespace SampleRecognition  
{  
  class Program  
  {  
    private static SpeechRecognitionEngine recognizer;  
    public static void Main(string[] args)  
    {  

      // Initialize an in-process speech recognition engine and configure its input.  
      using (recognizer = new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))  
      {  
        recognizer.SetInputToDefaultAudioDevice();  

        // Create the first grammar - Farm.  
        Choices animals = new Choices(new string[] { "cow", "pig", "goat" });  
        GrammarBuilder farm = new GrammarBuilder(animals);  
        Grammar farmAnimals = new Grammar(farm);  
        farmAnimals.Name = "Farm";  

        // Create the second grammar - Fruit.  
        Choices fruit = new Choices(new string[] { "apples", "peaches", "oranges" });  
        GrammarBuilder favorite = new GrammarBuilder(fruit);  
        Grammar favoriteFruit = new Grammar(favorite);  
        favoriteFruit.Name = "Fruit";  

        // Attach event handlers.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  
        recognizer.RecognizerUpdateReached +=  
          new EventHandler<RecognizerUpdateReachedEventArgs>(recognizer_RecognizerUpdateReached);  
        recognizer.SpeechRecognitionRejected +=  
          new EventHandler<SpeechRecognitionRejectedEventArgs>(recognizer_SpeechRecognitionRejected);  

        // Load the Farm grammar.  
        recognizer.LoadGrammar(farmAnimals);  

        // Start asynchronous, continuous recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  
        Console.WriteLine("Starting asynchronous, continuous recognition");  
        Console.WriteLine("  Farm grammar is loaded and enabled.");  

        // Pause to recognize farm animals.  
        Thread.Sleep(7000);  
        Console.WriteLine();  

        // Request an update and load the Fruit grammar.  
        recognizer.RequestRecognizerUpdate();  
        recognizer.LoadGrammarAsync(favoriteFruit);  
        Thread.Sleep(7000);  

        // Request an update and unload the Farm grammar.  
        recognizer.RequestRecognizerUpdate();  
        recognizer.UnloadGrammar(farmAnimals);  
        Thread.Sleep(7000);  
      }  

      // Keep the console window open.  
      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  

    // At the update, get the names and enabled status of the currently loaded grammars.  
    public static void recognizer_RecognizerUpdateReached(  
      object sender, RecognizerUpdateReachedEventArgs e)  
    {  
      Console.WriteLine();  
      Console.WriteLine("Update reached:");  
      Thread.Sleep(1000);  

      string qualifier;  
      List<Grammar> grammars = new List<Grammar>(recognizer.Grammars);  
      foreach (Grammar g in grammars)  
      {  
        qualifier = (g.Enabled) ? "enabled" : "disabled";  
        Console.WriteLine("  {0} grammar is loaded and {1}.",  
        g.Name, qualifier);  
      }  
    }  

    // Write the text of the recognized phrase to the console.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("    Speech recognized: " + e.Result.Text);  
    }  

    // Write a message to the console when recognition fails.  
    static void recognizer_SpeechRecognitionRejected(object sender, SpeechRecognitionRejectedEventArgs e)  
    {  
      Console.WriteLine("    Recognition attempt failed");  
    }  
  }  
}  

注釈

RecognizerUpdateReached イベントは、音声認識エンジンを一時停止して、文法の読み込みやアンロードなどのアトミックおよび同期的な変更を適用するためのメカニズムを提供します。RecognizerUpdateReached events provide a mechanism for pausing a speech recognition engine to apply atomic and synchronous modifications, such as loading and unloading grammars.

アプリケーションがインスタンスを使用して認識を管理している場合は、 SpeechRecognitionEngine いずれかのメソッドを使用して、 SpeechRecognitionEngine.RequestRecognizerUpdate エンジンが更新プログラムを受信するのを一時停止するように要求できます。If your application is using a SpeechRecognitionEngine instance to manage recognition, it can use one of the SpeechRecognitionEngine.RequestRecognizerUpdate methods to request that the engine pauses to receive an update. インスタンスは、 SpeechRecognitionEngine SpeechRecognitionEngine.RecognizerUpdateReached 更新の準備ができたときにイベントを発生させます。The SpeechRecognitionEngine instance raises a SpeechRecognitionEngine.RecognizerUpdateReached event when it is ready for the update.

SpeechRecognitionEngineインスタンスが一時停止されている間に、オブジェクトの読み込み、アンロード、有効化、および無効化を行ったり、 Grammar 、、の各プロパティの値を変更したりでき BabbleTimeout InitialSilenceTimeout EndSilenceTimeout ます。While a SpeechRecognitionEngine instance is paused, you can load, unload, enable, and disable Grammar objects, and modify values for the BabbleTimeout, InitialSilenceTimeout, and EndSilenceTimeout properties.

アプリケーションがインスタンスを使用して認識を管理している場合は、 SpeechRecognizer いずれかのメソッドを使用して、 SpeechRecognizer.RequestRecognizerUpdate エンジンが更新プログラムを受信するのを一時停止するように要求できます。If your application is using a SpeechRecognizer instance to manage recognition, it can use one of the SpeechRecognizer.RequestRecognizerUpdate methods to request that the engine pauses to receive an update. インスタンスは、 SpeechRecognizer SpeechRecognizer.RecognizerUpdateReached 更新の準備ができたときにイベントを発生させます。The SpeechRecognizer instance raises a SpeechRecognizer.RecognizerUpdateReached event when it is ready for the update.

SpeechRecognizerインスタンスが一時停止されている間は、オブジェクトの読み込み、アンロード、有効化、および無効化を行うことができ Grammar ます。While a SpeechRecognizer instance is paused, you can load, unload, enable, and disable Grammar objects.

イベントとイベントを処理するとき SpeechRecognitionEngine.RecognizerUpdateReached SpeechRecognizer.RecognizerUpdateReached 、認識エンジンは、イベントハンドラーが戻るまで一時停止します。When handling SpeechRecognitionEngine.RecognizerUpdateReached and SpeechRecognizer.RecognizerUpdateReached events, a recognition engine pauses until the event handler returns.

RecognizerUpdateReachedEventArgs は、EventArgs から派生します。RecognizerUpdateReachedEventArgs derives from EventArgs.

プロパティ

AudioPosition

イベントに関連付けられているオーディオの位置を取得します。Gets the audio position associated with the event.

UserToken

アプリケーションが RequestRecognizerUpdate または RequestRecognizerUpdate を呼び出すときにシステムに渡される UserToken を取得します。Gets the UserToken passed to the system when an application calls RequestRecognizerUpdate or RequestRecognizerUpdate.

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください