다음을 통해 공유


SpeechRecognizer 클래스

정의

기본 또는 사용자 지정 GUI(그래픽 사용자 인터페이스)를 사용하여 음성 인식을 사용하도록 설정합니다.

public ref class SpeechRecognizer sealed : IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SpeechRecognizer final : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SpeechRecognizer final : IClosable
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SpeechRecognizer : System.IDisposable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SpeechRecognizer : System.IDisposable
function SpeechRecognizer(language)
Public NotInheritable Class SpeechRecognizer
Implements IDisposable
상속
Object Platform::Object IInspectable SpeechRecognizer
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

Constraints 속성에 제약 조건이 지정되지 않은 경우에도 CompileConstraintsAsync는 항상 RecognizeAsync 또는 RecognizeWithUIAsync 전에 호출되어야 합니다.

버전 기록

Windows 버전 SDK 버전 추가된 값
1709 16299 TrySetSystemSpeechLanguageAsync

생성자

SpeechRecognizer()

SpeechRecognizer 클래스의 새 instance 만듭니다.

SpeechRecognizer(Language)

언어 지정자를 사용하여 SpeechRecognizer 클래스의 새 instance 만듭니다.

속성

Constraints

SpeechRecognizer 개체에 현재 추가된 제약 조건 개체의 컬렉션을 가져옵니다.

ContinuousRecognitionSession

SpeechRecognizer와 연결된 연속 인식 세션 개체(SpeechContinuousRecognitionSession)를 가져옵니다.

CurrentLanguage

음성 인식에 사용되는 언어를 가져옵니다.

State

음성 인식기의 상태를 가져옵니다.

SupportedGrammarLanguages

Constraints 속성에 지정된 SpeechRecognitionGrammarFileConstraintSpeechRecognitionListConstraint 개체의 사용자 지정 문법에서 지원하는 언어 컬렉션을 가져옵니다.

SupportedTopicLanguages

Constraints 속성에 지정된 SpeechRecognitionTopicConstraint 개체의 미리 정의된 웹 서비스 문법에서 지원하는 언어 컬렉션을 가져옵니다.

SystemSpeechLanguage

설정 > 시간 & Language Speech에 지정된 디바이스의 음성 언어를 >가져옵니다.

Timeouts

음성 인식기가 무음 또는 인식할 수 없는 소리(babble)를 무시하고 음성 입력을 계속 듣는 기간을 가져옵니다.

UIOptions

RecognizeWithUIAsync 메서드에 대한 UI 설정을 가져옵니다.

메서드

Close()

할당된 리소스를 해제, 해제 또는 다시 설정하여 음성 인식기를 삭제합니다.

CompileConstraintsAsync()

Constraints 속성에 지정된 모든 제약 조건을 비동기적으로 컴파일합니다.

Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

RecognizeAsync()

SpeechRecognizer 개체에 대한 음성 인식 세션을 시작합니다.

RecognizeWithUIAsync()

프롬프트, 예제, TTS(텍스트 음성 변환) 및 확인을 비롯한 추가 UI 메커니즘을 포함하는 음성 인식 세션을 비동기적으로 시작합니다.

StopRecognitionAsync()

음성 인식 세션을 비동기적으로 종료합니다.

TrySetSystemSpeechLanguageAsync(Language)

IoT 디바이스에서 음성 인식에 사용되는 시스템 언어를 비동기적으로 설정하려고 합니다.

참고

이 메서드는 포함 모드에서만 사용할 수 있습니다.

이벤트

HypothesisGenerated

음성 인식기에서 인식 결과 조각을 반환할 때 진행 중인 받아쓰기 세션 중에 발생합니다.

RecognitionQualityDegrading

이 이벤트는 인식 정확도에 영향을 줄 수 있는 오디오 문제가 감지될 때 발생합니다.

StateChanged

이 이벤트는 오디오 캡처 중에 State 속성이 변경될 때 발생합니다.

적용 대상

추가 정보