GrammarBuilder コンストラクター

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder ();

Public Sub New ()

例

次の例では、 オブジェクトと Choices オブジェクトを使用GrammarBuilderして、"背景色の選択" または "背景を colorChoice に設定" の 2 つの語句のいずれかを認識できる文法を構築します。

この例では、 オブジェクトを Choices 使用して、オブジェクトの配列から colorChoice に許容される値の String リストを作成します。 Choicesオブジェクトは SRGS 仕様のone-of要素に似ていますが、一連の代替フレーズが含まれています。そのうちの 1 つは、読み上げられたときに認識できます。 また、この例では、 オブジェクトを Choices 使用して、2 つの GrammarBuilder オブジェクトの配列を、結果の文法で認識できる代替フレーズのペアにグループ化します。 代替単語または語句はほとんどの文法の構成要素であり Choices 、 オブジェクトは、 で構築された GrammarBuilder文法に対してこの機能を提供します。

この例では、最後に、 オブジェクトから構築された から GrammarBuilder オブジェクトをChoices作成Grammarします。

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the Grammar object from the result.
  GrammarBuilder bothPhrases = new GrammarBuilder();
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  bothPhrases.Append(bothChoices);
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

注釈

既存GrammarBuilderのオブジェクトにルールを追加するには、、AppendRuleReference、および AppendWildcard の各メソッドと 演算子をAddition使用AddAppendAppendDictationします。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);

public GrammarBuilder (System.Speech.Recognition.Choices alternateChoices);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder

Public Sub New (alternateChoices As Choices)

パラメーター

例

次の例では、 オブジェクトと Choices オブジェクトを使用GrammarBuilderして、"背景色の選択" または "背景を colorChoice に設定" の 2 つの語句のいずれかを認識できる文法を構築します。

この例では、 オブジェクトを Choices 使用して、オブジェクトの配列から colorChoice に許容される値の String リストを作成します。 Choicesオブジェクトは SRGS 仕様のone-of要素に似ていますが、一連の代替フレーズが含まれており、そのいずれも読み上げられたときに認識できます。 また、この例では、 オブジェクトを Choices 使用して、2 つの GrammarBuilder オブジェクトの配列を、結果の文法で認識できる代替フレーズのペアにグループ化します。 代替単語または語句はほとんどの文法の構成要素であり Choices 、 オブジェクトは、 で構築された GrammarBuilder文法に対してこの機能を提供します。

この例では、最後に、 オブジェクトから構築された から GrammarBuilder オブジェクトをChoices作成Grammarします。

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

注釈

代替手段を含む音声認識文法の構築の詳細については、「 選択肢を使用して GrammarBuilder 文法を作成する」を参照してください。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);

public GrammarBuilder (System.Speech.Recognition.SemanticResultKey key);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder

Public Sub New (key As SemanticResultKey)

パラメーター

例

次の例では、colorChoice が一連の色から選択されている 2 つの語句 "Make background colorChoice" と "Set background to colorChoice" を認識できる音声認識文法を作成します。 文法を使用すると、ユーザーはいくつかの色名のいずれかを話し、認識された色名に関するセマンティック情報をアプリケーションに返します。

この例では、ユーザーが話す色に関連付けられている をSemanticValue取得できる 1 つSemanticResultKeyを使用します。 たとえば、入力に "背景を赤に設定する" という語句が含まれている場合、認識結果には "#FF0000" というセマンティック値が含まれます。この値は、イベントのハンドラー SpeechRecognized を使用して取得できます。

この例では、、、、および オブジェクトを使用Stringして、bothPhrases最後GrammarBuilderの オブジェクト に含まれるすべての制約を作成します。GrammarBuilderSemanticResultValueSemanticResultKeyChoices 最後に、この例では、完成した GrammarGrammarBuilderから オブジェクトを構築します。

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices object for the two alternative phrases.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the Grammar object from the GrammarBuilder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

注釈

オブジェクトからSemanticResultValueインスタンスをGrammarBuilder作成する場合は、認識結果で返すことができるセマンティック情報を文法に追加します。 イベントのハンドラーで使用できる の RecognizedPhraseプロパティをSemantics使用して、認識結果のセマンティック情報にSpeechRecognizedアクセスできます。 が GrammarBuilder を SemanticResultKey定義している場合、これを使用して、キーに関連付けられている認識結果のセマンティック情報を取得できます。 の例Append(SemanticResultKey)を参照し、 と SemanticResultKeyも参照してくださいSemanticResultValue。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);

public GrammarBuilder (System.Speech.Recognition.SemanticResultValue value);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder

Public Sub New (value As SemanticResultValue)

パラメーター

例

次の例では、colorChoice が一連の色から選択されている 2 つの語句 "Make background colorChoice" と "Set background to colorChoice" を認識できる音声認識文法を作成します。 文法を使用すると、ユーザーはいくつかの色名のいずれかを話し、認識された色名に関するセマンティック情報をアプリケーションに返します。

この例では、ユーザーが話す色に関連付けられている をSemanticValue取得できる 1 つSemanticResultKeyを使用します。 たとえば、入力に "背景を赤に設定する" という語句が含まれている場合、認識結果には "#FF0000" というセマンティック値が含まれます。この値は、イベントのハンドラー SpeechRecognized を使用して取得できます。

