Connection Klasse

Definition

Namespace:

Microsoft.CognitiveServices.Speech

Assembly:

Microsoft.CognitiveServices.Speech.csharp.dll

Paket:

Microsoft.CognitiveServices.Speech v1.34.0

Eine Proxyklasse zum Verwalten der Verbindung mit dem Sprachdienst der angegebenen Erkennung. In Version 1.2.0 hinzugefügt

public sealed class Connection : IDisposable

type Connection = class
    interface IDisposable

Public NotInheritable Class Connection
Implements IDisposable

Vererbung

Object

Connection

Implementiert

IDisposable

Hinweise

Standardmäßig verwaltet eine Erkennung die Verbindung mit dem Dienst bei Bedarf autonom. Die Connection-Klasse bietet zusätzliche Methoden, die Sie verwenden können, um eine Verbindung explizit zu öffnen oder zu schließen und verbindungs- status Änderungen zu abonnieren. Die Verwendung von Connection ist optional. Es ist für Szenarien vorgesehen, in denen eine Feinabstimmung des Anwendungsverhaltens basierend auf der Verbindung status erforderlich ist. Optional können Sie Open() aufrufen, um eine Dienstverbindung manuell zu initiieren, bevor Sie mit der Erkennung der Erkennung beginnen, die dieser Verbindung zugeordnet ist. Nach dem Starten einer Erkennung schlägt der Aufruf von Open() oder Close() möglicherweise fehl. Dies wirkt sich nicht auf die Erkennung oder die laufende Erkennung aus. Die Verbindung kann aus verschiedenen Gründen getrennt werden. Die Erkennung versucht immer, die Verbindung wie erforderlich neu zu erstellen, um den laufenden Betrieb zu gewährleisten. In all diesen Fällen geben Connected/Disconnected-Ereignisse die Änderung der Verbindung status an.

Methoden

Close()	Schließt die Verbindung des Diensts. Optional können Sie Close() aufrufen, um die Verbindung der zugeordneten Erkennung manuell zu schließen. Der Aufruf kann je nach Prozessstatus der Erkennung fehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand der zugeordneten Erkennung aus.
Dispose()	Entsorgen sie zugeordneter Ressourcen.
Finalize()	Eine Proxyklasse zum Verwalten der Verbindung mit dem Sprachdienst der angegebenen Erkennung. In Version 1.2.0 hinzugefügt
FromConversationTranslator(ConversationTranslator)	Ruft die Verbindungs-instance aus dem Konversationsübersetzungsübersetzung ab.
FromDialogServiceConnector(DialogServiceConnector)	Ruft den Verbindungs-instance aus dem angegebenen Dialogdienstconnector ab, der zum Überwachen und Verwalten der Verbindung und Trennung mit dem Sprachdienst verwendet wird.
FromRecognizer(Recognizer)	Ruft die Verbindungs-instance von der angegebenen Erkennung ab.
FromSpeechSynthesizer(SpeechSynthesizer)	Ruft die Verbindungs-instance aus dem angegebenen Sprachsynthesizer ab, der zum Überwachen und Verwalten der Verbindung und Trennung mit dem Sprachdienst verwendet wird. In Version 1.17.0 hinzugefügt
Open(Boolean)	Beginnt mit dem Einrichten der Verbindung mit dem Dienst. Optional können Sie Open() aufrufen, um eine Verbindung im Voraus manuell einzurichten, bevor Sie mit der Erkennung der Erkennung beginnen, die dieser Verbindung zugeordnet ist. Nach dem Starten der Erkennung kann der Aufruf von Open() abhängig vom Prozessstatus der Erkennung fehlschlagen. Der Fehler wirkt sich jedoch nicht auf den Zustand der zugeordneten Erkennung aus. Hinweis: Bei der Rückgabe ist die Verbindung möglicherweise noch nicht bereit. Abonnieren Sie das Connected-Ereignis, um benachrichtigt zu werden, wenn die Verbindung hergestellt wird.
SendMessageAsync(String, Byte[], UInt32)	Sendet eine binäre Nachricht als asynchronen Vorgang an den Sprachdienst. Hinweis: Diese Methode funktioniert nicht für die Verbindung von SpeechSynthesizer. Hinzugefügt in Version 1.10.0
SendMessageAsync(String, String)	Sendet eine Nachricht als asynchronen Vorgang an den Speech-Dienst. Hinweis: Diese Methode funktioniert nicht für die Verbindung von SpeechSynthesizer. In Version 1.7.0 hinzugefügt
SetMessageProperty(String, String, String)	Fügt einen Parameter in einer Nachricht an den Dienst an. Hinweis: Diese Methode funktioniert nicht für die Verbindung von SpeechSynthesizer. In Version 1.7.0 hinzugefügt

Ereignisse

Connected	Das Connected-Ereignis, das angibt, dass die Erkennung mit dem Dienst verbunden ist. Um das Connected-Ereignis nach dem Abonnieren empfangen zu können, muss das Connection-Objekt selbst aktiv sein. Wenn das Connection-Objekt, das dieses Ereignis besitzt, außerhalb seiner Lebensdauer liegt, werden nicht alle abonnierten Ereignisse übermittelt.
Disconnected	Das Disconnected-Ereignis, das angibt, dass die Erkennung vom Dienst getrennt ist. Um das Disconnected-Ereignis nach dem Abonnieren empfangen zu können, muss das Connection-Objekt selbst aktiv sein. Wenn das Connection-Objekt, das dieses Ereignis besitzt, außerhalb seiner Lebensdauer liegt, werden nicht alle abonnierten Ereignisse übermittelt.
MessageReceived	Das MessageReceived-Ereignis gibt an, dass der Dienst eine Netzwerknachricht an den Client gesendet hat.