Command 事件

[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]

說明

發生於使用者選擇 （用戶端的） 命令時。

語法

Subagent_Command（ByValUserInput**）**

部分	描述
UserInput	識別伺服器所傳回的 Command 物件。 您可以從 Command 物件存取下列屬性： CharacterID 字串值，識別接收命令之字元的名稱（ID）。 名稱 識別命令名稱 （ID） 的字串值。 信賴度 指出命令信賴評分的Long整數值。 語音 辨識命令語音文字的字串值。 Alt1Name 識別下一個 （秒） 最佳命令名稱的字串值。 Alt1Confidence 長整數值，表示下一個 （秒） 最佳命令的信賴評分。 Alt1Voice 字串值，識別下一個最佳替代命令比對的語音文字。 Alt2Name 識別第三個最佳命令比對名稱的字串值。 Alt2Confidence Long 整數，識別第三個最佳命令比對的信賴評分。 Alt2Voice 字串值，識別第三個最佳命令比對的語音文字。 Count 長整數值，表示傳回的替代項目數目。

備註

當應用程式處於輸入作用中狀態，且使用者透過語音輸入或字元的快捷功能表選擇命令時，伺服器會通知您此事件。 事件會傳回 Count 中可能的比對命令數目，以及這些相符專案的名稱、信賴評分和語音文字。

如果語音輸入觸發此事件，伺服器會傳回字串，以識別 Name 參數中的最佳相符專案，以及 Alt1Name 和 Alt2Name 中的第二和第三名相符專案。 空字串表示輸入不符合應用程式所定義的任何命令;例如，它可以是其中一個伺服器定義的命令。 如果命令與 Agent 的命令相符;例如，Hide 會在 Name 參數中傳回空字串，但您仍會收到 Voice 參數中聽到的文字。

您可能會在多個專案中取得傳回的相同命令名稱。 Confidence、Alt1Confidence 和 Alt2Confidence 參數會傳回相對分數，範圍介於 -100 到 100 之間，由語音辨識引擎針對每個相符專案傳回。 Voice、Alt1Voice 和 Alt2Voice 參數會傳回語音辨識引擎針對每個替代專案相符的語音文字。 如果 Count 傳回零 （0），則伺服器偵測到口語輸入，但判斷沒有相符的命令。

例如，如果使用者從字元的彈出視窗中選取命令，則伺服器會傳回 Name 屬性中所選取命令的名稱（ID）。 它也會以 100 傳回 Confidence 參數的值，並將 Voice 參數的值當做空字串 （“” ） 傳回。 Alt1Name 和 Alt2Name 也會傳回空字串。 Alt1Confidence 和 Alt2Confidence 會傳回零 （0），而 Alt1Voice 和 Alt2Voice 會傳回空字串。 Count 會傳回 1。