Share via


TranslationRecognizer class

번역 인식기

Extends

생성자

TranslationRecognizer(SpeechTranslationConfig, AudioConfig, IConnectionFactory)

TranslationRecognizer의 instance 초기화합니다.

속성

authorizationToken

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

canceled

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

internalData
properties

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

recognized

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

recognizing

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

speechRecognitionLanguage

인식기를 만들 때 설정된 언어 이름을 가져옵니다.

synthesizing

이벤트 합성은 변환 합성 결과를 수신한다는 신호를 보냅니다.

targetLanguages

인식기를 만들 때 설정된 번역의 대상 언어를 가져옵니다. 언어는 BCP-47 형식으로 지정됩니다. 번역은 각 언어에 대해 번역된 텍스트를 제공합니다.

telemetryEnabled

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

voiceName

출력 음성의 이름을 가져옵니다.

상속된 속성

sessionStarted

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

sessionStopped

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

speechEndDetected

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

speechStartDetected

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

메서드

addTargetLanguage(string)

대상 언어 목록에 언어를 동적으로 추가(인식이 진행되는 동안 사용할 수 있음)

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

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

FromConfig(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)

TranslationRecognizer 생성자입니다.

onConnection()

는 대화 번역 시나리오에 대한 ConnectionEstablishedEvent를 처리합니다.

recognizeOnceAsync((e: TranslationRecognitionResult) => void, (e: string) => void)

인식 및 번역을 시작하고 첫 번째 발화가 인식된 후 중지됩니다. 태스크는 번역 텍스트를 결과로 반환합니다. 참고: recognizeOnceAsync는 첫 번째 발화가 인식되면 를 반환하므로 명령이나 쿼리와 같은 단일 샷 인식에만 적합합니다. 장기 실행 인식의 경우 startContinuousRecognitionAsync()를 대신 사용합니다.

removeTargetLanguage(string)

대상 언어 목록에서 언어를 동적으로 제거합니다(인식이 진행되는 동안 사용할 수 있음).

startContinuousRecognitionAsync(() => void, (e: string) => void)

stopContinuousRecognitionAsync()가 호출될 때까지 인식 및 번역을 시작합니다. 사용자는 변환 결과를 받으려면 이벤트를 구독해야 합니다.

stopContinuousRecognitionAsync(() => void, (e: string) => void)

연속 인식 및 번역을 중지합니다.

상속된 메서드

enableTelemetry(boolean)

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

생성자 세부 정보

TranslationRecognizer(SpeechTranslationConfig, AudioConfig, IConnectionFactory)

TranslationRecognizer의 instance 초기화합니다.

new TranslationRecognizer(speechConfig: SpeechTranslationConfig, audioConfig?: AudioConfig, connectionFactory?: IConnectionFactory)

매개 변수

speechConfig
SpeechTranslationConfig

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

audioConfig
AudioConfig

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

connectionFactory

IConnectionFactory

엔드포인트 URI, 설정할 헤더 등을 생성하는 데 사용할 선택적 연결 팩터리입니다.

속성 세부 정보

authorizationToken

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

string authorizationToken

속성 값

string

권한 부여 토큰입니다.

canceled

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

public canceled: (sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void

속성 값

(sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void

internalData

object internalData

속성 값

object

properties

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

PropertyCollection properties

속성 값

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

recognized

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

public recognized: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void

속성 값

(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void

recognizing

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

public recognizing: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void

속성 값

(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void

speechRecognitionLanguage

인식기를 만들 때 설정된 언어 이름을 가져옵니다.

string speechRecognitionLanguage

속성 값

string

인식기를 만들 때 설정된 언어 이름을 가져옵니다.

synthesizing

이벤트 합성은 변환 합성 결과를 수신한다는 신호를 보냅니다.

public synthesizing: (sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void

속성 값

(sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void

targetLanguages

인식기를 만들 때 설정된 번역의 대상 언어를 가져옵니다. 언어는 BCP-47 형식으로 지정됩니다. 번역은 각 언어에 대해 번역된 텍스트를 제공합니다.

string[] targetLanguages

속성 값

string[]

인식기를 만들 때 설정된 번역의 대상 언어를 가져옵니다.

telemetryEnabled

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

static boolean telemetryEnabled

속성 값

boolean

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

voiceName

출력 음성의 이름을 가져옵니다.

string voiceName

속성 값

string

출력 음성의 이름입니다.

상속된 속성 세부 정보

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에서 상속

메서드 세부 정보

addTargetLanguage(string)

대상 언어 목록에 언어를 동적으로 추가(인식이 진행되는 동안 사용할 수 있음)

function addTargetLanguage(lang: string)

매개 변수

lang

string

추가할 언어

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

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

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

매개 변수

cb

() => void

errorCb

(error: string) => void

FromConfig(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)

TranslationRecognizer 생성자입니다.

static function FromConfig(speechTranslationConfig: SpeechTranslationConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): TranslationRecognizer

매개 변수

speechTranslationConfig
SpeechTranslationConfig

이 인식기의 초기 속성 집합

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

인식기와 연결된 원본 언어 검색 구성

audioConfig
AudioConfig

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

반환

onConnection()

는 대화 번역 시나리오에 대한 ConnectionEstablishedEvent를 처리합니다.

function onConnection()

recognizeOnceAsync((e: TranslationRecognitionResult) => void, (e: string) => void)

인식 및 번역을 시작하고 첫 번째 발화가 인식된 후 중지됩니다. 태스크는 번역 텍스트를 결과로 반환합니다. 참고: recognizeOnceAsync는 첫 번째 발화가 인식되면 를 반환하므로 명령이나 쿼리와 같은 단일 샷 인식에만 적합합니다. 장기 실행 인식의 경우 startContinuousRecognitionAsync()를 대신 사용합니다.

function recognizeOnceAsync(cb?: (e: TranslationRecognitionResult) => void, err?: (e: string) => void)

매개 변수

cb

(e: TranslationRecognitionResult) => void

번역이 완료되었을 때 결과를 받은 콜백입니다.

err

(e: string) => void

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

removeTargetLanguage(string)

대상 언어 목록에서 언어를 동적으로 제거합니다(인식이 진행되는 동안 사용할 수 있음).

function removeTargetLanguage(lang: string)

매개 변수

lang

string

제거할 언어

startContinuousRecognitionAsync(() => void, (e: string) => void)

stopContinuousRecognitionAsync()가 호출될 때까지 인식 및 번역을 시작합니다. 사용자는 변환 결과를 받으려면 이벤트를 구독해야 합니다.

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

매개 변수

cb

() => void

번역을 받은 콜백이 시작되었습니다.

err

(e: string) => void

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

stopContinuousRecognitionAsync(() => void, (e: string) => void)

연속 인식 및 번역을 중지합니다.

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

매개 변수

cb

() => void

번역을 받은 콜백이 중지되었습니다.

err

(e: string) => void

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

상속된 메서드 세부 정보

enableTelemetry(boolean)

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

static function enableTelemetry(enabled: boolean)

매개 변수

enabled

boolean

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

Recognizer.enableTelemetry에서 상속됨