ListenComplete 事件

[自 Windows 7 起弃用 Microsoft Agent,在后续版本的 Windows 中可能不可用。]

描述

侦听模式(语音识别)结束时出现。

语法

Sub agent.ListenComplete (ByValCharacterID, ByValCause)**

组成部分 说明
CharacterID 以字符串形式返回侦听字符的 ID。
原因 以整数的形式返回完整事件的原因,而该整数可能为下列值之一:1 - 程序代码已关闭侦听模式。
2 - 侦听模式(由程序代码打开)已超时。
3 - 侦听模式(由“侦听”键打开)已超时。
4 - 侦听模式已关闭,因为用户已释放“侦听”键。
5 - 侦听模式已结束,因为用户已说完。
6 - 侦听模式已终止,因为输入活动客户端已被停用。
7 - 侦听模式已结束,因为默认字符已更改。
8 - 侦听模式已结束,因为用户已禁用语音输入。

注解

用户释放“侦听”键后,如果输入活动客户端使用 False 来调用 Listen 方法或是用户已说完,则当侦听模式超时结束时会将此事件发送到所有客户端。 可使用此事件来确定何时恢复字符朗读(音频)输出。

如果使用 Listen 方法打开了侦听模式,然后用户按下“侦听”键,侦听模式则会重置并继续,直到“侦听”键超时完成、释放“侦听”键或用户完成说话(以较迟者为准)。 在此情况下,在“侦听”键的模式完成之前,不会收到 ListenComplete 事件。

该事件会将该字符返回到当前已加载此字符的客户端。 所有其他客户端均会收到空字符(空字符串)。

另请参阅

ListenStart 事件Listen 方法