Grammar クラス

定義

アプリケーションが音声認識の制約を定義するために使用できる、音声認識の文法を参照するランタイム オブジェクト。

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
継承
Grammar
派生

次の例では、 Grammar XML ファイル (cities.xml) で定義された音声認識文法から オブジェクトを作成します。 cities.xml ファイルの内容は、次の XML の例に示されています。

// Load a cities grammar from a local file and return the grammar object.   
private static Grammar CreateGrammarFromFile()  
{  
  Grammar citiesGrammar = new Grammar(@"c:\temp\cities.xml");  
  citiesGrammar.Name = "SRGS File Cities Grammar";  
  return citiesGrammar;  
}  
<?xml version="1.0" encoding="UTF-8" ?>  
<grammar version="1.0" xml:lang="en-US"  
         xmlns="http://www.w3.org/2001/06/grammar"  
         tag-format="semantics/1.0" root="Main">  

  <!-- cities.xml:   
    Defines an SRGS grammar for requesting a flight. This grammar includes  
    a Cities rule that lists the cities that can be used for departures  
    and destinations. -->  

  <rule id="Main">  
    <item>  
      I would like to fly from <ruleref uri="#Cities"/>  
      to <ruleref uri="#Cities"/>  
    </item>  
  </rule>  

  <rule id="Cities" scope="public">  
    <one-of>  
      <item> Seattle </item>  
      <item> Los Angeles </item>  
      <item> New York </item>  
      <item> Miami </item>  
    </one-of>  
  </rule>  
</grammar>  

注釈

音声認識文法は、音声認識エンジンが意味のある入力として認識できる内容を定義する一連のルールまたは制約です。 音声認識文法の作成と使用の詳細については、「 音声認識」およびSrgsGrammar を使用して文法を作成する」を参照してください。

文法を作成したら、音声認識エンジンが読み込むことができるオブジェクトに文法を組み込 Grammar み、アプリケーションが実行時に音声認識を管理するために使用できるようにする必要があります。 コンストラクターをGrammar使用して、 または SrgsDocument オブジェクト、GrammarBuilderまたはサポートされている形式の文法の説明を含むファイルまたは からStreamインスタンスを作成Grammarできます。 サポートされている形式は次のとおりです。

引数で XML 形式の文法ファイルを受け入れる文法コンストラクターは、XML 文法をバイナリ形式にコンパイルして、音声認識エンジンによる読み込みと使用を最適化します。 いずれかのメソッドを使用して事前に文法を Grammar コンパイルすることで、XML 形式の文法からオブジェクトを構築するために必要な時間を Compile 短縮できます。

または SpeechRecognitionEngine オブジェクトによって管理されるSpeechRecognizerアプリケーションの音声認識エンジンは、複数の音声認識文法を読み込むことができます。 アプリケーションでは、 プロパティを設定Enabledして個々の文法を個別に有効または無効にしたり、プロパティや プロパティなどのプロパティを使用してGrammar認識動作をPriorityWeight変更したりできます。

文章校正の SpeechRecognized イベントは、入力が文法のパスと一致すると発生します。

注意

オブジェクトの構築 Grammar に使用される URI または DLL の安全性を確認することをお勧めします。

Windows と Speech プラットフォームは、DLL またはスクリプトをサポートする文法からインスタンスを Grammar 構築するアプリケーションにセキュリティを提供します。

オブジェクト内の Grammar スクリプトは、 の Web ページからダウンロードした場合と同様に常に実行されます Internet Zone。 共通言語ランタイム (CLR) は、読み込まれた DLL を分離して文法定義を取得します。

コンストラクター

Grammar()

Grammar クラスの新しいインスタンスを初期化します。

Grammar(GrammarBuilder)

Grammar オブジェクトから GrammarBuilder クラスの新しいインスタンスを初期化します。

Grammar(SrgsDocument)

Grammar オブジェクトから SrgsDocument クラスの新しいインスタンスを初期化します。

Grammar(SrgsDocument, String)

オブジェクトから クラスの新しいインスタンスをGrammarSrgsDocument初期化し、ルート規則を指定します。

Grammar(SrgsDocument, String, Object[])

Grammar のインスタンスから SrgsDocument クラスの新しいインスタンスを初期化し、文法へのエントリ ポイントである規則の名前を指定します。

Grammar(SrgsDocument, String, Uri)

オブジェクトから クラスの新しいインスタンスをGrammarSrgsDocument初期化し、ルート ルールを指定し、相対ルール参照を解決するための基本の Uniform Resource Identifier (URI) を定義します。

Grammar(SrgsDocument, String, Uri, Object[])

Grammar のインスタンスから SrgsDocument クラスの新しいインスタンスを初期化し、文法へのエントリ ポイントである規則の名前と、相対参照を解決するためのベース URI を指定します。

Grammar(Stream)

Grammar から Stream クラスの新しいインスタンスを初期化します。

Grammar(Stream, String)

Grammar と指定したルート ルールから Stream クラスの新しいインスタンスを初期化します。

Grammar(Stream, String, Object[])

Grammar と指定したルート ルールから Stream クラスの新しいインスタンスを初期化します。

Grammar(Stream, String, Uri)

ストリームから Grammar クラスの新しいインスタンスを初期化し、ルート規則を指定して、相対的な規則の参照を解決するためのベース URI (Uniform Resource Identifier) を定義します。

Grammar(Stream, String, Uri, Object[])

Grammar クラスの新しいインスタンス Stream を初期化し、ルート規則および相対参照を解決するためのベース URI を指定します。

Grammar(String)

ファイルから Grammar クラスの新しいインスタンスを初期化します。

Grammar(String, String)

ファイルから Grammar クラスの新しいインスタンスを初期化し、ルート ルールを指定します。

Grammar(String, String, Object[])

文法定義を含むファイルから Grammar クラスの新しいインスタンスを初期化し、文法へのエントリ ポイントであるルールの名前を指定します。

プロパティ

Enabled

音声認識エンジンが Grammar を使用して認識を実行できるかどうかを制御する値を取得または設定します。

IsStg

文法が厳密に型指定されているかどうかを取得します。

Loaded

Grammar が音声認識エンジンによって読み込まれたかどうかを取得します。

Name

Grammar オブジェクトの名前を取得または設定します。

Priority

Grammar オブジェクトの優先順位の値を取得または設定します。

ResourceName

現在の Grammar を読み込むために使用されたバイナリ リソースの名前を示す値を取得または設定します。

RuleName

Grammar オブジェクトのルート規則またはエントリ ポイントの名前を取得します。

Weight

Grammar オブジェクトの重さの値を取得または設定します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
LoadLocalizedGrammarFromType(Type, Object[])

LoadLocalizedGrammarFromType メソッドは、Grammar から派生する Type オブジェクトのローカライズ インスタンスを返します。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
StgInit(Object[])

StgInit メソッドは、厳密に型指定された文法を初期化します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

イベント

SpeechRecognized

音声認識エンジンが Grammar オブジェクトを使用して認識を実行するときに発生します。

適用対象

こちらもご覧ください