DialogServiceConnector 클래스

서비스와의 연결을 동기적으로 설정합니다. 필요한 경우 연결이 자동으로 수행되지만 이 수동 호출은 처음 사용하기 전에 연결이 활성화되어 초기 대기 시간을 줄이는 데 도움이 되도록 하는 데 유용할 수 있습니다.

반환할 때 연결이 아직 준비되지 않았을 수 있습니다. 연결 인스턴스의 연결된 이벤트를 구독하여 서비스에 대한 연결이 설정될 때 알림을 받습니다. 를 사용하여 Connection 메서드를 사용하여 인스턴스를 from_dialog_service_connector 검색하세요.

connect()

서비스와의 연결을 비동기적으로 설정합니다. 필요한 경우 연결이 자동으로 수행되지만 이 수동 호출은 처음 사용하기 전에 연결이 활성화되어 초기 대기 시간을 줄이는 데 도움이 되도록 하는 데 유용할 수 있습니다.

connect_async()

반환

서비스에서 동기적으로 연결을 끊습니다. 연결이 필요한 후속 호출은 수동 연결 끊기 후에도 자동으로 다시 연결됩니다.

disconnect()

서비스에서 비동기적으로 연결을 끊습니다. 연결이 필요한 후속 호출은 수동 연결 끊기 후에도 자동으로 다시 연결됩니다.

disconnect_async()

반환

이 커넥터와 음성 텍스트 간 상호 작용을 동기적으로 시작하고 단일 음성 텍스트 변환 최종 결과가 수신될 때까지 차단합니다. 수신된 음성 텍스트 변환 결과도 구성된 대화 상자 구현에 제공되며 해당 대화 시스템은 음성 상호 작용에 대한 응답으로 여러 활동 페이로드를 생성할 수 있습니다. 음성 상호 작용은 활동 페이로드의 대화 관련 데이터를 통해 활동과 상관 관계가 있을 수 있습니다.

listen_once() -> SpeechRecognitionResult

반환

이 커넥터와 음성 텍스트 간 상호 작용을 비동기적으로 시작하고 단일 음성 텍스트 변환 최종 결과가 수신될 때까지 차단합니다. 수신된 음성 텍스트 변환 결과도 구성된 대화 상자 구현에 제공되며 해당 대화 시스템은 음성 상호 작용에 대한 응답으로 여러 활동 페이로드를 생성할 수 있습니다. 음성 상호 작용은 활동 페이로드의 대화 관련 데이터를 통해 활동과 상관 관계가 있을 수 있습니다.

listen_once_async() -> ResultFuture

반환

이 DialogServiceConnector 인스턴스가 연결된 대화 백 엔드 서비스에 데이터 페이로드를 동기적으로 보냅니다. 이 문서는 일반적으로 서비스의 대화 상자 구현에 의해 결정되는 스키마가 있는 JSON 문서이며 전송된 활동의 콘텐츠는 대화 시스템의 형식 및 콘텐츠 기대치에 대한 지식으로 채워져야 합니다. 전송된 활동은 다른 상호 작용과 연결되지 않으며 서비스에서 처리할 때 자체 독립 실행형 상호 작용 식별자를 생성합니다. 사용된 대화 구현의 기능을 사용하여 활동 페이로드 자체를 통해 대화 및 기타 상호 작용의 상관 관계를 수행해야 합니다.

send_activity(activity: str) -> str

매개 변수

반환

지원 대화 상자에 활동을 비동기적으로 보냅니다. 자세한 내용은 다음을 참조하세요. send_activity

send_activity_async(activity: str) -> ResultFuture

매개 변수

반환

키워드를 사용하여 이 커넥터와 음성 텍스트 간 상호 작용을 동기적으로 시작합니다. 이 상호 작용은 제공된 키워드 모델을 사용하여 오디오가 음성 서비스로 전송되지 않고 모든 처리가 로컬로 수행되는 동안 키워드를 무기한 수신 대기합니다. 키워드가 인식되면 DialogServiceConnector는 음성 서비스에 자동으로 연결되고 키워드 바로 앞에서 호출된 것처럼 listen_once_async 오디오 데이터를 보내기 시작합니다. 수신되면 음성 텍스트 변환 결과가 제공된 결과 처리기에서 처리되거나 인식된 이벤트에 대한 구독을 통해 검색될 수 있습니다. 이 작업에서 생성된 음성 텍스트 변환 결과는 구성된 대화 상자 구현에도 제공되며, 해당 대화 시스템은 음성 상호 작용에 대한 응답으로 여러 활동 페이로드를 생성할 수 있습니다. 음성 상호 작용은 활동 페이로드의 대화 관련 데이터를 통해 활동과 상관 관계가 있을 수 있습니다.

