TranslationRecognizer class
번역 인식기
- Extends
생성자
Translation |
TranslationRecognizer의 instance 초기화합니다. |
속성
authorization |
서비스와 통신하는 데 사용되는 권한 부여 토큰을 가져옵니다. |
canceled | 이벤트가 취소됨은 인식 중에 오류가 발생했음을 나타냅니다. |
internal |
|
properties | 이 TranslationRecognizer에 대해 정의된 속성 및 해당 값의 컬렉션입니다. |
recognized | 이벤트가 인식되면 최종 인식 결과가 수신되었음을 알 수 있습니다. |
recognizing | 이벤트를 인식하면 중간 인식 결과가 수신됨을 알 수 있습니다. |
speech |
인식기를 만들 때 설정된 언어 이름을 가져옵니다. |
synthesizing | 이벤트 합성은 변환 합성 결과를 수신한다는 신호를 보냅니다. |
target |
인식기를 만들 때 설정된 번역의 대상 언어를 가져옵니다. 언어는 BCP-47 형식으로 지정됩니다. 번역은 각 언어에 대해 번역된 텍스트를 제공합니다. |
telemetry |
이 메서드는 원격 분석 설정의 현재 상태를 반환합니다. |
voice |
출력 음성의 이름을 가져옵니다. |
상속된 속성
session |
세션 시작 이벤트에 대한 이벤트 처리기를 정의합니다. |
session |
세션 중지 이벤트에 대한 이벤트 처리기를 정의합니다. |
speech |
음성 중지 이벤트에 대한 이벤트 처리기를 정의합니다. |
speech |
음성 시작 이벤트에 대한 이벤트 처리기를 정의합니다. |
메서드
add |
대상 언어 목록에 언어를 동적으로 추가(인식이 진행되는 동안 사용할 수 있음) |
close(() => void, (error: string) => void) | 는 이 클래스의 instance 보유한 모든 외부 리소스를 닫습니다. |
From |
TranslationRecognizer 생성자입니다. |
on |
는 대화 번역 시나리오에 대한 ConnectionEstablishedEvent를 처리합니다. |
recognize |
인식 및 번역을 시작하고 첫 번째 발화가 인식된 후 중지됩니다. 태스크는 번역 텍스트를 결과로 반환합니다. 참고: recognizeOnceAsync는 첫 번째 발화가 인식되면 를 반환하므로 명령이나 쿼리와 같은 단일 샷 인식에만 적합합니다. 장기 실행 인식의 경우 startContinuousRecognitionAsync()를 대신 사용합니다. |
remove |
대상 언어 목록에서 언어를 동적으로 제거합니다(인식이 진행되는 동안 사용할 수 있음). |
start |
stopContinuousRecognitionAsync()가 호출될 때까지 인식 및 번역을 시작합니다. 사용자는 변환 결과를 받으려면 이벤트를 구독해야 합니다. |
stop |
연속 인식 및 번역을 중지합니다. |
상속된 메서드
enable |
이 메서드는 원격 분석을 전역적으로 사용하거나 사용하지 않도록 설정합니다. |
생성자 세부 정보
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
sessionStopped
세션 중지 이벤트에 대한 이벤트 처리기를 정의합니다.
public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void
속성 값
(sender: Recognizer, event: SessionEventArgs) => void
speechEndDetected
음성 중지 이벤트에 대한 이벤트 처리기를 정의합니다.
public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
속성 값
(sender: Recognizer, event: RecognitionEventArgs) => void
speechStartDetected
음성 시작 이벤트에 대한 이벤트 처리기를 정의합니다.
public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
속성 값
(sender: Recognizer, event: RecognitionEventArgs) => void
메서드 세부 정보
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로 전송되지 않습니다.