Connection 클래스
지정된 Recognizer의 음성 서비스에 대한 연결을 관리하기 위한 프록시 클래스입니다.
기본적으로 는 Recognizer 필요할 때 서비스에 대한 연결을 자율적으로 관리합니다. 클래스는 Connection 사용자가 명시적으로 연결을 열거나 닫고 연결 상태 변경 내용을 구독하는 추가 메서드를 제공합니다. Connection 사용은 선택 사항입니다. 연결 상태 따라 애플리케이션 동작을 미세 조정해야 하는 시나리오를 위한 것입니다. 사용자는 필요에 따라 를 호출 open 하여 이 Connection와 연결된 에 대한 Recognizer 인식을 시작하기 전에 수동으로 서비스 연결을 시작할 수 있습니다. 인식을 시작한 후 또는 close 를 호출 open 하지 못할 수 있습니다. 이는 인식기 또는 진행 중인 인식에 영향을 주지 않습니다. 다양한 이유로 연결이 끊어질 수 있으며, Recognizer는 진행 중인 작업을 보장하기 위해 필요에 따라 항상 연결을 다시 구성하려고 시도합니다. 이러한 모든 경우에 connected/disconnected 이벤트는 연결 상태 변경을 나타냅니다.
참고
버전 1.17.0에서 업데이트되었습니다.
내부 사용을 위한 생성자입니다.
- 상속
-
builtins.objectConnection
생성자
Connection(handle: c_void_p)
매개 변수
Name | Description |
---|---|
handle
필수
|
|
메서드
close |
서비스 연결을 닫습니다. 사용자는 필요에 따라 를 호출 close 하여 연결된 Recognizer의 연결을 수동으로 종료할 수 있습니다. 의 프로세스 상태에 Recognizer따라 호출이 실패할 수 있습니다. 그러나 실패는 연결된 Recognizer의 상태에 영향을 주지 않습니다. |
from_dialog_service_connector |
Connection 지정된 대화 상자 서비스 커넥터에서 instance 가져옵니다. |
from_recognizer |
지정된 인식기 Connection 에서 instance 가져옵니다. |
from_speech_synthesizer |
Connection 지정된 음성 신시사이저에서 instance 가져옵니다. 참고 버전 1.17.0에 추가되었습니다. |
open |
서비스에 대한 연결을 설정하기 시작합니다. 사용자는 필요에 따라 를 호출 open 하여 이 Connection와 연결된 에 대한 Recognizer 인식을 시작하기 전에 사전에 연결을 수동으로 설정할 수 있습니다. 인식을 시작한 후 의 Recognizer프로세스 상태에 따라 를 호출open하지 못할 수 있습니다. 그러나 실패는 연결된 Recognizer의 상태에 영향을 주지 않습니다. 참고 반환할 때 연결이 아직 준비되지 않았을 수 있습니다. 을 구독하세요. 연결이 설정될 때 알림을 받을 연결된 이벤트입니다. |
set_message_property |
메시지에 매개 변수를 서비스에 추가합니다. 참고 이 메서드는 의 SpeechSynthesizer연결에 대해 작동하지 않습니다. |
close
서비스 연결을 닫습니다. 사용자는 필요에 따라 를 호출 close 하여 연결된 Recognizer의 연결을 수동으로 종료할 수 있습니다. 의 프로세스 상태에 Recognizer따라 호출이 실패할 수 있습니다. 그러나 실패는 연결된 Recognizer의 상태에 영향을 주지 않습니다.
close()
from_dialog_service_connector
Connection 지정된 대화 상자 서비스 커넥터에서 instance 가져옵니다.
from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection
매개 변수
Name | Description |
---|---|
dialog_service_connector
필수
|
|
from_recognizer
지정된 인식기 Connection 에서 instance 가져옵니다.
from_recognizer(recognizer: Recognizer) -> Connection
매개 변수
Name | Description |
---|---|
recognizer
필수
|
|
from_speech_synthesizer
Connection 지정된 음성 신시사이저에서 instance 가져옵니다.
참고
버전 1.17.0에 추가되었습니다.
from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection
매개 변수
Name | Description |
---|---|
speech_synthesizer
필수
|
|
open
서비스에 대한 연결을 설정하기 시작합니다. 사용자는 필요에 따라 를 호출 open 하여 이 Connection와 연결된 에 대한 Recognizer 인식을 시작하기 전에 사전에 연결을 수동으로 설정할 수 있습니다. 인식을 시작한 후 의 Recognizer프로세스 상태에 따라 를 호출open하지 못할 수 있습니다. 그러나 실패는 연결된 Recognizer의 상태에 영향을 주지 않습니다.
참고
반환할 때 연결이 아직 준비되지 않았을 수 있습니다. 을 구독하세요.
연결이 설정될 때 알림을 받을 연결된 이벤트입니다.
open(for_continuous_recognition: bool)
매개 변수
Name | Description |
---|---|
forContinuousRecognition
필수
|
는 연결이 연속 인식 또는 단일 샷 인식에 사용되는지 여부를 나타냅니다. 연결이 SpeechSynthsizer에서 온 경우에는 적용되지 않습니다. |
for_continuous_recognition
필수
|
|
set_message_property
메시지에 매개 변수를 서비스에 추가합니다.
참고
이 메서드는 의 SpeechSynthesizer연결에 대해 작동하지 않습니다.
set_message_property(path: str, property_name: str, property_value: str)
매개 변수
Name | Description |
---|---|
path
필수
|
메시지 경로입니다. |
property_name
필수
|
설정할 속성 이름입니다. |
property_value
필수
|
설정할 속성의 값입니다. |
특성
connected
인식기가 서비스에 연결되어 있음을 나타내는 Connected 이벤트입니다.
disconnected
인식기가 서비스에서 연결이 끊어지는 것을 나타내는 Disconnected 이벤트입니다.
Azure SDK for Python