侦听方法

[由于 Windows 7,Microsoft 代理已弃用,并且可能在 Windows 的后续版本中不可用。]

Description

打开侦听模式 (语音识别) 一段时间。

语法

*代理. 个字符 * * * * ( "CharacterID" ) 。侦听 * 状态

组成部分 描述
状态 必需。 确定是否打开或关闭侦听模式的布尔值。 True 启用 "侦听模式"。
False 关闭侦听模式。

备注

将此方法设置为 True 可启用侦听模式, (在) 一段固定的 (时间内启用语音识别,) 。 尽管无法设置超时值,但可以在超时过期之前关闭侦听模式。 如果 (或另一个客户端) 成功设置了侦听模式,并且在超时到期之前尝试将此属性设置为 True ,则该方法将成功并重置超时。但是,如果侦听模式为 on,因为用户正在按侦听键,则该方法将会成功,但会忽略超时,并且侦听模式将基于用户与侦听密钥的交互而结束。

此方法仅在由输入活动的客户端调用并且已启动语音服务时才会成功。 若要确保语音服务已启动,请在调用 侦听 之前查询或设置 SRModeID或设置 命令语音设置,否则方法将失败。 若要检测此方法是否成功,请将其作为函数调用,它将返回一个布尔值,指示该方法是否成功。

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

   Else
      ' The method failed

   End If

如果用户正在按侦听键,并且尝试将 " 侦听 " 设置为 " False",则此方法也会失败。 但是,如果用户已发布侦听密钥和侦听模式,则会成功。

如果没有与字符的 LanguageID设置匹配的兼容语音引擎,用户已使用 Microsoft 代理属性表禁用了语音输入,或者音频设备处于繁忙状态,则 侦听 也会失败。

成功将此方法设置为 True 后,服务器将触发 ListenStart 事件。 当侦听模式超时完成或将 "侦听" 设置为 " False" 时,服务器将发送 ListenComplete

当按下侦听键时,此方法不会自动调用 停止 并播放侦听状态动画。 这使你可以通过调用 Stop 并播放自己的适当动画来确定是否要使用 ListenStart动画中断当前动画。 但是,在检测到用户查询文本时,服务器调用 停止 并播放听觉状态动画。

另请参阅

LanguageID 属性ListenComplete 事件ListenStart 事件