音声コマンド定義 (VCD) の要素および属性 v1.1

CommandSet 要素の必須の子要素。

Name 属性を取得 します 。 ユーザーが話すことによって開始できるアプリ アクションと、ユーザーがアクションを開始するために何を言うことができるかを定義します。 各 Command 要素は、アプリ内の特定のページに関連付けることができます。 次の必須の子要素が含まれます。 例 (正確には 1)、 ListenFor (1 から 10)、 Feedback (正確には 1)、 Navigate (正確には 1)。 これらの子要素は、一覧表示されている順序で行う必要があります。

Command 要素の必須 (1 から 10) の子要素。

このコマンドに対してアプリで認識される単語または語句が含まれます。 これには、中かっこで囲まれた ListenFor 要素に表示される PhraseList (または PhraseTopic) 要素の Label 属性 ({myList}、{myTopic} など) への参照が含まれる場合があります。

ListenFor 要素の内容を認識して、コマンドをアクティブ化できます。

省略可能な単語または単語の周りに角かっこを使用します。 つまり、単語または単語は読み上げられますが、一致する必要はありません。 たとえば、「 <ListenFor>[Show] {options}</ListenFor> 」のように入力します。

などの中かっこのペア内にアスタリスク文字を含めることで、 <ListenFor> Find {*} </ListenFor>ワイルドカード機能を設定できます。 この例では、ユーザーが "検索" と読み上げ、必要に応じて他の単語または語句が続く限り、音声コマンドは一致します。 ワイルドカードが有効な ListenFor 要素の音声コマンドが一致する場合、 SpeechRecognitionResult.Text プロパティには文字列 "..." が含まれます。をワイルドカードと同じ位置に配置します。

CommandSet 要素の省略可能な子。 1 つの CommandSet 要素には 2,000 個以下の Item 要素を含めることができます。また、2,000 個の Item 要素は、CommandSet 内のすべての PhraseList 要素の合計制限です。 各項目は、PhraseList を参照するコマンドを開始するために認識できる単語または語句を指定します。 Items コンテンツは、アプリケーション内からプログラムによって更新される場合があります。 PhraseList には Label 属性が必要です。この値は、ListenFor 要素または Feedback 要素内で中かっこで囲んで表示され、PhraseList を参照するために使用されます。

PhraseList には省略可能な あいまいさを 解消する属性 (既定値は true) があり、リストの複数の項目が同時に認識されたときに、この PhraseList がユーザーのあいまいさを解消するかどうかを指定します。 false の場合、この PhraseList は Feedback 要素内からも使用できず、アプリケーションのパラメーターは生成されません。 これは、同じことを言う別の方法ですが、特定のアクションを必要としないフレーズに役立ちます。

アプリで、リストのどのフレーズが読み上げられたかを調べるには、PhraseList の Label と同じ値を持つキーを使用して SpeechRecognitionSemanticInterpretation.Properties ディクショナリにアクセスできます。

CommandSet 要素の省略可能な子。 大規模なボキャブラリ認識のトピックを指定します。 トピックでは、シナリオに 1 つの (0 または 1) シナリオ 属性と複数の (0 から 20) Subject 子要素を指定できます。これは、達成された認識の関連性を向上させるために使用できます。 PhraseTopic には Label 属性が必要です。この値は、ListenFor 要素または Feedback 要素内で中かっこで囲んで表示され、PhraseTopic を参照するために使用されます。

Scenario 属性 (既定の "Dictation") は、この PhraseTopic の目的のシナリオを指定します。このシナリオでは、PhraseTopic を使用して音声コマンドの基になる音声認識を最適化し、コマンドの目的のコンテキストに適した結果を生成できます。 有効な値は、"自然言語"、"検索"、"短いメッセージ"、"ディクテーション"、"コマンド"、および "フォームの入力" です。

Subject 子要素は、親 PhraseTopic の Scenario 属性に固有の件名を指定し、PhraseTopic を使用して音声コマンド内の音声認識結果の関連性をさらに絞り込みます。 サブジェクトは指定された順序で評価され、必要に応じて、後で指定されたサブジェクトは、以前に指定されたものを制約します。 有効な内部テキスト値は、"Date/Time"、"Addresses"、"City/State"、"Person Names"、"Movies"、"Music"、および "Phone Number" です。 例: <Subject>Phone Number</Subject>

アプリで、PhraseTopic 参照で表される ListenFor 要素のサブセットで読み上げられたコンテンツを調べるには、PhraseTopic の Label と同じ値を持つキーを使用して SpeechRecognitionSemanticInterpretation.Properties ディクショナリにアクセスできます。