를 호출 stop_keyword_recognition_async 하여 키워드 시작 인식을 중지합니다.

start_keyword_recognition(model: KeywordRecognitionModel)

매개 변수

지정된 키워드 모델을 사용하여 대화 상자 서비스 커넥터를 비동기적으로 구성합니다. 이 메서드를 호출한 후 커넥터는 키워드를 수신 대기하여 인식을 시작합니다. 를 호출 stop_keyword_recognition_async 하여 키워드 시작 인식을 중지합니다.

기능에 대한 자세한 설명은 을 참조 start_keyword_recognition 하세요.

start_keyword_recognition_async(model: KeywordRecognitionModel)

매개 변수

반환

키워드 시작 인식을 동기적으로 중지합니다.

stop_keyword_recognition()

키워드 시작 인식을 비동기적으로 중지합니다.

stop_keyword_recognition_async()

반환

활성 수신 대기 작업을 즉시 중지하도록 요청합니다. 이로 인해 진행 중인 음성-텍스트 간 상호 작용이 중단될 수 있으며 수신된 음성 텍스트 변환 결과는 불완전한 음성 입력을 나타낼 수 있습니다.

이벤트를 처리할 때 동기 메서드를 호출해서는 안 됩니다. 이벤트에 대한 응답으로 중지가 필요한 경우 를 사용합니다 stop_listening_async .

stop_listening()

반환

활성 수신 대기 작업을 즉시 중지하도록 요청합니다. 이로 인해 진행 중인 음성-텍스트 간 상호 작용이 중단될 수 있으며 수신된 음성 텍스트 변환 결과는 불완전한 음성 입력을 나타낼 수 있습니다.

stop_listening_async()

반환

백 엔드에서 활동을 수신했음을 나타냅니다.

이 신호에 연결된 콜백은 인식기 유형에 따라 단일 인수로 인스턴스를 사용하여 호출 ActivityReceivedEventArgs됩니다.

서비스에 연결하는 데 사용할 권한 부여 토큰입니다.

취소된 인식 결과가 포함된 이벤트에 대한 신호입니다(결과로 취소된 인식 시도 또는 직접 취소 요청 또는 전송 또는 프로토콜 실패를 나타냅니다).

이 신호에 연결된 콜백은 인스턴스를 SpeechRecognitionCanceledEventArgs단일 인수로 사용하여 호출됩니다.

최종 인식 결과가 포함된 이벤트에 대한 신호입니다(성공적인 인식 시도를 나타낸다).

이 신호에 연결된 콜백은 인식기 유형에 따라 단일 인수로 인스턴스를 사용하여 호출 SpeechRecognitionEventArgs됩니다.

중간 인식 결과를 포함하는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 인스턴스를 SpeechRecognitionEventArgs단일 인수로 사용하여 호출됩니다.

인식 세션(작업)의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 인스턴스를 SessionEventArgs 단일 인수로 사용하여 호출됩니다.

인식 세션(작업)의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 인스턴스를 SessionEventArgs 단일 인수로 사용하여 호출됩니다.

다음 대화를 위해 음성 서비스에 제공될 JSON 템플릿을 가져옵니다. 서비스는 음성 텍스트 변환 결과의 경우와 마찬가지로 SendActivityAsync를 사용하여 클라이언트에서 시작하거나 서비스에서 생성하든 대화 백 엔드로 전송된 모든 활동에 이 템플릿을 병합하려고 시도합니다.

음성의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 인스턴스를 RecognitionEventArgs 단일 인수로 사용하여 호출됩니다.

음성의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 인스턴스를 RecognitionEventArgs 단일 인수로 사용하여 호출됩니다.

백 엔드에서 턴 상태 업데이트를 수신했음을 알립니다.

이 신호에 연결된 콜백은 인스턴스를 TurnStatusReceivedEventArgs단일 인수로 사용하여 호출됩니다.