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 identifierare autonomt anslutning till tjänsten vid behov. 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 programmets beteende baserat på anslutningsstatus behövs. Användare kan också anropa Open() för att initiera en tjänstanslutning manuellt innan de påbörjar igenkänningen 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 skäl. Identifieraren försöker alltid att återupprätta anslutningen efter behov för att garantera pågående åtgärder. I alla dessa fall anger anslutna/frånkopplade händelser ändringen av anslutningsstatusen. Uppdaterad i version 1.17.0.

Medlemmar

Ansluten

Syntax: public EventSignal< const ConnectionEventArgs & > Connected;

Händelsen Ansluten för att indikera att identifieraren är ansluten till tjänsten.

Bortkopplad

Syntax: public EventSignal< const ConnectionEventArgs & > Disconnected;

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

MessageReceived

Syntax: public EventSignal< const ConnectionMessageEventArgs & > 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 de startar igenkänning/syntes på den identifierare/synt som är associerad med den här anslutningen. När du har startat igenkänningen kan det hända att det inte går att anropa Open() beroende på processtillståndet för Recognizer/Synthesizer. Men felet påverkar inte tillståndet för den associerade identifieraren/synteten. Obs! När anslutningen returneras kanske den inte är klar än. Prenumerera på den anslutna händelsen för att meddelas när anslutningen upprättas.

Parameterar

  • forContinuousRecognition Anger om anslutningen används för kontinuerlig igenkänning eller enkel igenkänning. Det får ingen effekt om anslutningen kommer från SpeechSynthsizer.

Stänga

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 identifieraren/synten. Anropet kan misslyckas, beroende på processtillståndet för recognizer/synthesizer. Men felet påverkar inte tillståndet för den associerade identifieraren/synteten.

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 till tjänsten. Har lagts till i version 1.7.0.

Parameterar

  • path meddelandesökvägen.

  • propertyName Egenskapens namn.

  • propertyValue Egenskapens värde. Det här är en json-sträng.

Återlämning

tomrum.

SendMessageAsync

Syntax: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Skicka ett meddelande till taltjänsten. Har lagts till i version 1.7.0.

Parameterar

  • path Meddelandets sökväg.

  • payload Nyttolasten för meddelandet. Det här är en json-sträng.

Återlämning

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.

Parameterar

  • path Meddelandets sökväg.

  • payload Meddelandets binära nyttolast.

  • size Storleken på den binära nyttolasten.

Återlämning

En tom framtid.

Anslutning

Syntax: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Intern konstruktor. Skapar en ny instans med hjälp av det angivna handtaget.

Parameterar

  • handle Anslutningshandtaget.

~Samband

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.

Parameterar

  • recognizer Den identifierare som är associerad med anslutningen.

Återlämning

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.

Parameterar

  • convTrans Konversationsöversättaren som är associerad med anslutningen.

Återlämning

Anslutningsinstansen av 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 anslutningsappen för dialogtjänsten som används för att observera och hantera anslutning och frånkoppling från taltjänsten.

Parameterar

  • dialogServiceConnector Den dialogtjänstanslutning som är associerad med anslutningen.

Återlämning

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.

Parameterar

  • synthesizer Talsyntesen som är associerad med anslutningen.

Återlämning

Talsyntesens anslutningsinstans.