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