класс KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Тип распознавателя, специализированный для обработки только активации ключевых слов.

Сначала необходимо создать экземпляр объекта:

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< const KeywordRecognitionEventArgs & > Recognized;

Сигнал для событий, связанных с распознаванием ключевых слов.

Отменено

Синтаксис: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Сигнал о событиях, связанных с отменой взаимодействия. Событие указывает, является ли причина прямой отменой или ошибкой.

Свойства

Синтаксис: public const PropertyCollection & Properties;

Коллекция свойств и их значений, определенных для этого ключевого словаRecognizer.

~KeywordRecognizer

Синтаксис: public inline ~KeywordRecognizer ( );

Деструктор.

RecognizeOnceAsync

Синтаксис: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Запускает сеанс распознавания ключевых слов. Этот сеанс будет длиться до тех пор, пока не будет распознано первое ключевое слово. В этом случае будет возникать событие распознаваемого, и сеанс завершится. Чтобы перезаставить ключевое слово, метод необходимо вызвать еще раз после создания события.

Параметры

  • model Ключевое слово KeywordRecognitionModel, описывающее ключевое слово, которое мы хотим обнаружить.

Возвраты

Будущее, разрешающее KeywordRecognitionResult, разрешающее после обнаружения ключевого слова.

Обратите внимание, что если ключевое слово не обнаружено во входных данных, задача никогда не будет разрешаться (если не вызывается StopRecognition.

StopRecognitionAsync

Синтаксис: public inline std::future< void > StopRecognitionAsync ( );

Останавливает текущий активный сеанс распознавания ключевых слов.

Возвраты

Будущее, которое разрешается при остановке активного сеанса (при наличии).

FromConfig

Синтаксис: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

Создает ключевое словоRecognizer из AudioConfig. Конфигурация предназначена для определения входных данных звука, используемых объектом распознавателя.

Параметры

  • audioConfig Определяет входной звук, используемый распознавательом.

Возвраты

Новый ключевой словоRecognizer, который будет использовать звук из указанного входного данных.

Если аудиоконфигура не предоставлена, он будет эквивалентен вызову конфигурации, созданной с помощью AudioConfig::FromDefaultMicrophoneInput

  • Last updated on