DialogServiceConnector Класс

Объект, который взаимодействует с системой диалоговых окон с поддержкой речи с помощью Bot Framework или пользовательских команд. Этот тип получает результаты преобразования речи в текст, а также упрощает асинхронную отправку и получение данных о действиях диалога, не относящихся к речи.

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

builtins.object

DialogServiceConnector

Конструктор

DialogServiceConnector(dialog_service_config: DialogServiceConfig, audio_config: AudioConfig | None = None)

Параметры

Имя	Описание
dialog_service_config Обязательно	Конфигурация для службы диалоговых окон либо для bot framework, либо для пользовательских команд.
audio_config	Конфигурация для аудиовхода. значение по умолчанию: None

Методы

connect	Синхронно устанавливает соединение со службой. Подключение выполняется автоматически при необходимости, но этот вызов вручную может быть полезен, чтобы убедиться, что подключение активно перед первым использованием, чтобы уменьшить начальную задержку. При возврате подключение может быть еще не готово. Подпишитесь на событие connected экземпляра Connection , чтобы получать уведомления при установке подключения к службе. Используйте для Connection получения экземпляра с помощью from_dialog_service_connector метода .
connect_async	Асинхронно устанавливает соединение со службой. Подключение выполняется автоматически при необходимости, но этот вызов вручную может быть полезен, чтобы убедиться, что подключение активно перед первым использованием, чтобы уменьшить начальную задержку.
disconnect	Синхронно отключается от службы. Последующие вызовы, требующие подключения, будут по-прежнему автоматически повторно подключаться после отключения вручную.
disconnect_async	Асинхронно отключается от службы. Последующие вызовы, требующие подключения, будут по-прежнему автоматически повторно подключаться после отключения вручную.
listen_once	Синхронно запускает взаимодействие речи с текстом с этим соединителем и блокируется, пока не будет получен окончательный результат преобразования речи в текст. Полученный результат преобразования речи в текст также предоставляется для настроенной реализации диалога, и эта диалоговая система может создавать любое количество полезных данных действий в ответ на речевые взаимодействия. Речевые взаимодействия могут быть сопоставлены с действиями с помощью данных, относящихся к диалогу, в полезных данных действия.
listen_once_async	Асинхронно запускает взаимодействие преобразования речи в текст с этим соединителем и блокируется до получения одного конечного результата преобразования речи в текст. Полученный результат преобразования речи в текст также предоставляется для настроенной реализации диалога, и эта диалоговая система может создавать любое количество полезных данных действий в ответ на речевые взаимодействия. Речевые взаимодействия могут быть сопоставлены с действиями с помощью данных, относящихся к диалогу, в полезных данных действия.
send_activity	Синхронно отправляет полезные данные в серверную службу диалога, к которому подключен этот экземпляр DialogServiceConnector. Обычно это документ JSON со схемой, определяемой реализацией диалога в службе, и содержимое отправленного действия должно быть заполнено знаниями о форматах и ожиданиях содержимого диалоговой системы. Отправленные действия не связаны с каким-либо другим взаимодействием и создают собственный идентификатор автономного взаимодействия при обработке службой. Корреляция бесед и других взаимодействий должна осуществляться через полезные данные действия, используя возможности используемой реализации диалога.
send_activity_async	Асинхронно отправляет действие в диалоговое окно резервного копирования. Сведения о описании см. в разделе send_activity
start_keyword_recognition	Синхронно запускает взаимодействие речи с текстом с этим соединителем с помощью ключевого слова . Это взаимодействие будет использовать предоставленную модель ключевых слов для прослушивания ключевого слова неограниченное время, в течение которого звук не отправляется в службу распознавания речи, а вся обработка выполняется локально. При распознавании ключевого слова DialogServiceConnector автоматически подключается к службе распознавания речи и начинает отправлять звуковые данные непосредственно перед вызовом ключевого слова listen_once_async . При получении результаты преобразования речи в текст могут обрабатываться предоставленным обработчиком результатов или извлекаться через подписку на распознанное событие. Результат преобразования речи в текст, полученный в результате этой операции, также предоставляется для настроенной реализации диалога, и эта диалоговая система может создавать любое количество полезных данных действий в ответ на речевые взаимодействия. Речевые взаимодействия могут быть сопоставлены с действиями с помощью данных, относящихся к диалогу, в полезных данных действия. Вызовите stop_keyword_recognition_async , чтобы остановить распознавание, инициированное ключевым словом.
start_keyword_recognition_async	Асинхронно настраивает соединитель службы диалогов с заданной моделью ключевых слов. После вызова этого метода соединитель прослушивает ключевое слово для запуска распознавания. Вызовите stop_keyword_recognition_async , чтобы остановить распознавание, инициированное ключевым словом. Подробное описание функциональных возможностей см start_keyword_recognition . в этой статье.
stop_keyword_recognition	Синхронно останавливает распознавание, инициированное ключевым словом.
stop_keyword_recognition_async	Асинхронно останавливает распознавание, инициированное ключевым словом.
stop_listening	Запрашивает немедленную остановку любой активной операции прослушивания. Это может прервать взаимодействие речи с текстом, а любой полученный результат преобразования речи в текст может представлять собой неполный речевой ввод. Синхронные методы не должны вызываться при обработке события. Используйте , stop_listening_async если требуется остановка в ответ на событие.
stop_listening_async	Запрашивает немедленную остановку любой активной операции прослушивания. Это может прервать взаимодействие речи с текстом, а любой полученный результат преобразования речи в текст может представлять собой неполный речевой ввод.