この例では、、、、および オブジェクトを使用Stringして、bothPhrases最後GrammarBuilderの オブジェクト に含まれるすべての制約を作成します。GrammarBuilderSemanticResultValueSemanticResultKeyChoices 最後に、この例では、完成した GrammarGrammarBuilderから オブジェクトを構築します。

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the grammar from the grammar builder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

注釈

オブジェクトからSemanticResultValueインスタンスをGrammarBuilder作成する場合は、認識結果で返すことができるセマンティック情報を文法に追加します。 イベントのハンドラーで使用できる の RecognizedPhraseプロパティをSemantics使用して、認識結果のセマンティック情報にSpeechRecognizedアクセスできます。 が GrammarBuilder を SemanticResultKey定義している場合、これを使用して、キーに関連付けられている認識結果のセマンティック情報を取得できます。 の例Append(SemanticResultKey)を参照し、 と SemanticResultKeyも参照してくださいSemanticResultValue。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase);

public GrammarBuilder (string phrase);

new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String)

パラメーター

例

次の例では、 オブジェクトと Choices オブジェクトを使用GrammarBuilderして、"背景色の選択" または "背景を colorChoice に設定" の 2 つの語句のいずれかを認識できる文法を構築します。

オブジェクトを使用して colorChoice に許容される値のリストをChoices作成した後、引数として文字列を使用して、 と setPhraseの 2 つのGrammarBuilderオブジェクトmakePhraseを初期化します。

この例では、最後にオブジェクトに Grammar キャストされた Choices オブジェクトから オブジェクトを GrammarBuilder 作成します。

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the Grammar object from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

注釈

語句は、音声認識文法で認識できる正確な音声フレーズを表します。 文字列を含む音声認識文法の構築の詳細については、「Using Strings to Create a GrammarBuilder Grammar」を参照してください。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);

public GrammarBuilder (string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);

new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

パラメーター

例

次の例では、値ごとに SubsetMatchingMode 音声認識文法を作成し、一致モードの文法を選択するための文法を作成します。 の phrase 値が "1 2 3 4 5 6 7" の場合、サブシーケンス文法は入力 "2 つの 3 つの 4" を認識しますが、入力 "1 3 5" は認識しません。 ただし、順序付きサブセット文法では、これらの両方の入力が認識されます。

private static IEnumerable<Grammar>
  CreateMatchingModeGrammars(string phrase)
{
  List<Grammar> grammars = new List<Grammar>(5);

  Choices modeChoice = new Choices();
  Type enumType = typeof(SubsetMatchingMode);
  foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))
  {
    string modeName = Enum.GetName(enumType, mode);
    modeName = BreakAtCaps(modeName);

    GrammarBuilder builder = new GrammarBuilder(phrase, mode);
    Grammar modeGrammar = new Grammar(builder);
    modeGrammar.Name = modeName;
    modeGrammar.Enabled = false;
    grammars.Add(modeGrammar);

    modeChoice.Add(modeName);
  }

  Grammar choiceGrammar = new Grammar(modeChoice);
  choiceGrammar.Name = "choice";
  grammars.Add(choiceGrammar);

  return grammars;
}

// Insert spaces preceding each uppercase letter in a string.
private static string BreakAtCaps(string item)
{
  if (item == null || item.Length == 0)
  {
    return item;
  }

  StringBuilder sb = new StringBuilder(item[0].ToString());
  for (int i = 1; i < item.Length; i++)
  {
    char c = item[i];
    if (char.IsUpper(c))
    {
      sb.Append(" ");
    }
    sb.Append(c);
  }

  return sb.ToString();
}

注釈

パラメーターは phrase 、音声認識文法で認識できる語句を表します。 パラメーターは subsetMatchingMode 、フレーズ全体の認識を成功させるために読み上げることができるフレーズのサブセットを指定します。 これを使用すると、長い名前を持つエントリの一覧を含む文法を作成できます。ユーザーは、アイテムと一致するように名前全体を話す必要はありません。

一致モードの詳細については、「」を参照してください SubsetMatchingMode。 文字列を含む音声認識文法の構築の詳細については、「Using Strings to Create a GrammarBuilder Grammar」を参照してください。

こちらもご覧ください

• SubsetMatchingMode

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);

public GrammarBuilder (System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

パラメーター

例

次の例では、ピザを注文するための音声認識文法を作成します。 これは、省略可能な開始語句で始まり、続いて 1 ~ 4 個のトッピングで始まり、"pizza" という単語で閉じます。

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object from a string array of alternative toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

注釈

の値が 0 の minRepeat 場合、new GrammarBuilder は省略可能な要素を表します。

の minRepeat 値は、0 以上で、 の maxRepeat値以下である必要があります。

こちらもご覧ください

• Choices
• Grammar

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);

public GrammarBuilder (string phrase, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)

パラメーター

例

次の例では、ピザを注文するための音声認識文法を作成します。 これは、省略可能な開始語句で始まり、続いて 1 ~ 4 個のトッピングで始まり、"pizza" という単語で閉じます。

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object with alternatives for toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

注釈

の値が 0 の minRepeat 場合、new GrammarBuilder は省略可能な要素を表します。

の minRepeat 値は、0 以上で、 の maxRepeat値以下である必要があります。 文字列を含む音声認識文法の構築の詳細については、「Using Strings to Create a GrammarBuilder Grammar」を参照してください。

こちらもご覧ください

• Choices
• Grammar