Connection Classe

Classe de proxy para gerir a ligação ao serviço de voz do especificado Recognizer.

Por predefinição, uma Recognizer ligação ao serviço é gerida de forma autónoma quando necessário. A Connection classe fornece métodos adicionais para os utilizadores abrirem ou fecharem explicitamente uma ligação e subscreverem as alterações ao estado da ligação. A utilização de Connection é opcional. Destina-se a cenários em que é necessária uma otimização do comportamento da aplicação com base no estado da ligação. Opcionalmente, os utilizadores podem chamar open para iniciar manualmente uma ligação de serviço antes de iniciar o reconhecimento no associado a Recognizer este Connection. Depois de iniciar um reconhecimento, chamar open ou close pode falhar. Isto não afetará o Reconhecedor ou o reconhecimento contínuo. A ligação pode ser perdida por vários motivos. O Reconhecedor tentará sempre reinstituir a ligação conforme necessário para garantir operações em curso. Em todos estes casos connected/disconnected , os eventos indicarão a alteração do estado da ligação.

Nota

Atualizado na versão 1.17.0.

Construtor para utilização interna.

Herança

builtins.object

Connection

Construtor

Connection(handle: c_void_p)

Parâmetros

Name	Description
handle Necessário

Métodos

close	Fecha a ligação ao serviço. Opcionalmente, os utilizadores podem ligar close para encerrar manualmente a ligação do .Recognizer A chamada pode falhar, dependendo do estado do processo do Recognizer. Mas a falha não afeta o estado do associado Recognizer.
from_dialog_service_connector	Obtém a Connection instância do conector do serviço de caixa de diálogo especificado.
from_recognizer	Obtém a Connection instância do reconhecedor especificado.
from_speech_synthesizer	Obtém a Connection instância do sintetizador de voz especificado. Nota Adicionado na versão 1.17.0.
open	Começa a configurar a ligação ao serviço. Opcionalmente, os utilizadores podem ligar open para configurar manualmente uma ligação com antecedência antes de iniciarem o reconhecimento no associado a Recognizer este Connection. Após iniciar o reconhecimento, a chamada open) pode falhar, dependendo do estado do processo do Recognizer. Mas a falha não afeta o estado do associado Recognizer. Nota Na devolução, a ligação poderá ainda não estar pronta. Subscreva o evento ligado para ser notificado quando a ligação for estabelecida.
set_message_property	Acrescenta um parâmetro numa mensagem ao serviço. Nota Este método não funciona para a ligação de SpeechSynthesizer.

close

Fecha a ligação ao serviço. Opcionalmente, os utilizadores podem ligar close para encerrar manualmente a ligação do .Recognizer A chamada pode falhar, dependendo do estado do processo do Recognizer. Mas a falha não afeta o estado do associado Recognizer.

close()

from_dialog_service_connector

Obtém a Connection instância do conector do serviço de caixa de diálogo especificado.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parâmetros

Name	Description
dialog_service_connector Necessário

from_recognizer

Obtém a Connection instância do reconhecedor especificado.

from_recognizer(recognizer: Recognizer) -> Connection

Parâmetros

Name	Description
recognizer Necessário

from_speech_synthesizer

Obtém a Connection instância do sintetizador de voz especificado.

Nota

Adicionado na versão 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parâmetros

Name	Description
speech_synthesizer Necessário

open

Começa a configurar a ligação ao serviço. Opcionalmente, os utilizadores podem ligar open para configurar manualmente uma ligação com antecedência antes de iniciarem o reconhecimento no associado a Recognizer este Connection. Após iniciar o reconhecimento, a chamada open) pode falhar, dependendo do estado do processo do Recognizer. Mas a falha não afeta o estado do associado Recognizer.

Nota

Na devolução, a ligação poderá ainda não estar pronta. Subscreva o

evento ligado para ser notificado quando a ligação for estabelecida.

open(for_continuous_recognition: bool)

Parâmetros

Name	Description
forContinuousRecognition Necessário	indica se a ligação é utilizada para reconhecimento contínuo ou reconhecimento de captura única. Não tem efeito se a ligação for de SpeechSynthsizer.
for_continuous_recognition Necessário

set_message_property

Acrescenta um parâmetro numa mensagem ao serviço.

Nota

Este método não funciona para a ligação de SpeechSynthesizer.

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

Parâmetros

Name	Description
path Necessário	O caminho da mensagem.
property_name Necessário	O nome da propriedade que pretende definir.
property_value Necessário	O valor da propriedade que pretende definir.

Atributos

connected

O evento Ligado para indicar que o reconhecedor está ligado ao serviço.

disconnected

O evento Desligado para indicar que o reconhecedor está desligado do serviço.