Grammar クラス

リファレンス

定義

名前空間:: System.Speech.Recognition

アセンブリ:: System.Speech.dll

パッケージ:: System.Speech v8.0.0

パッケージ:: System.Speech v9.0.0-rc.1.24431.7

ソース:: Grammar.cs

ソース:: Grammar.cs

ソース:: Grammar.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class Grammar

public class Grammar

type Grammar = class

Public Class Grammar

継承: Object
Grammar

派生: System.Speech.Recognition.DictationGrammar

例

次の例では、 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できます。サポートされている形式は次のとおりです。

W3C 音声認識文法仕様 (SRGS) バージョン 1.0 に準拠する XML 形式のファイル
.cfg ファイル拡張子を持つバイナリファイルにコンパイルされた文法

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

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

文章校正の 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)	オブジェクトからクラスの新しいインスタンスをGrammar SrgsDocument初期化し、ルート規則を指定します。
Grammar(SrgsDocument, String, Object[])	Grammar のインスタンスから SrgsDocument クラスの新しいインスタンスを初期化し、文法へのエントリポイントである規則の名前を指定します。
Grammar(SrgsDocument, String, Uri)	オブジェクトからクラスの新しいインスタンスをGrammar SrgsDocument初期化し、ルートルールを指定し、相対ルール参照を解決するための基本の 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 オブジェクトを使用して認識を実行するときに発生します。

適用対象

次の方法で共有