GrammarBuilder コンストラクター

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

ソース:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder();

Public Sub New ()

例

次の例では、 GrammarBuilder オブジェクトと Choices オブジェクトを使用して、"Make background colorChoice" または "Set background to colorChoice" の 2 つの語句のいずれかを認識できる文法を構築します。

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

この例では、最後に、Choices オブジェクトから構築されたGrammarBuilderから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 オブジェクトにルールを追加するには、 Add、 Append、 AppendDictation、 AppendRuleReference、および AppendWildcard メソッド、および Addition 演算子を使用します。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

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)

パラメーター

例

次の例では、 GrammarBuilder オブジェクトと Choices オブジェクトを使用して、"Make background colorChoice" または "Set background to colorChoice" の 2 つの語句のいずれかを認識できる文法を構築します。

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

この例では、最後に、Choices オブジェクトから構築されたGrammarBuilderから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

ソース:

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)

パラメーター

例

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

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

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

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)の例を参照し、SemanticResultValueとSemanticResultKeyも参照してください。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

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)

パラメーター

例

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

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

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

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)の例を参照し、SemanticResultValueとSemanticResultKeyも参照してください。

こちらもご覧ください

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

ソース:

GrammarBuilder.cs

ソース:

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)

パラメーター

例

次の例では、 GrammarBuilder オブジェクトと Choices オブジェクトを使用して、"Make background colorChoice" または "Set background to colorChoice" の 2 つの語句のいずれかを認識できる文法を構築します。

Choices オブジェクトを使用して colorChoice に許容される値のリストを作成した後、この例では、引数として文字列を使用して、makePhraseとsetPhraseの 2 つの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.
  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

ソース:

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 5 6 7" の場合、サブシーケンス文法は入力 "two three four" を認識しますが、入力 "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」を参照してください。 文字列を含む音声認識文法の構築の詳細については、「 文字列を使用して GrammarBuilder 文法を作成する」を参照してください。

こちらもご覧ください

• SubsetMatchingMode

ソース:

GrammarBuilder.cs

ソース:

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

注釈

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

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

こちらもご覧ください

• Choices
• Grammar

ソース:

GrammarBuilder.cs

ソース:

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

注釈

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

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

こちらもご覧ください

• Choices
• Grammar