klassanslutning
class Connection
: public std::enable_shared_from_this< Connection >
Anslutningen är en proxyklass för att hantera anslutningen till taltjänsten för den angivna identifieraren. Som standard hanterar en igenkännare anslutningen till tjänsten när det behövs. Klassen Anslutning innehåller ytterligare metoder för användare att uttryckligen öppna eller stänga en anslutning och prenumerera på ändringar av anslutningsstatus. Det är valfritt att använda Anslutning. 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 manuellt initiera en tjänstanslutning innan igenkänning startas på den identifierare som är associerad med den här anslutningen. När du har startat en igenkänning kan det hända att det inte går att anropa Open() eller Close(). 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 samtliga dessa fall indikerar anslutna/frånkopplade händelser ändringen av anslutningsstatusen. Uppdaterad i version 1.17.0.
Medlemmar
Ansluten
Syntax: public EventSignal< constConnectionEventArgs & > Connected;
Händelsen Ansluten som anger att identifieraren är ansluten till tjänsten.
Frånkopplad
Syntax: public EventSignal< constConnectionEventArgs & > Disconnected;
Händelsen Frånkopplad för att indikera att identifieraren är frånkopplad från tjänsten.
MessageReceived
Syntax: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;
Händelsen MessageReceived som anger att det underliggande protokollet tog emot ett meddelande från tjänsten. Har lagts till i version 1.10.0.
Öppna
Syntax: public inline void Open ( bool forContinuousRecognition );
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änning/syntes startas på den recognizer/synthesizer som är associerad med den här anslutningen. När du har startat igenkänningen kan anropet till Open() misslyckas, beroende på processtillståndet för recognizer/synthesizer. Men felet påverkar inte tillståndet för den associerade identifieraren/syntetiseraren. Obs! När anslutningen returneras kanske den inte är klar ännu. Prenumerera på den anslutna händelsen för att meddelas när anslutningen upprättas.
Parametrar
forContinuousRecognition
Anger om anslutningen används för kontinuerlig igenkänning eller enkel igenkänning. Det påverkar inte om anslutningen kommer från SpeechSynthsizer.
Stäng
Syntax: public inline void 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/Synthesizer. Anropet kan misslyckas, beroende på processtillståndet för recognizer/synthesizer. Men felet påverkar inte tillståndet för den associerade identifieraren/syntetiseraren.
SetMessageProperty
Syntax: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );
Lägger till en parameter i ett meddelande i tjänsten. Den här metoden fungerar inte för anslutningen av SpeechSynthesizer. Har lagts till i version 1.7.0.
Parametrar
path
meddelandesökvägen.propertyName
Namnet på egenskapen.propertyValue
Värdet för egenskapen. Det här är en json-sträng.
Returer
Void.
SendMessageAsync
Syntax: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );
Skicka ett meddelande till taltjänsten. Den här metoden fungerar inte för anslutningen av SpeechSynthesizer. Har lagts till i version 1.7.0.
Parametrar
path
Sökvägen till meddelandet.payload
Nyttolasten för meddelandet. Det här är en json-sträng.
Returer
En tom framtid.
SendMessageAsync
Syntax: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );
Skicka ett binärt meddelande till taltjänsten. Den här metoden fungerar inte för anslutningen av SpeechSynthesizer. Har lagts till i version 1.10.0.
Parametrar
path
Sökvägen till meddelandet.payload
Meddelandets binära nyttolast.size
Storleken på den binära nyttolasten.
Returer
En tom framtid.
Anslutning
Syntax: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );
Intern konstruktor. Skapar en ny instans med hjälp av den angivna referensen.
Parametrar
handle
Anslutningshandtaget.
~Anslutning
Syntax: public inline ~Connection ( );
Destructor.
FromRecognizer
Syntax: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );
Hämtar anslutningsinstansen från den angivna identifieraren.
Parametrar
recognizer
Den identifierare som är associerad med anslutningen.
Returer
Anslutningsinstansen för identifieraren.
FromConversationTranslator
Syntax: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );
Hämtar anslutningsinstansen från den angivna konversationsöversättaren.
Parametrar
convTrans
Konversationsöversättaren som är associerad med anslutningen.
Returer
Anslutningsinstansen för konversationsöversättaren.
FromDialogServiceConnector
Syntax: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );
Hämtar anslutningsinstansen från den angivna dialogtjänstanslutningen, som används för att observera och hantera anslutning och frånkoppling från taltjänsten.
Parametrar
dialogServiceConnector
Den dialogtjänstanslutning som är associerad med anslutningen.
Returer
Anslutningsinstansen för dialogtjänstens anslutningsapp.
FromSpeechSynthesizer
Syntax: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );
Hämtar anslutningsinstansen från den angivna talsyntesen. Har lagts till i version 1.17.0.
Parametrar
synthesizer
Talsyntesen som är associerad med anslutningen.
Returer
Anslutningsinstansen för talsyntesen.