你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Connection 类

参考

用于管理与指定 Recognizer的语音服务的连接的代理类。

默认情况下， Recognizer 在需要时自主管理与服务的连接。类 Connection 为用户提供其他方法，以显式打开或关闭连接并订阅连接状态更改。 Connection 的使用是可选的。它适用于需要根据连接状态微调应用程序行为的情况。用户可以选择调用 open 以手动启动服务连接，然后开始识别与此 Connection关联的。Recognizer 开始识别后，调用 open 或 close 可能会失败。这不会影响识别器或正在进行的识别。连接可能因各种原因而断开，识别器将始终尝试根据需要重新建立连接，以保证正在进行的操作。在所有这些情况下，事件 connected/disconnected 将指示连接状态的更改。

注意

在版本 1.17.0 中更新。

供内部使用的构造函数。

继承: builtins.object

Connection

构造函数

Connection(handle: c_void_p)

参数

名称	说明
handle 必需

方法

close	关闭服务的连接。用户可以选择调用 close 以手动关闭关联的 Recognizer的连接。调用可能会失败，具体取决于的进程 Recognizer状态。但失败不会影响关联的 Recognizer的状态。
from_dialog_service_connector	Connection从指定的对话框服务连接器获取实例。
from_recognizer	Connection从指定的识别器获取实例。
from_speech_synthesizer	Connection从指定的语音合成器获取实例。注意在版本 1.17.0 中添加。
open	开始设置与服务的连接。用户可以选择调用 open 以提前手动设置连接，然后开始 Recognizer 识别与此 Connection关联的。开始识别后，调用 open) 可能会失败，具体取决于的进程状态 Recognizer。但失败不会影响关联的 Recognizer的状态。注意返回时，连接可能尚未就绪。请订阅建立连接时要通知的已连接事件。
set_message_property	将消息中的参数追加到服务。注意此方法不适用于的连接 SpeechSynthesizer。

close

关闭服务的连接。用户可以选择调用 close 以手动关闭关联的 Recognizer的连接。调用可能会失败，具体取决于的进程 Recognizer状态。但失败不会影响关联的 Recognizer的状态。

close()

from_dialog_service_connector

Connection从指定的对话框服务连接器获取实例。

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

参数

名称	说明
dialog_service_connector 必需

from_recognizer

Connection从指定的识别器获取实例。

from_recognizer(recognizer: Recognizer) -> Connection

参数

名称	说明
recognizer 必需

from_speech_synthesizer

Connection从指定的语音合成器获取实例。

注意

在版本 1.17.0 中添加。

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

参数

名称	说明
speech_synthesizer 必需

open

开始设置与服务的连接。用户可以选择调用 open 以提前手动设置连接，然后开始 Recognizer 识别与此 Connection关联的。开始识别后，调用 open) 可能会失败，具体取决于的进程状态 Recognizer。但失败不会影响关联的 Recognizer的状态。

注意

返回时，连接可能尚未就绪。请订阅

建立连接时要通知的已连接事件。

open(for_continuous_recognition: bool)

参数

名称	说明
forContinuousRecognition 必需	指示连接是用于连续识别还是单次识别。如果连接来自 SpeechSynthsizer，则它不起作用。
for_continuous_recognition 必需

set_message_property

将消息中的参数追加到服务。

注意

此方法不适用于的连接 SpeechSynthesizer。

set_message_property(path: str, property_name: str, property_value: str)

参数

名称	说明
path 必需	消息路径。
property_name 必需	要设置的属性名称。
property_value 必需	要设置的属性的值。