kata kunci kelasRecognizer

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 dikabeli 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

Sintaks: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Sinyal untuk peristiwa yang terkait dengan pengenalan kata kunci.

Dibatalkan

Sintaks: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

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

Sifat

Sintaks: public const PropertyCollection & Properties;

Kumpulan properti dan nilainya ditentukan untuk KeywordRecognizer ini.

~KeywordRecognizer

Sintaks: public inline ~KeywordRecognizer ( );

Destruktor.

RecognizeOnceAsync

Sintaks: 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 dinaikkan dan sesi akan berakhir. Untuk menyerbu ulang kata kunci, metode perlu dipanggil lagi setelah peristiwa dipancarkan.

Parameter-parameternya

  • model KeywordRecognitionModel yang menjelaskan kata kunci yang ingin kita deteksi.

Pengembalian

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

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

StopRecognitionAsync

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

Menghentikan sesi pengenalan kata kunci yang saat ini aktif.

Pengembalian

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

FromConfig

Sintaks: 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-parameternya

  • audioConfig Menentukan input audio yang akan digunakan oleh pengenal.

Pengembalian

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