IAgentUserInput::GetAllItemData
[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]
HRESULT GetAllItemData(
VARIANT * pdwItemIndices, // address of variable for alternative IDs
VARIANT * plConfidences, // address of variable for confidence scores
VARIANT * pbszText // address of variable for voice text
);
IAgentNotifySink::Command コールバックに渡されるすべてのコマンド代替のデータを取得します。
- 操作が成功したことを示すS_OKを返します。
-
pdwItemIndices
-
IAgentNotifySink::Command コールバックに渡されるコマンドの ID を受け取る変数のアドレス。
-
plConfidences
-
IAgentNotifySink::Command コールバックに渡されるコマンド代替の信頼度スコアを受け取る変数のアドレス。
-
pbszText
-
IAgentNotifySink::Command コールバックに渡されるコマンド代替の音声テキストを受け取る変数のアドレス。
音声入力によって IAgentNotifySink::Command がトリガーされた場合、サーバーは最適一致、2 番目に最適な一致、および 3 番目に最適な一致 (音声エンジンによって提供されている場合) を返します。 -100 ~ 100 の範囲の相対的な信頼度スコアと、音声エンジンによって実際に "聞いた" テキストが提供されます。 最適な一致がサーバー提供のコマンドの場合、サーバーは NULL ID を送信しますが、それでも信頼度スコアと 音声 テキストを送信します。
音声入力がイベントのソースではない場合。たとえば、ユーザーが文字のポップアップ メニューからコマンドを選択した場合、Microsoft エージェント サーバーは選択した コマンド の ID を返し、信頼度スコアは 100、音声テキストは NULL として返します。 他の代替手段では、信頼度スコアが 0 (0) で、音声テキストが NULL として NULL として返されます。
Note
すべての音声認識エンジンが、このイベントのすべてのパラメーターのすべての値を返すわけではありません。 エンジン ベンダーに問い合わせて、代替手段と信頼度スコアを返すためにエンジンが Microsoft Speech API インターフェイスをサポートしているかどうかを確認してください。
参照
IAgentUserInput::GetItemConfidence、 IAgentUserInput::GetItemText、 IAgentUserInput::GetItemID