class 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< 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 );

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

Параметры

Возвращаемое значение

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

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

StopRecognitionAsync

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

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

Возвращаемое значение

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

FromConfig

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

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

Параметры

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

Возвращаемое значение

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

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