다음을 통해 공유

클래스 대화 상자::D ialogServiceConnector

  • 아티클 
class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

DirectLineSpeech 또는 CustomCommands를 연결하는 데 사용되는 개체입니다.

이 형식의 개체는 FromConfig 팩터리 메서드를 통해 만들어집니다.

멤버

인식

구문: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

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

인식

구문: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

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

SessionStarted

구문: public EventSignal< constSessionEventArgs & > SessionStarted;

수신 세션의 시작을 나타내는 신호입니다.

SessionStopped

구문: public EventSignal< constSessionEventArgs & > SessionStopped;

수신 세션의 끝을 나타내는 신호입니다.

SpeechStartDetected

구문: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

현재 구에서 음성 데이터의 첫 번째 검색을 나타내는 신호입니다.

SpeechEndDetected

구문: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

현재 구의 음성 데이터의 감지된 끝을 나타내는 신호입니다.

취소됨

구문: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

상호 작용 취소와 관련된 이벤트에 대한 신호입니다. 이벤트는 이유가 직접 취소 또는 오류인지 여부를 나타냅니다.

ActivityReceived

구문: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

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

TurnStatusReceived

구문: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

백 엔드에서 턴 상태 업데이트를 받았다는 신호입니다.

속성

구문: public PropertyCollection & Properties;

이 DialogServiceConnector에 대해 정의된 속성 및 해당 값의 컬렉션입니다.

~DialogServiceConnector

구문: public inline virtual ~DialogServiceConnector ( );

instance 삭제합니다.

Connectasync

구문: public inline std::future< void > ConnectAsync ( );

백 엔드와 연결합니다.

반환

연결을 시작하는 비동기 작업입니다.

DisconnectAsync

구문: public inline std::future< void > DisconnectAsync ( );

백 엔드에서 연결을 끊습니다.

반환

연결 끊기를 시작하는 비동기 작업입니다.

SendActivityAsync

구문: public inline std::future< std::string > SendActivityAsync ( const std::string & activity );

백업 대화 상자에 활동을 보냅니다.

매개 변수

  • activity 보낼 활동

반환

작업을 시작하는 비동기 작업입니다.

StartKeywordRecognitionAsync

구문: public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

키워드(keyword) 인식을 시작합니다.

매개 변수

  • model사용할 키워드(keyword) 모델을 지정합니다.

반환

작업을 시작하는 비동기 작업입니다.

StopKeywordRecognitionAsync

구문: public inline std::future< void > StopKeywordRecognitionAsync ( );

키워드(keyword) 인식을 중지합니다.

반환

작업을 시작하는 비동기 작업입니다.

ListenOnceAsync

구문: public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );

첫 번째 발화 후에 종료되는 수신 대기 세션을 시작합니다.

반환

작업을 시작하는 비동기 작업입니다.

StopListeningAsync

구문: public inline std::future< void > StopListeningAsync ( );

활성 수신 대기 작업이 즉시 완료되어 진행 중인 음성을 중단하고 지금까지 캡처된 오디오 데이터를 반영하는 결과를 제공하도록 요청합니다.

반환

활성 수신 대기 세션을 중지하는 비동기 작업을 나타내는 작업입니다.

SetAuthorizationToken

구문: public inline void SetAuthorizationToken ( const std::string & token );

서비스에 연결하는 데 사용할 권한 부여 토큰을 설정합니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 그렇지 않으면 커넥터가 작업하는 동안 오류가 발생합니다.

매개 변수

  • token 권한 부여 토큰입니다.

GetAuthorizationToken

구문: public inline std::string GetAuthorizationToken ( );

권한 부여 토큰을 가져옵니다.

반환

권한 부여 토큰

SetSpeechActivityTemplate

구문: public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );

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

매개 변수

  • activityTemplate JSON 문자열인 활동 페이로드는 적용 가능한 모든 활동 메시지에 병합됩니다.

GetSpeechActivityTemplate

구문: public inline std::string GetSpeechActivityTemplate ( );

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

반환

JSON 활동 템플릿은 현재 후속 요청에 사용될 설정됩니다.

FromConfig

구문: public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );

DialogServiceConfig 및 Audio::AudioConfig에서 대화 서비스 커넥터를 만듭니다. 사용자는 이 함수를 사용하여 대화 서비스 커넥터를 만들어야 합니다.

매개 변수

  • connectorConfig 대화 상자 서비스 구성.

  • audioConfig 오디오 구성.

반환

만든 대화 서비스 커넥터의 공유 스마트 포인터입니다.

auto audioConfig = [Audio::AudioConfig::FromDefaultMicrophoneInput](audio-audioconfig.md#fromdefaultmicrophoneinput)();
auto config = [CustomCommandsConfig::FromAuthorizationToken](dialog-customcommandsconfig.md#fromauthorizationtoken)("my_app_id","my_auth_token", "my_region");
auto connector = [DialogServiceConnector::FromConfig](#fromconfig)(config, audioConfig);

DialogServiceConfig에 대해 말할 때는 이 클래스에서 상속되는 클래스 중 하나를 참조합니다. 사용할 특정 클래스는 사용 중인 대화 백 엔드에 따라 달라집니다.