DialogServiceConnector class

패키지:

microsoft-cognitiveservices-speech-sdk

대화 상자 서비스 커넥터

Extends

Recognizer

생성자

DialogServiceConnector(DialogServiceConfig, AudioConfig)

DialogServiceConnector의 instance 초기화합니다.

속성

activityReceived	이벤트 활동Received는 활동이 수신되었음을 나타냅니다.
authorizationToken	서비스와 통신하는 데 사용되는 권한 부여 토큰을 가져옵니다.
canceled	이벤트가 취소됨은 인식 중에 오류가 발생했음을 나타냅니다.
internalData
properties	이 DialogServiceConnector에 대해 정의된 속성 및 해당 값의 컬렉션입니다.
recognized	이벤트가 인식되면 최종 인식 결과가 수신됨을 알 수 있습니다.
recognizing	이벤트를 인식하면 중간 인식 결과가 수신됨을 알 수 있습니다.
speechActivityTemplate	음성에서 서비스에 의해 생성된 활동에 대한 템플릿을 가져옵니다. 템플릿의 속성은 생성된 활동에 스탬프됩니다. 비어 있을 수 있습니다.
telemetryEnabled	이 메서드는 원격 분석 설정의 현재 상태를 반환합니다.
turnStatusReceived	이벤트 turnStatusReceived는 턴 상태 메시지가 수신되었음을 알립니다. 이러한 메시지는 상호 작용 및 대화 모두와 연결됩니다. 네트워크 문제, 시간 제한, 크래시 또는 기타 문제가 발생하는 경우와 같이 대화 백 엔드와의 상호 작용 실패 시 클라이언트에 알리는 데 사용됩니다.

상속된 속성

sessionStarted	세션 시작 이벤트에 대한 이벤트 처리기를 정의합니다.
sessionStopped	세션 중지 이벤트에 대한 이벤트 처리기를 정의합니다.
speechEndDetected	음성 중지 이벤트에 대한 이벤트 처리기를 정의합니다.
speechStartDetected	음성 시작 이벤트에 대한 이벤트 처리기를 정의합니다.

메서드

close(() => void, (error: string) => void)	는 이 클래스의 instance 보유한 모든 외부 리소스를 닫습니다.
connect(() => void, (error: string) => void)	서비스에 대한 연결을 시작합니다. 사용자는 필요에 따라 connect()를 호출하여 상호 작용을 시작하기 전에 사전에 연결을 수동으로 설정할 수 있습니다. 참고: 반환 시 연결이 아직 준비되지 않았을 수 있습니다. 연결이 설정될 때 알림을 받으려면 Connected 이벤트를 구독하세요.
disconnect(() => void, (error: string) => void)	서비스 연결을 닫습니다. 사용자는 필요에 따라 disconnect()를 호출하여 연결된 DialogServiceConnector의 연결을 수동으로 종료할 수 있습니다. 인식 중에 disconnect()가 호출되면 인식이 실패하고 오류가 발생하여 취소됩니다.
listenOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)	첫 번째 발화가 인식된 후 인식을 시작하고 중지합니다.
sendActivityAsync(string, () => void, (error: string) => void)

상속된 메서드

enableTelemetry(boolean)

이 메서드는 원격 분석을 전역적으로 사용하거나 사용하지 않도록 설정합니다.

생성자 세부 정보

DialogServiceConnector(DialogServiceConfig, AudioConfig)

DialogServiceConnector의 instance 초기화합니다.

new DialogServiceConnector(dialogConfig: DialogServiceConfig, audioConfig?: AudioConfig)

매개 변수

dialogConfig

DialogServiceConfig

이 인식기를 구성할 속성 집합입니다.

audioConfig

AudioConfig

인식기와 연결된 선택적 오디오 구성

속성 세부 정보

activityReceived

이벤트 활동Received는 활동이 수신되었음을 나타냅니다.

