Dela via

klassanslutning

  • Artikel 
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.