Command イベント

[Microsoft Agent は Windows 7 の時点で非推奨となり、後続のバージョンの Windows では使用できない可能性があります。]

説明

ユーザーが (クライアントの) コマンドを選択したときに発生します。

構文

Sub agent_Command (ByVal UserInput**)**

部分

説明

UserInput

サーバーによって返される Command オブジェクトを識別します。 Command オブジェクトから次のプロパティにアクセスできます。 CharacterID コマンドを受け取ったキャラクターの名前 (ID) を識別する文字列値。 名前 コマンドの名前 (ID) を識別する文字列値。 信頼度 コマンドの信頼度スコアリングを示す長整数値。 音声 コマンドの音声テキストを識別する文字列値。 Alt1Name 次の (2 番目の) 最適なコマンドの名前を識別する文字列値。 Alt1Confidence 次の (2 番目の) 最適なコマンドの信頼度スコアリングを示す長整数値。 Alt1Voice 次に最適な代替コマンド一致の音声テキストを識別する文字列値。 Alt2Name 3 番目に最適なコマンド一致の名前を識別する文字列値。 Alt2Confidence 3 番目に最適なコマンド一致の信頼度スコアリングを識別する長整数。 Alt2Voice 3 番目に最適なコマンド一致の音声テキストを識別する文字列値。 Count 返される代替の数を示す長整数。

解説

アプリケーションが入力アクティブであり、ユーザーが音声入力またはキャラクターのポップアップ メニューでコマンドを選択すると、サーバーからこのイベントが通知されます。 イベントは、 Count で使用可能な一致するコマンドの数に加え、それらの一致の名前、信頼度スコアリング、音声テキストを返します。

音声入力によってこのイベントがトリガーされた場合、サーバーは、 Name パラメーターで最適な一致を識別する文字列と、Alt1Name と Alt2Name の 2 番目と 3 番目に一致する文字列を返します。 空の文字列は、入力がアプリケーションで定義されたコマンドと一致しなかったことを示します。たとえば、サーバーで定義されているコマンドのいずれかです。 コマンドがエージェントのコマンドと一致した場合。たとえば、Hide では Name パラメーターで空の文字列が返されますが、この場合でも Voice パラメーターで読み上げられたテキストを受け取ります。

複数のエントリで同じコマンド名が返される場合があります。 Confidence、Alt1Confidence、および Alt2Confidence の各パラメーターは、それぞれの一致ごとに音声認識エンジンによって返される、-100 から 100 の範囲の相対スコアを返します。 Voice、Alt1Voice、および Alt2Voice の各パラメーターは、音声認識エンジンが代替手段ごとに一致した音声テキストを返します。 Count がゼロ (0) を返した場合、サーバーは音声入力を検出しましたが、一致するコマンドがないと判断しました。

音声入力がコマンドのソースではなかった場合 (たとえば、ユーザーがキャラクターのポップアップ メニューからコマンドを選択した場合)、サーバーは Name プロパティで選択したコマンドの名前 (ID) を返します。 また、Confidence パラメーターの値を 100 として返し、Voice パラメーターの値を空の文字列 ("") として返します。 Alt1Name と Alt2Name も空の文字列を返します。 Alt1Confidence と Alt2Confidence はゼロ (0) を返し、Alt1Voice と Alt2Voice は空の文字列を返します。 Count は 1 を返します。

Note

すべての音声認識エンジンがこのイベントのすべてのパラメーターのすべての値を返すわけではありません。 エンジン ベンダーに問い合わせて、エンジンが代替手段と信頼度スコアを返すために Microsoft Speech API インターフェイスをサポートしているかどうかを確認してください。