Connection 클래스

지정된 Recognizer의 음성 서비스에 대한 연결을 관리하기 위한 프록시 클래스입니다.

기본적으로 는 Recognizer 필요할 때 서비스에 대한 연결을 자율적으로 관리합니다. 클래스는 Connection 사용자가 명시적으로 연결을 열거나 닫고 연결 상태 변경 내용을 구독하는 추가 메서드를 제공합니다. Connection 사용은 선택 사항입니다. 연결 상태 따라 애플리케이션 동작을 미세 조정해야 하는 시나리오를 위한 것입니다. 사용자는 필요에 따라 를 호출 open 하여 이 Connection와 연결된 에 대한 Recognizer 인식을 시작하기 전에 수동으로 서비스 연결을 시작할 수 있습니다. 인식을 시작한 후 또는 close 를 호출 open 하지 못할 수 있습니다. 이는 인식기 또는 진행 중인 인식에 영향을 주지 않습니다. 다양한 이유로 연결이 끊어질 수 있으며, Recognizer는 진행 중인 작업을 보장하기 위해 필요에 따라 항상 연결을 다시 구성하려고 시도합니다. 이러한 모든 경우에 connected/disconnected 이벤트는 연결 상태 변경을 나타냅니다.

참고

버전 1.17.0에서 업데이트되었습니다.

내부 사용을 위한 생성자입니다.

상속

builtins.object

Connection

생성자

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 이벤트입니다.