SpeechRecognizer 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
기본 또는 사용자 지정 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
- 상속
- 특성
- 구현
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 속성에 지정된 SpeechRecognitionGrammarFileConstraint 및 SpeechRecognitionListConstraint 개체의 사용자 지정 문법에서 지원하는 언어 컬렉션을 가져옵니다. |
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 속성이 변경될 때 발생합니다. |