Connection Класс

Класс прокси для управления подключением к службе распознавания речи указанного Recognizerобъекта .

По умолчанию Recognizer при необходимости автономно управляет подключением к службе. Класс Connection предоставляет пользователям дополнительные методы для явного открытия или закрытия подключения и подписки на изменения состояния подключения. Использовать Connection необязательно. Он предназначен для сценариев, в которых требуется точная настройка поведения приложения на основе состояния подключения. При необходимости пользователи могут вызвать open метод , чтобы вручную инициировать подключение к службе перед запуском распознавания объекта , связанного Recognizer с данным объектом Connection. После запуска распознавания вызов open или close может завершиться ошибкой. Это не повлияет на Распознаватель или текущее распознавание. Подключение может прервать по разным причинам. Распознаватель всегда будет пытаться повторно установить подключение, как это необходимо для обеспечения текущих операций. Во всех этих случаях connected/disconnected события указывают на изменение состояния подключения.

Примечание

Обновлено в версии 1.17.0.

Конструктор для внутреннего использования.

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

builtins.object

Connection

Конструктор

Connection(handle: c_void_p)

Параметры

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

Методы

close	Закрывает подключение к службе. При необходимости пользователи могут вызвать close , чтобы вручную завершить подключение связанного Recognizerобъекта . Вызов может завершиться ошибкой в зависимости от состояния процесса .Recognizer Но сбой не влияет на состояние связанного Recognizerобъекта .
from_dialog_service_connector	Connection Получает экземпляр из указанного соединителя службы диалоговых окон.
from_recognizer	Connection Получает экземпляр из указанного распознавателя.
from_speech_synthesizer	Connection Возвращает экземпляр из указанного синтезатора речи. Примечание Добавлено в версии 1.17.0.
open	Начинает настройку подключения к службе. При необходимости пользователи могут вызвать open метод , чтобы вручную настроить подключение, прежде чем начать распознавание объекта , связанного Recognizer с этим Connection. После запуска распознавания вызов open) может завершиться ошибкой в зависимости от состояния процесса .Recognizer Но сбой не влияет на состояние связанного Recognizerобъекта . Примечание При возврате подключение может быть еще не готово. Подпишитесь на событие connected, которое должно быть уведомлено при установлении подключения.
set_message_property	Добавляет параметр в сообщении в службу. Примечание Этот метод не работает для подключения SpeechSynthesizer.

close

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

close()

from_dialog_service_connector

Connection Получает экземпляр из указанного соединителя службы диалоговых окон.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Параметры

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

from_recognizer

Connection Получает экземпляр из указанного распознавателя.

from_recognizer(recognizer: Recognizer) -> Connection

Параметры

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

from_speech_synthesizer

Connection Возвращает экземпляр из указанного синтезатора речи.

Примечание

Добавлено в версии 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Параметры

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

open

Начинает настройку подключения к службе. При необходимости пользователи могут вызвать open метод , чтобы вручную настроить подключение, прежде чем начать распознавание объекта , связанного Recognizer с этим Connection. После запуска распознавания вызов open) может завершиться ошибкой в зависимости от состояния процесса .Recognizer Но сбой не влияет на состояние связанного Recognizerобъекта .

Примечание

При возврате подключение может быть еще не готово. Подпишитесь на

событие connected, которое должно быть уведомлено при установлении подключения.

open(for_continuous_recognition: bool)

Параметры

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

set_message_property

Добавляет параметр в сообщении в службу.

Примечание

Этот метод не работает для подключения SpeechSynthesizer.

set_message_property(path: str, property_name: str, property_value: str)

Параметры

Имя	Описание
path Обязательно	Путь к сообщению.
property_name Обязательно	Имя свойства, которое требуется задать.
property_value Обязательно	Значение свойства, которое требуется задать.

Атрибуты

connected

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

disconnected

Событие Disconnected, указывающее, что распознаватель отключен от службы.