Поделиться через

IntentRecognizer Класс

  • Ссылка

Помимо распознавания речи в текст, IntentRecognizer извлекает структурированные сведения о намерении говорящего.

Наследование
Recognizer
IntentRecognizer

Конструктор

IntentRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig | None = None, intents: Iterable[Tuple[str | LanguageUnderstandingModel, str]] | None = None)

Параметры

Имя Описание
speech_config
Обязательно

Конфигурация для распознавателя речи.
audio_config

Конфигурация для аудиовхода.

значение по умолчанию: None
intents

Намерения из итерируемой пары (модель, intent_id) или (simple_phrase, intent_id) для распознавания.

значение по умолчанию: None

Методы

add_all_intents

Добавляет все намерения из указанной модели Распознавание речи.
add_intent

Добавьте намерение в распознаватель. Это можно сделать разными способами.

  • add_intent(simple_phrase): добавляет простую фразу, которую может произносить пользователь, указывая на определенное намерение пользователя.

  • add_intent(simple_phrase, intent_id): добавляет простую фразу, которую может произносить пользователь, указывая на определенное намерение пользователя. После распознавания идентификатор намерения результата будет соответствовать указанному здесь идентификатору.

  • add_intent(model, intent_name): добавляет одно намерение по имени из указанного LanguageUnderstandingModelобъекта .

  • add_intent(model, intent_name, intent_id): добавляет одно намерение по имени из указанного LanguageUnderstandingModelобъекта .

  • add_intent(trigger, intent_id): добавляет указанный объект IntentTrigger. IntentTrigger.
add_intents

Добавьте намерения из итерируемой пары (модель, intent_id) или (simple_phrase, intent_id).
recognize_once

Выполняет распознавание в блокирующем (синхронном) режиме. Возвращает после распознавания одиночного речевого фрагмента. Конец одного речевого фрагмента определяется путем прослушивания до тишины в конце, или пока не будет обработано максимум 15 секунд аудио. Задача возвращает текст распознавания как результат. Для распознавания длительных потоков с большим количеством речевых фрагментов используйте start_continuous_recognition_async.
recognize_once_async

Выполняет распознавание в неблокирующем (асинхронном) режиме. Это позволит распознать одиночный речевой фрагмент. Конец одного речевого фрагмента определяется путем прослушивания до тишины в конце, или пока не будет обработано максимум 15 секунд аудио. Для распознавания длительных потоков с большим количеством речевых фрагментов используйте start_continuous_recognition_async.
start_continuous_recognition

Синхронно инициирует непрерывную операцию распознавания. Чтобы получить результаты распознавания, пользователь должен подключиться к EventSignal. Вызовите stop_continuous_recognition_async , чтобы остановить распознавание.
start_continuous_recognition_async

Асинхронно инициирует непрерывную операцию распознавания. Чтобы получить результаты распознавания, пользователь должен подключиться к EventSignal. Вызовите stop_continuous_recognition_async , чтобы остановить распознавание.
start_keyword_recognition

Синхронно настраивает распознаватель с заданной моделью ключевое слово. После вызова этого метода распознаватель прослушивает ключевое слово для запуска распознавания. Вызовите stop_keyword_recognition(), чтобы завершить распознавание, инициированное ключевое слово.
start_keyword_recognition_async

Асинхронно настраивает распознаватель с использованием заданной модели ключевое слово. После вызова этого метода распознаватель прослушивает ключевое слово для запуска распознавания. Вызовите stop_keyword_recognition_async(), чтобы завершить распознавание, инициированное ключевое слово.
stop_continuous_recognition

Синхронно завершает текущую непрерывную операцию распознавания.
stop_continuous_recognition_async

Асинхронно завершает текущую непрерывную операцию распознавания.
stop_keyword_recognition

Синхронно завершается ключевое слово инициированное распознавание.
stop_keyword_recognition_async

Асинхронно завершает ключевое слово инициированное распознавание.

add_all_intents

Добавляет все намерения из указанной модели Распознавание речи.

add_all_intents(model: LanguageUnderstandingModel)

Параметры

Имя Описание
model
Обязательно

add_intent

Добавьте намерение в распознаватель. Это можно сделать разными способами.

  • add_intent(simple_phrase): добавляет простую фразу, которую может произносить пользователь, указывая на определенное намерение пользователя.

  • add_intent(simple_phrase, intent_id): добавляет простую фразу, которую может произносить пользователь, указывая на определенное намерение пользователя. После распознавания идентификатор намерения результата будет соответствовать указанному здесь идентификатору.

  • add_intent(model, intent_name): добавляет одно намерение по имени из указанного LanguageUnderstandingModelобъекта .

  • add_intent(model, intent_name, intent_id): добавляет одно намерение по имени из указанного LanguageUnderstandingModelобъекта .

  • add_intent(trigger, intent_id): добавляет указанный объект IntentTrigger. IntentTrigger.

add_intent(*args)

Параметры

Имя Описание
model
Обязательно

Модель распознавания речи, содержащая намерение.
intent_name
Обязательно

Имя одного намерения, включаемого из модели распознавания речи.
simple_phrase
Обязательно

Фраза, соответствующая намерению.
intent_id
Обязательно

Строка пользовательского идентификатора, возвращаемая в свойстве IntentRecognitionResultintent_id.
trigger
Обязательно

Объект IntentTrigger, соответствующий намерению.

add_intents

Добавьте намерения из итерируемой пары (модель, intent_id) или (simple_phrase, intent_id).