public activityReceived: (sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

속성 값

(sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

authorizationToken

서비스와 통신하는 데 사용되는 권한 부여 토큰을 가져옵니다.

string authorizationToken

속성 값

string

권한 부여 토큰입니다.

canceled

이벤트가 취소됨은 인식 중에 오류가 발생했음을 나타냅니다.

public canceled: (sender: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

속성 값

(sender: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

internalData

object internalData

속성 값

object

properties

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

PropertyCollection properties

속성 값

PropertyCollection

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

recognized

이벤트가 인식되면 최종 인식 결과가 수신됨을 알 수 있습니다.

public recognized: (sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

속성 값

(sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

recognizing

이벤트를 인식하면 중간 인식 결과가 수신됨을 알 수 있습니다.

public recognizing: (sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

속성 값

(sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

speechActivityTemplate

음성에서 서비스에 의해 생성된 활동에 대한 템플릿을 가져옵니다. 템플릿의 속성은 생성된 활동에 스탬프됩니다. 비어 있을 수 있습니다.

string speechActivityTemplate

속성 값

string

telemetryEnabled

이 메서드는 원격 분석 설정의 현재 상태를 반환합니다.

static boolean telemetryEnabled

속성 값

boolean

원격 분석을 사용하도록 설정하면 true이고, 그렇지 않으면 false입니다.

turnStatusReceived

이벤트 turnStatusReceived는 턴 상태 메시지가 수신되었음을 알립니다. 이러한 메시지는 상호 작용 및 대화 모두와 연결됩니다. 네트워크 문제, 시간 제한, 크래시 또는 기타 문제가 발생하는 경우와 같이 대화 백 엔드와의 상호 작용 실패 시 클라이언트에 알리는 데 사용됩니다.

public turnStatusReceived: (sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

속성 값

(sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

상속된 속성 세부 정보

sessionStarted

세션 시작 이벤트에 대한 이벤트 처리기를 정의합니다.

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

속성 값

(sender: Recognizer, event: SessionEventArgs) => void

Recognizer.sessionStarted에서 상속됨

sessionStopped

세션 중지 이벤트에 대한 이벤트 처리기를 정의합니다.

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

속성 값

(sender: Recognizer, event: SessionEventArgs) => void

Recognizer.sessionStopped에서 상속됨

speechEndDetected

음성 중지 이벤트에 대한 이벤트 처리기를 정의합니다.

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

속성 값

(sender: Recognizer, event: RecognitionEventArgs) => void

Recognizer.speechEndDetected에서 상속됨

speechStartDetected

음성 시작 이벤트에 대한 이벤트 처리기를 정의합니다.

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

속성 값

(sender: Recognizer, event: RecognitionEventArgs) => void

Recognizer.speechStartDetected에서 상속됨

메서드 세부 정보

close(() => void, (error: string) => void)

는 이 클래스의 instance 보유한 모든 외부 리소스를 닫습니다.

function close(cb?: () => void, err?: (error: string) => void)

매개 변수

cb

() => void

err

(error: string) => void

connect(() => void, (error: string) => void)

서비스에 대한 연결을 시작합니다. 사용자는 필요에 따라 connect()를 호출하여 상호 작용을 시작하기 전에 사전에 연결을 수동으로 설정할 수 있습니다.

참고: 반환 시 연결이 아직 준비되지 않았을 수 있습니다. 연결이 설정될 때 알림을 받으려면 Connected 이벤트를 구독하세요.

function connect(cb?: () => void, err?: (error: string) => void)

매개 변수

cb

() => void

err

(error: string) => void

disconnect(() => void, (error: string) => void)

서비스 연결을 닫습니다. 사용자는 필요에 따라 disconnect()를 호출하여 연결된 DialogServiceConnector의 연결을 수동으로 종료할 수 있습니다.

인식 중에 disconnect()가 호출되면 인식이 실패하고 오류가 발생하여 취소됩니다.

function disconnect(cb?: () => void, err?: (error: string) => void)

매개 변수

cb

() => void

err

(error: string) => void

listenOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

첫 번째 발화가 인식된 후 인식을 시작하고 중지합니다.

function listenOnceAsync(cb?: (e: SpeechRecognitionResult) => void, err?: (e: string) => void)

매개 변수

cb

(e: SpeechRecognitionResult) => void

reco가 완료되었을 때 결과를 받은 콜백입니다.

err

(e: string) => void

오류 발생 시 호출된 콜백입니다.

sendActivityAsync(string, () => void, (error: string) => void)

function sendActivityAsync(activity: string, cb?: () => void, errCb?: (error: string) => void)

매개 변수

activity

string

cb

() => void

errCb

(error: string) => void

상속된 메서드 세부 정보

enableTelemetry(boolean)

이 메서드는 원격 분석을 전역적으로 사용하거나 사용하지 않도록 설정합니다.

static function enableTelemetry(enabled: boolean)

매개 변수

enabled

boolean

원격 분석 수집에 대한 전역 설정입니다. true로 설정하면 마이크 오류, 인식 오류와 같은 원격 분석 정보가 수집되어 Microsoft로 전송됩니다. false로 설정하면 원격 분석이 Microsoft로 전송되지 않습니다.

Recognizer.enableTelemetry에서 상속됨