다음을 통해 공유


SpeechRecognizer class

마이크, 파일 또는 기타 오디오 입력 스트림에서 음성 인식을 수행하고 그 결과로 전사된 텍스트를 가져옵니다.

Extends

생성자

SpeechRecognizer(SpeechConfig, AudioConfig)

SpeechRecognizer 생성자입니다.

속성

authorizationToken

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

canceled

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

endpointId

음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID를 가져옵니다.

internalData
outputFormat

인식의 출력 형식을 가져옵니다.

properties

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

recognized

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

recognizing

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

speechRecognitionLanguage

인식의 음성 언어를 가져옵니다.

telemetryEnabled

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

상속된 속성

sessionStarted

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

sessionStopped

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

speechEndDetected

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

speechStartDetected

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

메서드

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

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

dispose(boolean)

개체가 보유한 모든 리소스를 삭제합니다.

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

SpeechRecognizer 생성자입니다.

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

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

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

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

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

stopKeywordRecognitionAsync()가 호출될 때까지 키워드(keyword) 스포팅을 사용하여 음성 인식을 시작합니다. 사용자는 인식 결과를 받으려면 이벤트를 구독해야 합니다. 참고: 핵심 단어 스포팅 기능은 Speech Devices SDK에서만 사용할 수 있습니다. 이 기능은 현재 SDK 자체에 포함되지 않습니다.

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

연속 음성 인식을 중지합니다.

stopKeywordRecognitionAsync(() => void)

연속 음성 인식을 중지합니다. 참고: 핵심 단어 스포팅 기능은 Speech Devices SDK에서만 사용할 수 있습니다. 이 기능은 현재 SDK 자체에 포함되지 않습니다.

상속된 메서드

enableTelemetry(boolean)

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

생성자 세부 정보

SpeechRecognizer(SpeechConfig, AudioConfig)

SpeechRecognizer 생성자입니다.

new SpeechRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

매개 변수

speechConfig
SpeechConfig

이 인식기의 초기 속성 집합

audioConfig
AudioConfig

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

속성 세부 정보

authorizationToken

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

string authorizationToken

속성 값

string

권한 부여 토큰입니다.

canceled

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

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

속성 값

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

endpointId

음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID를 가져옵니다.

string endpointId

속성 값

string

음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID입니다.

internalData

object internalData

속성 값

object

outputFormat

인식의 출력 형식을 가져옵니다.

OutputFormat outputFormat

속성 값

인식의 출력 형식입니다.

properties

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

PropertyCollection properties

속성 값

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

recognized

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

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

속성 값

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

recognizing

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

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

속성 값

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

speechRecognitionLanguage

인식의 음성 언어를 가져옵니다.

string speechRecognitionLanguage

속성 값

string

인식의 음성 언어입니다.

telemetryEnabled

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

static boolean telemetryEnabled

속성 값

boolean

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

상속된 속성 세부 정보

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, errorCb?: (error: string) => void)

매개 변수

cb

() => void

errorCb

(error: string) => void

dispose(boolean)

개체가 보유한 모든 리소스를 삭제합니다.

function dispose(disposing: boolean): Promise<void>

매개 변수

disposing

boolean

개체를 삭제하는 경우 true입니다.

반환

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

SpeechRecognizer 생성자입니다.

static function FromConfig(speechConfig: SpeechConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): SpeechRecognizer

매개 변수

speechConfig
SpeechConfig

이 인식기의 초기 속성 집합

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

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

audioConfig
AudioConfig

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

반환

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

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

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

매개 변수

cb

(e: SpeechRecognitionResult) => void

SpeechRecognitionResult를 받은 콜백입니다.

err

(e: string) => void

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

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

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

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

매개 변수

cb

() => void

인식이 시작되면 콜백이 호출됩니다.

err

(e: string) => void

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

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

stopKeywordRecognitionAsync()가 호출될 때까지 키워드(keyword) 스포팅을 사용하여 음성 인식을 시작합니다. 사용자는 인식 결과를 받으려면 이벤트를 구독해야 합니다. 참고: 핵심 단어 스포팅 기능은 Speech Devices SDK에서만 사용할 수 있습니다. 이 기능은 현재 SDK 자체에 포함되지 않습니다.

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

매개 변수

model
KeywordRecognitionModel

인식할 키워드(keyword) 지정하는 키워드(keyword) 인식 모델입니다.

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

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

stopKeywordRecognitionAsync(() => void)

연속 음성 인식을 중지합니다. 참고: 핵심 단어 스포팅 기능은 Speech Devices SDK에서만 사용할 수 있습니다. 이 기능은 현재 SDK 자체에 포함되지 않습니다.

function stopKeywordRecognitionAsync(cb?: () => void)

매개 변수

cb

() => void

인식이 중지되면 콜백이 호출됩니다.

상속된 메서드 세부 정보

enableTelemetry(boolean)

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

static function enableTelemetry(enabled: boolean)

매개 변수

enabled

boolean

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

Recognizer.enableTelemetry에서 상속됨