共用方式為


IAgentUserInput::GetAllItemData

[從 Windows 7 開始,Microsoft Agent 已被取代,而且在後續版本的 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回呼之命令識別碼的變數位址。

plConfidences

接收傳遞至IAgentNotifySink::Command回呼之命令替代專案信賴分數的變數位址。

pbszText

接收傳遞至IAgentNotifySink::Command回呼之命令替代專案的語音文字的變數位址。

如果語音輸入觸發 IAgentNotifySink::Command,則伺服器會傳回最佳比對、第二個最符合專案,以及語音引擎所提供的第三個最佳比對。 它提供相對信賴分數,範圍介於 -100 到 100,語音引擎會「聽到」實際文字。 如果最符合的是伺服器提供的命令,伺服器會傳送 Null 識別碼,但仍會傳送信賴分數和 語音 文字。

如果語音輸入不是事件的來源;例如,如果使用者從字元的快顯功能表選取命令,則 Microsoft Agent 伺服器會傳 回所選取 命令的識別碼,信賴分數為 100,且語音文字為 Null。 其他替代方案會以 Null 傳回,信賴分數為 0 (0) ,而語音文字則傳回為 Null。

注意

並非所有語音辨識引擎都可能會傳回此事件所有參數的所有值。 請洽詢您的引擎廠商,以判斷引擎是否支援 Microsoft 語音 API 介面來傳回替代專案和信賴分數。

 

另請參閱

IAgentUserInput::GetItemConfidenceIAgentUserInput::GetItemTextIAgentUserInput::GetItemID