다음을 통해 공유

class KeywordRecognizer

  • 아티클
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

키워드(keyword) 활성화만 처리하도록 특수화된 인식기 형식입니다.

먼저 개체를 인스턴스화해야 합니다.

auto audioConfig = AudioConfig::FromMicrophoneInput(); // Or an alternative input
auto recognizer = [KeywordRecognizer::FromConfig](#fromconfig)(audioConfig);

(선택 사항) 그런 다음, 알림을 받으려면 이벤트를 유선으로 연결해야 합니다.

recognizer->Recognized += [](const KeywordRecognitionEventArgs& event)
{
    // Your logic here...
};

마지막으로 인식을 시작해야 합니다.

auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();

멤버

인식

구문: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

키워드 인식과 관련된 이벤트에 대한 신호입니다.

취소됨

구문: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

상호 작용 취소와 관련된 이벤트에 대한 신호입니다. 이벤트는 이유가 직접 취소 또는 오류인지 여부를 나타냅니다.

속성

구문: public constPropertyCollection & Properties;

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

~KeywordRecognizer

구문: public inline ~KeywordRecognizer ( );

소멸자

RecognizeOnceAsync

구문: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

키워드(keyword) 인식 세션을 시작합니다. 이 세션은 첫 번째 키워드(keyword) 인식될 때까지 지속됩니다. 이 경우 Recognized 이벤트가 발생하고 세션이 종료됩니다. 키워드(keyword) 다시 정렬하려면 이벤트가 내보내진 후 메서드를 다시 호출해야 합니다.

매개 변수

반환

키워드(keyword) 검색되면 확인되는 KeywordRecognitionResult로 확인되는 미래입니다.

입력에서 키워드(keyword) 검색되지 않으면 StopRecognition이 호출되지 않는 한 작업이 resolve 않습니다.

StopRecognitionAsync

구문: public inline std::future< void > StopRecognitionAsync ( );

현재 활성 키워드(keyword) 인식 세션을 중지합니다.

반환

활성 세션(있는 경우)이 중지될 때 해결되는 미래입니다.

FromConfig

구문: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

AudioConfig에서 KeywordRecognizer를 만듭니다. 구성은 인식기 개체에서 사용할 오디오 입력을 정의하기 위한 것입니다.

매개 변수

  • audioConfig 인식기에서 사용할 오디오 입력을 정의합니다.

반환

지정된 입력의 오디오를 사용하는 새 KeywordRecognizer입니다.

오디오 구성이 제공되지 않으면 AudioConfig::FromDefaultMicrophoneInput으로 생성된 구성을 사용하여 를 호출하는 것과 같습니다.