Listen 方法
[从 Windows 7 开始,Microsoft 代理已弃用,可能在后续版本的 Windows 中不可用。]
-
Description
-
在一段时间内 (语音识别) 打开侦听模式。
-
语法
-
代理。字符 (“CharacterID”) 。侦听 ** 状态
组成部分 描述 状态 必需。 一个布尔值,用于确定是打开还是关闭侦听模式。 真 打开侦听模式。
假 关闭侦听模式。
备注
将此方法设置为 True 可启用侦听模式, () 打开语音识别) 的固定时间段 (10 秒。 虽然无法设置超时值,但可以在超时到期之前关闭“侦听”模式。 如果 (或其他客户端) 成功设置侦听模式,并且尝试在超时过期之前将此属性设置为 True ,则该方法将成功并重置超时。但是,如果由于用户按 Listening 键而打开“侦听”模式,则该方法会成功,但将忽略超时,并且侦听模式会根据用户与侦听键的交互结束。
仅当输入活动客户端调用并且语音服务已启动时,此方法才会成功。 若要确保语音服务已启动,请在调用“侦听”之前查询或设置命令的 SRModeID 或设置“语音”设置,否则该方法将失败。 若要检测此方法是否成功,请将其作为函数调用,它将返回一个布尔值,该值指示该方法是否成功。
If Genie.Listen(True) Then
'The method succeeded
Else
' The method failed
End If
如果用户按 Listening 键并且您 尝试将 Listening 设置为 False,则该方法也会失败。 但是,如果用户释放了侦听键,并且侦听模式未超时,它将成功。
如果没有与字符的 LanguageID 设置匹配的兼容语音引擎、用户使用 Microsoft 代理属性表禁用了语音输入,或者音频设备正忙,则侦听也会失败。
成功将此方法设置为 True 时,服务器将触发 ListenStart 事件。 当侦听模式超时完成或将 Listen 设置为 False 时,服务器将发送 ListenComplete。
此方法不会像按下侦听键时服务器那样自动调用 Stop 并播放侦听状态动画。 这使你能够通过调用 Stop 并播放你自己的适当动画来确定是否使用 ListenStart 动画中断当前动画。 但是,当检测到用户话语时,服务器会调用 Stop 并播放“听力”状态动画。