Connection Klas

Proxyklasse voor het beheren van de verbinding met de spraakservice van de opgegeven Recognizer.

Standaard wordt Recognizer de verbinding met de service autonoom beheerd wanneer dat nodig is. De Connection klasse biedt extra methoden voor gebruikers om expliciet een verbinding te openen of te sluiten en zich te abonneren op wijzigingen in de verbindingsstatus. Het gebruik van Connection is optioneel. Het is bedoeld voor scenario's waarin het gedrag van toepassingen op basis van de verbindingsstatus moet worden afgestemd. Gebruikers kunnen desgewenst aanroepen open om handmatig een serviceverbinding te initiëren voordat ze de Recognizer herkenning starten die is gekoppeld aan deze Connection. Na het starten van een herkenning kan het bellen open of close mislukken. Dit heeft geen invloed op de Recognizer of de doorlopende herkenning. De verbinding kan om verschillende redenen worden wegvallen. De Recognizer zal altijd proberen om de verbinding opnieuw in te stellen als dat nodig is om doorlopende bewerkingen te garanderen. In al deze gevallen connected/disconnected geven gebeurtenissen de wijziging van de verbindingsstatus aan.

Notitie

Bijgewerkt in versie 1.17.0.

Constructor voor intern gebruik.

Overname

builtins.object

Connection

Constructor

Connection(handle: c_void_p)

Parameters

Name	Description
handle Vereist

Methoden

close	Hiermee wordt de verbinding met de service gesloten. Gebruikers kunnen desgewenst aanroepen close om de verbinding van de gekoppelde Recognizerhandmatig te verbreken. De aanroep kan mislukken, afhankelijk van de processtatus van de Recognizer. De fout heeft echter geen invloed op de status van de gekoppelde Recognizer.
from_dialog_service_connector	Hiermee haalt u het Connection exemplaar op van de opgegeven verbindingslijn voor de dialoogvensterservice.
from_recognizer	Haalt het Connection exemplaar op van de opgegeven recognizer.
from_speech_synthesizer	Haalt het Connection exemplaar op van de opgegeven spraaksynthese. Notitie Toegevoegd in versie 1.17.0.
open	Hiermee wordt de verbinding met de service ingesteld. Gebruikers kunnen desgewenst bellen open om handmatig een verbinding in te stellen voordat ze de herkenning Recognizer starten die is gekoppeld aan deze Connection. Na het starten van de herkenning kan het aanroepen openvan ) mislukken, afhankelijk van de processtatus van de Recognizer. De fout heeft echter geen invloed op de status van de gekoppelde Recognizer. Notitie Bij terugkomst is de verbinding mogelijk nog niet gereed. Abonneer u op de verbonden gebeurtenis die op de hoogte moet worden gesteld wanneer de verbinding tot stand wordt gebracht.
set_message_property	Hiermee voegt u een parameter toe aan een bericht aan de service. Notitie Deze methode werkt niet voor de verbinding van SpeechSynthesizer.

close

Hiermee wordt de verbinding met de service gesloten. Gebruikers kunnen desgewenst aanroepen close om de verbinding van de gekoppelde Recognizerhandmatig te verbreken. De aanroep kan mislukken, afhankelijk van de processtatus van de Recognizer. De fout heeft echter geen invloed op de status van de gekoppelde Recognizer.

close()

from_dialog_service_connector

Hiermee haalt u het Connection exemplaar op van de opgegeven verbindingslijn voor de dialoogvensterservice.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parameters

Name	Description
dialog_service_connector Vereist

from_recognizer

Haalt het Connection exemplaar op van de opgegeven recognizer.

from_recognizer(recognizer: Recognizer) -> Connection

Parameters

Name	Description
recognizer Vereist

from_speech_synthesizer

Haalt het Connection exemplaar op van de opgegeven spraaksynthese.

Notitie

Toegevoegd in versie 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parameters

Name	Description
speech_synthesizer Vereist

open

Hiermee wordt de verbinding met de service ingesteld. Gebruikers kunnen desgewenst bellen open om handmatig een verbinding in te stellen voordat ze de herkenning Recognizer starten die is gekoppeld aan deze Connection. Na het starten van de herkenning kan het aanroepen openvan ) mislukken, afhankelijk van de processtatus van de Recognizer. De fout heeft echter geen invloed op de status van de gekoppelde Recognizer.

Notitie

Bij terugkomst is de verbinding mogelijk nog niet gereed. Abonneer u op de

verbonden gebeurtenis die op de hoogte moet worden gesteld wanneer de verbinding tot stand wordt gebracht.

open(for_continuous_recognition: bool)

Parameters

Name	Description
forContinuousRecognition Vereist	geeft aan of de verbinding wordt gebruikt voor continue herkenning of eenmalige herkenning. Het heeft geen effect als de verbinding afkomstig is van SpeechSynthsizer.
for_continuous_recognition Vereist

set_message_property

Hiermee voegt u een parameter toe aan een bericht aan de service.

Notitie

Deze methode werkt niet voor de verbinding van SpeechSynthesizer.

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

Parameters

Name	Description
path Vereist	Het berichtpad.
property_name Vereist	De naam van de eigenschap die u wilt instellen.
property_value Vereist	De waarde van de eigenschap die u wilt instellen.

Kenmerken

connected

De gebeurtenis Verbonden om aan te geven dat de recognizer is verbonden met de service.

disconnected

De gebeurtenis Verbinding verbroken om aan te geven dat de verbinding van de herkenning met de service is verbroken.