Share via

kata kunci kelasRecognizer

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

Jenis recognizer yang dikhususkan untuk hanya menangani aktivasi kata kunci.

Pertama, objek perlu dibuat:

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

(opsional) Kemudian, peristiwa perlu ditransfer untuk menerima pemberitahuan:

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

Dan akhirnya, pengakuan perlu dimulai.

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

Anggota

Diakui

Sitnaksis: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Sinyal untuk peristiwa yang terkait dengan pengenalan kata kunci.

Batal

Sitnaksis: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Sinyal untuk peristiwa yang berkaitan dengan pembatalan interaksi. Peristiwa menunjukkan apakah alasannya adalah pembatalan langsung atau kesalahan.

Properti

Sitnaksis: public constPropertyCollection & Properties;

Kumpulan properti dan nilainya ditentukan untuk KeywordRecognizer ini.

~KeywordRecognizer

Sitnaksis: public inline ~KeywordRecognizer ( );

Destruktor.

RecognizeOnceAsync

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

Memulai sesi pengenalan kata kunci. Sesi ini akan berlangsung hingga kata kunci pertama dikenali. Ketika ini terjadi, peristiwa yang Dikenali akan dimunculkan dan sesi akan berakhir. Untuk menata ulang kata kunci, metode perlu dipanggil lagi setelah peristiwa dipancarkan.

Parameter

Mengembalikan

Masa depan yang diselesaikan ke KeywordRecognitionResult yang diselesaikan setelah kata kunci terdeteksi.

Perhatikan bahwa jika tidak ada kata kunci yang terdeteksi dalam input, tugas tidak akan pernah diselesaikan (kecuali StopRecognition dipanggil.

StopRecognitionAsync

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

Menghentikan sesi pengenalan kata kunci yang saat ini aktif.

Mengembalikan

Masa depan yang diselesaikan ketika sesi aktif (jika ada) dihentikan.

FromConfig

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

Membuat KeywordRecognizer dari AudioConfig. Konfigurasi dimaksudkan untuk menentukan input audio yang akan digunakan oleh objek recognizer.

Parameter

  • audioConfig Menentukan input audio yang akan digunakan oleh pengenal.

Mengembalikan

KeywordRecognizer baru yang akan menggunakan audio dari input yang ditentukan.

Jika tidak ada konfigurasi audio yang disediakan, itu akan setara dengan panggilan dengan konfigurasi yang dibangun dengan AudioConfig::FromDefaultMicrophoneInput