Connection Klass

Proxyklass för att hantera anslutningen till taltjänsten för den angivna Recognizer.

Som standard hanterar en Recognizer autonom anslutning till tjänsten vid behov. Klassen Connection innehåller ytterligare metoder för användare att uttryckligen öppna eller stänga en anslutning och prenumerera på ändringar i anslutningsstatusen. Det är valfritt att använda Connection . Den är avsedd för scenarier där finjustering av programbeteende baserat på anslutningsstatus krävs. Användare kan också anropa open för att initiera en tjänstanslutning manuellt innan igenkänningen påbörjas för den Recognizer som är associerad med den här Connection. När du har startat en igenkänning kan anrop open eller close misslyckas. Detta påverkar inte identifieraren eller den pågående igenkänningen. Anslutningen kan ta bort av olika anledningar. Recognizer försöker alltid att återupprätta anslutningen efter behov för att garantera pågående åtgärder. I alla dessa fall connected/disconnected indikerar händelser ändringen av anslutningsstatusen.

Anteckning

Uppdaterad i version 1.17.0.

Konstruktor för internt bruk.

Arv
builtins.object
Connection

Konstruktor

Connection(handle: c_void_p)

Parametrar

Name Description
handle
Obligatorisk

Metoder

close

Stänger anslutningen till tjänsten. Användare kan också anropa close för att manuellt stänga av anslutningen för den associerade Recognizer. Anropet kan misslyckas, beroende på processtillståndet för Recognizer. Men felet påverkar inte tillståndet för den associerade Recognizer.

from_dialog_service_connector

Hämtar instansen Connection från den angivna anslutningsappen för dialogtjänsten.

from_recognizer

Hämtar instansen Connection från den angivna identifieraren.

from_speech_synthesizer

Hämtar instansen Connection från den angivna talsyntesen.

Anteckning

Har lagts till i version 1.17.0.

open

Börjar konfigurera anslutningen till tjänsten. Användare kan också anropa open för att manuellt konfigurera en anslutning i förväg innan igenkänningen påbörjas för den Recognizer som är associerad med den här Connection. När du har startat igenkänningen kan anropet openmisslyckas, beroende på processtillståndet för Recognizer. Men felet påverkar inte tillståndet för den associerade Recognizer.

Anteckning

När anslutningen returneras kanske den inte är klar än. Prenumerera på

ansluten händelse som ska meddelas när anslutningen upprättas.

set_message_property

Lägger till en parameter i ett meddelande i tjänsten.

Anteckning

Den här metoden fungerar inte för anslutningen av SpeechSynthesizer.

close

Stänger anslutningen till tjänsten. Användare kan också anropa close för att manuellt stänga av anslutningen för den associerade Recognizer. Anropet kan misslyckas, beroende på processtillståndet för Recognizer. Men felet påverkar inte tillståndet för den associerade Recognizer.

close()

from_dialog_service_connector

Hämtar instansen Connection från den angivna anslutningsappen för dialogtjänsten.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parametrar

Name Description
dialog_service_connector
Obligatorisk

from_recognizer

Hämtar instansen Connection från den angivna identifieraren.

from_recognizer(recognizer: Recognizer) -> Connection

Parametrar

Name Description
recognizer
Obligatorisk

from_speech_synthesizer

Hämtar instansen Connection från den angivna talsyntesen.

Anteckning

Har lagts till i version 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parametrar

Name Description
speech_synthesizer
Obligatorisk

open

Börjar konfigurera anslutningen till tjänsten. Användare kan också anropa open för att manuellt konfigurera en anslutning i förväg innan igenkänningen påbörjas för den Recognizer som är associerad med den här Connection. När du har startat igenkänningen kan anropet openmisslyckas, beroende på processtillståndet för Recognizer. Men felet påverkar inte tillståndet för den associerade Recognizer.

Anteckning

När anslutningen returneras kanske den inte är klar än. Prenumerera på

ansluten händelse som ska meddelas när anslutningen upprättas.

open(for_continuous_recognition: bool)

Parametrar

Name Description
forContinuousRecognition
Obligatorisk

anger om anslutningen används för kontinuerlig igenkänning eller enkel igenkänning. Det påverkar inte om anslutningen kommer från SpeechSynthsizer.

for_continuous_recognition
Obligatorisk

set_message_property

Lägger till en parameter i ett meddelande i tjänsten.

Anteckning

Den här metoden fungerar inte för anslutningen av SpeechSynthesizer.

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

Parametrar

Name Description
path
Obligatorisk

Meddelandesökvägen.

property_name
Obligatorisk

Det egenskapsnamn som du vill ange.

property_value
Obligatorisk

Värdet för den egenskap som du vill ange.

Attribut

connected

Händelsen Ansluten som anger att identifieraren är ansluten till tjänsten.

disconnected

Händelsen Frånkopplad för att indikera att identifieraren är frånkopplad från tjänsten.