Connection クラス

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

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

属性

connected

認識エンジンがサービスに接続されていることを示す Connected イベント。

disconnected

認識エンジンがサービスから切断されていることを示す Disconnected イベント。