Aracılığıyla paylaş

class KeywordRecognizer

  • Makale
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Yalnızca anahtar sözcük etkinleştirmeyi işlemek için özelleştirilmiş tanıyıcı türü.

İlk olarak, nesnenin örneği oluşturulmalıdır:

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

(isteğe bağlı) Ardından, bildirimleri almak için olayların kablolu olması gerekir:

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

Son olarak, tanımanın başlatılması gerekir.

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

Üyeler

Tanınan

Söz dizimi: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Anahtar sözcüklerin tanınması ile ilgili olaylar için sinyal.

İptal edildi

Söz dizimi: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Bir etkileşimin iptali ile ilgili olaylar için sinyal. Olay, nedeninin doğrudan iptal mi yoksa hata mı olduğunu gösterir.

Özellikler

Söz dizimi: public constPropertyCollection & Properties;

Bu KeywordRecognizer için tanımlanan özellikler ve değerleri koleksiyonu.

~KeywordRecognizer

Söz dizimi: public inline ~KeywordRecognizer ( );

Yıkıcı.

RecognizeOnceAsync

Söz dizimi: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Anahtar sözcük tanıma oturumu başlatır. Bu oturum, ilk anahtar sözcük tanınana kadar sürer. Bu durumda, tanınan bir olay tetiklenir ve oturum sona erer. Anahtar sözcüğünü yeniden etkinleştirmek için, olay gönderildikten sonra yönteminin yeniden çağrılması gerekir.

Parametreler

Döndürülenler

Anahtar sözcük algılandıktan sonra çözümlenen keywordRecognitionResult'a çözümlenen bir gelecek.

Girişte anahtar sözcük algılanmadıysa görevin hiçbir zaman çözümlenmeyeceğini unutmayın (StopRecognition çağrılmadığı sürece).

StopRecognitionAsync

Söz dizimi: public inline std::future< void > StopRecognitionAsync ( );

Şu anda etkin olan anahtar sözcük tanıma oturumlarını durdurur.

Döndürülenler

Etkin oturum (varsa) durdurulduğunda çözülen bir gelecek.

FromConfig

Söz dizimi: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

Bir AudioConfig'den KeywordRecognizer oluşturur. Yapılandırma, tanıyıcı nesnesi tarafından kullanılacak ses girişini tanımlamaya yöneliktir.

Parametreler

  • audioConfig Tanıyıcı tarafından kullanılacak ses girişini tanımlar.

Döndürülenler

Belirtilen girişten ses kullanacak yeni bir KeywordRecognizer.

Hiçbir ses yapılandırması sağlanmazsa, AudioConfig::FromDefaultMicrophoneInput ile oluşturulan bir yapılandırma ile çağrıya eşdeğer olacaktır