connect

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

При возврате подключение может быть еще не готово. Подпишитесь на событие connected экземпляра Connection , чтобы получать уведомления при установке подключения к службе. Используйте для Connection получения экземпляра с помощью from_dialog_service_connector метода .

connect()

connect_async

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

connect_async()

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

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

disconnect

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

disconnect()

disconnect_async

Асинхронно отключается от службы. Последующие вызовы, требующие подключения, будут по-прежнему автоматически повторно подключаться после отключения вручную.

disconnect_async()

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

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

listen_once

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

listen_once() -> SpeechRecognitionResult

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

Тип	Описание
	результат преобразования речи в текст из распознавания речи.

listen_once_async

Асинхронно запускает взаимодействие преобразования речи в текст с этим соединителем и блокируется до получения одного конечного результата преобразования речи в текст. Полученный результат преобразования речи в текст также предоставляется для настроенной реализации диалога, и эта диалоговая система может создавать любое количество полезных данных действий в ответ на речевые взаимодействия. Речевые взаимодействия могут быть сопоставлены с действиями с помощью данных, относящихся к диалогу, в полезных данных действия.

listen_once_async() -> ResultFuture

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

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

send_activity

Синхронно отправляет полезные данные в серверную службу диалога, к которому подключен этот экземпляр DialogServiceConnector. Обычно это документ JSON со схемой, определяемой реализацией диалога в службе, и содержимое отправленного действия должно быть заполнено знаниями о форматах и ожиданиях содержимого диалоговой системы. Отправленные действия не связаны с каким-либо другим взаимодействием и создают собственный идентификатор автономного взаимодействия при обработке службой. Корреляция бесед и других взаимодействий должна осуществляться через полезные данные действия, используя возможности используемой реализации диалога.

send_activity(activity: str) -> str

Параметры

Имя	Описание
activity Обязательно	сериализованные полезные данные отправляемого действия.

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

Тип

Описание

идентификатор взаимодействия, полученный при подтверждении действия службой. Это может произойти до того, как действие будет обработано и оценено реализацией диалога, а получение идентификатора взаимодействия не указывает на успешное или неудачное выполнение действия. Сведения об успешном или неудачном выполнении могут быть получены с помощью действий ответа с данными корреляции или событий TurnStatusReceived, которые коррелируют с этим идентификатором взаимодействия.

send_activity_async

Асинхронно отправляет действие в диалоговое окно резервного копирования. Сведения о описании см. в разделе send_activity

send_activity_async(activity: str) -> ResultFuture

Параметры

Имя	Описание
activity Обязательно	сериализованные полезные данные отправляемого действия.

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

Тип	Описание
	Будущее, содержащее результирующий результат операции отправки асинхронного действия.

start_keyword_recognition

Синхронно запускает взаимодействие речи с текстом с этим соединителем с помощью ключевого слова . Это взаимодействие будет использовать предоставленную модель ключевых слов для прослушивания ключевого слова неограниченное время, в течение которого звук не отправляется в службу распознавания речи, а вся обработка выполняется локально. При распознавании ключевого слова DialogServiceConnector автоматически подключается к службе распознавания речи и начинает отправлять звуковые данные непосредственно перед вызовом ключевого слова listen_once_async . При получении результаты преобразования речи в текст могут обрабатываться предоставленным обработчиком результатов или извлекаться через подписку на распознанное событие. Результат преобразования речи в текст, полученный в результате этой операции, также предоставляется для настроенной реализации диалога, и эта диалоговая система может создавать любое количество полезных данных действий в ответ на речевые взаимодействия. Речевые взаимодействия могут быть сопоставлены с действиями с помощью данных, относящихся к диалогу, в полезных данных действия.

Вызовите stop_keyword_recognition_async , чтобы остановить распознавание, инициированное ключевым словом.

start_keyword_recognition(model: KeywordRecognitionModel)

Параметры

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

start_keyword_recognition_async

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

Подробное описание функциональных возможностей см start_keyword_recognition . в этой статье.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Параметры

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

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

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

stop_keyword_recognition

Синхронно останавливает распознавание, инициированное ключевым словом.

stop_keyword_recognition()

stop_keyword_recognition_async

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

stop_keyword_recognition_async()

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

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

stop_listening

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

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

stop_listening()

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

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

stop_listening_async

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

stop_listening_async()

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

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

Атрибуты

activity_received

Сообщает, что действие было получено от серверной части.

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

authorization_token

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

Примечание

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

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

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

canceled

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

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

recognized

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

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

recognizing

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

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

session_started

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

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

session_stopped

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

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

speech_activity_template

Возвращает шаблон JSON, который будет предоставлен службе распознавания речи для следующего диалога. Служба попытается объединить этот шаблон со всеми действиями, отправленными в серверную часть диалогового окна, независимо от того, были ли они созданы клиентом с помощью SendActivityAsync или созданы службой, как в случае с результатами преобразования речи в текст.

speech_end_detected

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

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

speech_start_detected

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

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

turn_status_received

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

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