Listen メソッド
[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]
-
Description
-
一定期間のリスニング モード (音声認識) をオンにします。
-
構文
-
エージェント。文字("CharacterID")。Listen** State
パーツ 説明 状態 必須。 リッスン モードを有効または無効にするかどうかを決定するブール値。 True リスニング モードをオンにします。
False リスニング モードをオフにします。
解説
このメソッドを True に設定すると、一定の期間 (10 秒) のリッスン モード (音声認識が有効になります) が有効になります。 タイムアウトの値を設定することはできませんが、タイムアウトが切れる前にリッスン モードをオフにできます。 ユーザー (または別のクライアント) がリッスン モードを正常にオンにし、タイムアウトの期限が切れる前にこのプロパティを True に 設定しようとすると、メソッドは成功し、タイムアウトをリセットします。ただし、ユーザーが Listening キーを押しているためにリッスン モードがオンになっている場合、メソッドは成功しますが、タイムアウトは無視され、リッスン キーとのユーザーの操作に基づいてリッスン モードが終了します。
このメソッドは、入力アクティブなクライアントによって呼び出された場合、および音声サービスが開始されている場合にのみ成功します。 音声サービスが開始されていることを確認するには、Listen を呼び出す前に SRModeID を照会または設定するか、Command の音声設定を設定します。そうしないと、メソッドは失敗します。 このメソッドの成功を検出するには、関数として呼び出し、メソッドが成功したかどうかを示すブール値を返します。
If Genie.Listen(True) Then
'The method succeeded
Else
' The method failed
End If
ユーザーがリッスン キーを押していて、 Listen を False に設定しようとすると、メソッドも失敗 します。 ただし、ユーザーがリッスン キーを解放し、リッスン モードがタイムアウトしていない場合は、成功します。
また、文字の LanguageID 設定に一致する互換性のある音声エンジンがない場合、ユーザーが Microsoft Agent プロパティ シートを使用して音声入力を無効にしているか、オーディオ デバイスがビジー状態の場合も、リッスンは失敗します。
このメソッドを True に正常に設定すると、サーバーによって ListenStart イベントがトリガーされます。 リッスン モードのタイムアウトが完了したとき、または Listen を False に設定すると、サーバーは ListenComplete を送信します。
このメソッドは、 Stop を自動的に呼び出し、リッスンキーが押されたときにサーバーが行うリッスン状態アニメーションを再生しません。 これにより、Stop を呼び出して独自の適切なアニメーションを再生することで、ListenStart アニメーションを使用して現在のアニメーションを中断するかどうかを決定できます。 ただし、サーバーは Stop を呼び出し、ユーザーの発話が検出されたときにヒアリング状態アニメーションを再生します。