Share via

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

Connection 类

  • 参考
包:
com.microsoft.cognitiveservices.speech
Maven 项目:
com.microsoft.cognitiveservices.speech:client-sdk:1.34.0
  • java.lang.Object
    • com.microsoft.cognitiveservices.speech.Connection

实现

java.lang.AutoCloseable

public final class Connection
implements java.lang.AutoCloseable

Connection 是一个代理类，用于管理与指定识别器语音服务的连接。 默认情况下，识别器在需要时自主管理与服务的连接。 Connection 类为用户提供其他方法，用于显式打开或关闭连接以及订阅连接状态更改。 Connection 的使用是可选的。 它适用于需要根据连接状态微调应用程序行为的情况。 用户可以选择调用 openConnection () 来手动启动服务连接，然后开始识别与此连接关联的识别器。 开始识别后，调用 openConnection () 或 closeConnection () 可能会失败。 这不会影响识别器或正在进行的识别。 连接可能因各种原因而断开，识别器将始终尝试根据需要重新建立连接，以保证正在进行的操作。 在所有这些情况下，Connected/Disconnected 事件将指示连接状态的更改。 注意：必须调用 close () 才能释放对象持有的基础资源。 在版本 1.17.0 中更新。

字段摘要

修饰符和类型 字段和描述
final EventHandlerImpl<ConnectionEventArgs> connected

Connected 事件，指示识别器已连接到服务。
final EventHandlerImpl<ConnectionEventArgs> disconnected

Disconnected 事件，指示识别器已与服务断开连接。
final EventHandlerImpl<ConnectionMessageEventArgs> messageReceived

MessageReceived 事件指示服务已向客户端发送网络消息。

方法摘要

修饰符和类型 方法和描述
void close()

释放关联的资源。
void closeConnection()

关闭服务的连接。
static Connection fromConversationTranslator(ConversationTranslator conversationTranslator)

从会话翻译器获取 Connection 实例。
static Connection fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector)

从对话框服务连接器获取连接实例。
static Connection fromRecognizer(Recognizer recognizer)

从指定的识别器获取 Connection 实例。
static Connection fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer)

从语音合成器获取 Connection 实例。
void openConnection(boolean forContinuousRecognition)

开始设置与服务的连接。
java.util.concurrent.Future<java.lang.Void> sendMessageAsync(String path, String payload)

向服务发送消息。
void setMessageProperty(String path, String propertyName, String propertyValue)

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

方法继承自 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

字段详细信息

connected

public final EventHandlerImpl connected

Connected 事件，指示识别器已连接到服务。 为了在订阅连接事件后接收连接事件，Connection 对象本身需要处于活动状态。 如果拥有此事件的 Connection 对象已超过其生存期，则不会传递所有订阅的事件。

disconnected

public final EventHandlerImpl disconnected

Disconnected 事件，指示识别器已与服务断开连接。 为了在订阅后接收断开连接的事件，Connection 对象本身需要处于活动状态。 如果拥有此事件的 Connection 对象已超过其生存期，则不会传递所有订阅的事件。

messageReceived

public final EventHandlerImpl messageReceived

MessageReceived 事件指示服务已向客户端发送网络消息。 在版本 1.15.0 中添加。

方法详细信息

close

public void close()

释放关联的资源。 必须调用 close () 才能正确放弃基础资源。

closeConnection

public void closeConnection()

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

fromConversationTranslator

public static Connection fromConversationTranslator(ConversationTranslator conversationTranslator)

从会话翻译器获取 Connection 实例。

Parameters:

conversationTranslator - 与连接关联的 conversationTranslator。

Returns:

识别器的连接实例。

fromDialogServiceConnector

public static Connection fromDialogServiceConnector(DialogServiceConnector dialogServiceConnector)

从对话框服务连接器获取连接实例。

Parameters:

dialogServiceConnector - 与连接关联的对话服务连接器，用于观察和管理语音服务的连接状态。

Returns:

对话框服务连接器的连接实例。

fromRecognizer

public static Connection fromRecognizer(Recognizer recognizer)

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

Parameters:

recognizer - 与连接关联的识别器。

Returns:

识别器的连接实例。

fromSpeechSynthesizer

public static Connection fromSpeechSynthesizer(SpeechSynthesizer speechSynthesizer)

从语音合成器获取 Connection 实例。 在版本 1.17.0 中添加

Parameters:

speechSynthesizer - 与连接关联的语音合成器，用于观察和管理语音服务的连接状态。

Returns:

语音合成器的连接实例。

openConnection

public void openConnection(boolean forContinuousRecognition)

开始设置与服务的连接。 用户可以选择调用 openConnection () 来提前手动设置连接，然后再开始识别与此连接关联的识别器。 开始识别后，调用 OpenConnection () 可能会失败，具体取决于识别器的进程状态。 但失败不会影响关联的识别器的状态。 注意：返回时，连接可能尚未就绪。 请订阅 Connected 事件，以在建立连接时收到通知。

Parameters:

forContinuousRecognition - 指示连接是用于连续识别还是单次识别。 如果连接来自 SpeechSynthsizer，则它不起作用。

sendMessageAsync

public Future sendMessageAsync(String path, String payload)

向服务发送消息。 在版本 1.7.0 中添加注意：此方法不适用于 SpeechSynthesizer 的连接。

Parameters:

path - 消息路径。
payload - 消息负载。

Returns:

表示发送消息的异步操作的未来。

setMessageProperty

public void setMessageProperty(String path, String propertyName, String propertyValue)

将消息中的参数追加到服务。 在版本 1.7.0 中添加注意：此方法不适用于 SpeechSynthesizer 的连接。

Parameters:

path - 消息路径。
propertyName - 要设置的属性名称。
propertyValue - 要设置的属性的值。

适用于