Listen 方法

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

描述

開啟一段時間 (語音辨識) 的接聽模式。

語法

代理。字元 (「CharacterID」) 。接聽** 狀態

部分	描述
State	必要。 布林值，決定是否開啟或關閉接聽模式。 真 開啟 [接聽] 模式。 假 關閉接聽模式。

備註

將這個方法設定為 True 可讓接聽模式 (開啟語音辨識) (10 秒) 。 雖然您無法設定逾時的值，但您可以在逾時到期之前關閉接聽模式。 如果您 (或其他用戶端) 成功設定 [接聽] 模式，而且您嘗試在逾時到期前將此屬性設定為 True ，則方法會成功並重設逾時。不過，如果接聽模式因為使用者按下接聽鍵而開啟，則方法會成功，但會忽略逾時，而接聽模式會根據使用者的接聽金鑰互動結束。

只有在輸入作用中用戶端呼叫且已啟動語音服務時，這個方法才會成功。 若要確保語音服務已啟動，請在呼叫Listen之前查詢或設定SRModeID或設定Command的語音設定，否則方法將會失敗。 若要偵測這個方法的成功，請將它呼叫為函式，並傳回布林值，指出方法是否成功。

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

如果使用者按下 [接聽] 鍵，而且您嘗試將 [接聽 ] 設定為 False，此方法也會失敗。 不過，如果使用者已釋放接聽金鑰，而接聽模式尚未逾時，它將會成功。

如果沒有符合字元LanguageID設定的相容語音引擎，使用者已使用 Microsoft Agent 屬性工作表停用語音輸入，或音訊裝置忙碌中，則接聽也會失敗。

當您成功將這個方法設定為 True時，伺服器會觸發 ListenStart 事件。 當接聽模式逾時完成或設定為False時，伺服器會傳送ListenComplete。

此方法不會自動呼叫 Stop 並播放接聽狀態動畫，因為伺服器會在按下接聽按鍵時執行。 這可讓您藉由呼叫Stop並播放您自己的適當動畫，判斷是否使用ListenStart動畫中斷目前的動畫。 不過，當偵測到使用者語句時，伺服器會呼叫 Stop 並播放聽覺狀態動畫。

另請參閱

LanguageID 屬性、 ListenComplete 事件、 ListenStart 事件