Connection クラス

定義

名前空間:

Microsoft.CognitiveServices.Speech

アセンブリ:

Microsoft.CognitiveServices.Speech.csharp.dll

パッケージ:

Microsoft.CognitiveServices.Speech v1.34.0

指定した Recognizer の音声サービスへの接続を管理するためのプロキシ クラス。 1.2.0 で追加

public sealed class Connection : IDisposable

type Connection = class
    interface IDisposable

Public NotInheritable Class Connection
Implements IDisposable

継承

Object

Connection

実装

IDisposable

注釈

既定では、必要に応じて、Recognizer によってサービスへの接続が自律的に管理されます。 Connection クラスには、接続を明示的に開いたり閉めたり、接続状態の変更をサブスクライブしたりするために使用できる追加のメソッドが用意されています。 Connection の使用は省略可能です。 これは、接続状態に基づいてアプリケーションの動作を微調整する必要があるシナリオを対象としています。 必要に応じて Open() を呼び出して、この接続に関連付けられている認識機能で認識を開始する前に、サービス接続を手動で開始できます。 認識を開始すると、Open() または Close() の呼び出しが失敗する可能性があります。 これは、認識エンジンや進行中の認識には影響しません。 さまざまな理由で接続が切断される可能性があります。継続的な操作を保証するために、Recognizer は常に必要に応じて接続の再確立を試みます。 これらすべての場合、接続/切断されたイベントは、接続状態の変更を示します。

メソッド

Close()	サービスの接続を閉じます。 必要に応じて Close() を呼び出して、関連付けられている Recognizer の接続を手動でシャットダウンできます。 認識エンジンのプロセス状態によっては、呼び出しが失敗する場合があります。 ただし、エラーは関連する Recognizer の状態には影響しません。
Dispose()	関連付けられているリソースを破棄します。
Finalize()	指定した Recognizer の音声サービスへの接続を管理するためのプロキシ クラス。 1.2.0 で追加
FromConversationTranslator(ConversationTranslator)	会話トランスレーターから Connection インスタンスを取得します。
FromDialogServiceConnector(DialogServiceConnector)	音声サービスからの接続と切断の監視と管理に使用される、指定されたダイアログ サービス コネクタから Connection インスタンスを取得します。
FromRecognizer(Recognizer)	指定した認識エンジンから Connection インスタンスを取得します。
FromSpeechSynthesizer(SpeechSynthesizer)	音声サービスからの接続と切断の監視と管理に使用される、指定された音声シンセサイザーから Connection インスタンスを取得します。 バージョン 1.17.0 で追加されました
Open(Boolean)	サービスへの接続の設定を開始します。 必要に応じて Open() を呼び出して、この接続に関連付けられている認識機能で認識を開始する前に、接続を手動で事前に設定できます。 認識を開始した後、認識エンジンのプロセス状態によっては、Open() の呼び出しが失敗する可能性があります。 ただし、エラーは関連する Recognizer の状態には影響しません。 注: 返却時に、接続がまだ準備できていない可能性があります。 接続が確立されたときに通知を受け取るために、Connected イベントをサブスクライブしてください。
SendMessageAsync(String, Byte[], UInt32)	非同期操作として、バイナリ メッセージを音声サービスに送信します。 注: このメソッドは、SpeechSynthesizer の接続では機能しません。 1.10.0 で追加
SendMessageAsync(String, String)	非同期操作として音声サービスにメッセージを送信します。 注: このメソッドは、SpeechSynthesizer の接続では機能しません。 1.7.0 で追加
SetMessageProperty(String, String, String)	メッセージ内のパラメーターをサービスに追加します。 注: このメソッドは、SpeechSynthesizer の接続では機能しません。 1.7.0 で追加

イベント

Connected	認識エンジンがサービスに接続されていることを示す Connected イベント。 サブスクライブ後に Connected イベントを受信するには、Connection オブジェクト自体がアクティブである必要があります。 このイベントを所有する Connection オブジェクトが有効期間外の場合、サブスクライブされているすべてのイベントは配信されません。
Disconnected	認識エンジンがサービスから切断されていることを示す Disconnected イベント。 サブスクライブ後に Disconnected イベントを受信するには、Connection オブジェクト自体がアクティブである必要があります。 このイベントを所有する Connection オブジェクトが有効期間外の場合、サブスクライブされているすべてのイベントは配信されません。
MessageReceived	MessageReceived イベントは、サービスがクライアントにネットワーク メッセージを送信したことを示します。