add_intents(intents_iter: Iterable[Tuple[str | LanguageUnderstandingModel, str]])

Параметры

Имя Описание
intents
Обязательно

Намерения из итерируемой пары (модель, intent_id) или (simple_phrase, intent_id) для распознавания.
intents_iter
Обязательно

recognize_once

Выполняет распознавание в блокирующем (синхронном) режиме. Возвращает после распознавания одиночного речевого фрагмента. Конец одного речевого фрагмента определяется путем прослушивания до тишины в конце, или пока не будет обработано максимум 15 секунд аудио. Задача возвращает текст распознавания как результат. Для распознавания длительных потоков с большим количеством речевых фрагментов используйте start_continuous_recognition_async.

recognize_once() -> IntentRecognitionResult

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

Тип Описание

Результирующий результат синхронного распознавания.

recognize_once_async

Выполняет распознавание в неблокирующем (асинхронном) режиме. Это позволит распознать одиночный речевой фрагмент. Конец одного речевого фрагмента определяется путем прослушивания до тишины в конце, или пока не будет обработано максимум 15 секунд аудио. Для распознавания длительных потоков с большим количеством речевых фрагментов используйте start_continuous_recognition_async.

recognize_once_async() -> ResultFuture

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

Тип Описание

Будущее, содержащее значение результата асинхронного распознавания.

start_continuous_recognition

Синхронно инициирует непрерывную операцию распознавания. Чтобы получить результаты распознавания, пользователь должен подключиться к EventSignal. Вызовите stop_continuous_recognition_async , чтобы остановить распознавание.

start_continuous_recognition()

start_continuous_recognition_async

Асинхронно инициирует непрерывную операцию распознавания. Чтобы получить результаты распознавания, пользователь должен подключиться к EventSignal. Вызовите stop_continuous_recognition_async , чтобы остановить распознавание.

start_continuous_recognition_async() -> ResultFuture

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

Тип Описание

Будущее, которое выполняется после инициализации распознавания.

start_keyword_recognition

Синхронно настраивает распознаватель с заданной моделью ключевое слово. После вызова этого метода распознаватель прослушивает ключевое слово для запуска распознавания. Вызовите stop_keyword_recognition(), чтобы завершить распознавание, инициированное ключевое слово.

start_keyword_recognition(model: KeywordRecognitionModel)

Параметры

Имя Описание
model
Обязательно

модель распознавания ключевое слово, указывающая ключевое слово для распознавания.

start_keyword_recognition_async

Асинхронно настраивает распознаватель с использованием заданной модели ключевое слово. После вызова этого метода распознаватель прослушивает ключевое слово для запуска распознавания. Вызовите stop_keyword_recognition_async(), чтобы завершить распознавание, инициированное ключевое слово.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Параметры

Имя Описание
model
Обязательно

модель распознавания ключевое слово, указывающая ключевое слово для распознавания.

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

Тип Описание

Будущее, которое выполняется после инициализации распознавания.

stop_continuous_recognition

Синхронно завершает текущую непрерывную операцию распознавания.

stop_continuous_recognition()

stop_continuous_recognition_async

Асинхронно завершает текущую непрерывную операцию распознавания.

stop_continuous_recognition_async()

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

Тип Описание

Будущее, которое выполняется после остановки распознавания.

stop_keyword_recognition

Синхронно завершается ключевое слово инициированное распознавание.

stop_keyword_recognition()

stop_keyword_recognition_async

Асинхронно завершает ключевое слово инициированное распознавание.

stop_keyword_recognition_async()

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

Тип Описание

Будущее, которое выполняется после остановки распознавания.

Атрибуты

authorization_token

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

Примечание

Вызывающий объект должен убедиться, что маркер авторизации действителен. Перед

срок действия маркера авторизации истекает, вызывающий объект должен обновить его, вызвав этот метод задания с помощью

новый допустимый маркер. В противном случае распознаватель столкнется с ошибками во время распознавания.

canceled

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

Обратные вызовы, подключенные к этому сигналу, вызываются с экземпляром IntentRecognitionCanceledEventArgs, в качестве одного аргумента.

endpoint_id

Идентификатор конечной точки настраиваемой модели речи, используемой для распознавания, или пользовательской голосовой модели для синтеза речи.

properties

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

recognized

Сигнал для событий, содержащих окончательные результаты распознавания (что указывает на успешную попытку распознавания).

Обратные вызовы, подключенные к этому сигналу, вызываются с экземпляром IntentRecognitionEventArgs в качестве одного аргумента в зависимости от типа распознавателя.

recognizing

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

Обратные вызовы, подключенные к этому сигналу, вызываются с помощью экземпляра IntentRecognitionEventArgs в качестве одного аргумента.

session_started

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

Обратные вызовы, подключенные к этому сигналу, вызываются с помощью экземпляра SessionEventArgs в качестве одного аргумента.

session_stopped

Сигнал для событий, указывающих на конец сеанса распознавания (операции).

Обратные вызовы, подключенные к этому сигналу, вызываются с помощью экземпляра SessionEventArgs в качестве одного аргумента.

speech_end_detected

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

Обратные вызовы, подключенные к этому сигналу, вызываются с помощью экземпляра RecognitionEventArgs в качестве одного аргумента.

speech_start_detected

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

Обратные вызовы, подключенные к этому сигналу, вызываются с помощью экземпляра RecognitionEventArgs в качестве одного аргумента.