Delen via

klasse Verbinding

  • Artikel
class Connection
  : public std::enable_shared_from_this< Connection >

Verbinding is een proxyklasse voor het beheren van de verbinding met de spraakservice van de opgegeven Recognizer. Standaard beheert een Recognizer de verbinding met de service autonoom wanneer dat nodig is. De klasse Verbinding biedt gebruikers aanvullende methoden om expliciet een verbinding te openen of te sluiten en zich te abonneren op wijzigingen in de verbindingsstatus. Het gebruik van Verbinding is optioneel. Het is bedoeld voor scenario's waarin het gedrag van toepassingen op basis van de verbindingsstatus moet worden afgestemd. Gebruikers kunnen optioneel Open() aanroepen om handmatig een serviceverbinding te initiëren voordat ze de herkenning starten op de Recognizer die aan deze verbinding is gekoppeld. Na het starten van een herkenning kan het aanroepen van 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 geven verbonden/verbroken gebeurtenissen de wijziging van de verbindingsstatus aan. Bijgewerkt in versie 1.17.0.

Leden

Verbonden

Syntaxis: public EventSignal< constConnectionEventArgs & > Connected;

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

Ontkoppeld

Syntaxis: public EventSignal< constConnectionEventArgs & > Disconnected;

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

MessageReceived

Syntaxis: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

De gebeurtenis MessageReceived om aan te geven dat het onderliggende protocol een bericht van de service heeft ontvangen. Toegevoegd in versie 1.10.0.

Openen

Syntaxis: public inline void Open ( bool forContinuousRecognition );

Hiermee wordt de verbinding met de service ingesteld. Gebruikers kunnen optioneel Open() aanroepen om handmatig een verbinding in te stellen voordat ze de herkenning/synthese starten op de Recognizer/Synthesizer die aan deze verbinding is gekoppeld. Na het starten van de herkenning kan het aanroepen van Open() mislukken, afhankelijk van de processtatus van de Recognizer/Synthesizer. Maar de fout heeft geen invloed op de status van de bijbehorende Recognizer/Synthesizer. Opmerking: Bij terugkomst is de verbinding mogelijk nog niet gereed. Abonneer u op de gebeurtenis Verbonden om een melding te ontvangen wanneer de verbinding tot stand is gebracht.

Parameters

  • forContinuousRecognition Hiermee wordt aangegeven of de verbinding wordt gebruikt voor continue herkenning of eenmalige herkenning. Het heeft geen effect als de verbinding afkomstig is van SpeechSynthsizer.

Sluiten

Syntaxis: public inline void Close ( );

Hiermee wordt de verbinding met de service gesloten. Gebruikers kunnen desgewenst Close() aanroepen om de verbinding van de bijbehorende Recognizer/Synthesizer handmatig te verbreken. De aanroep kan mislukken, afhankelijk van de processtatus van de Recognizer/Synthesizer. Maar de fout heeft geen invloed op de status van de bijbehorende Recognizer/Synthesizer.

SetMessageProperty

Syntaxis: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Hiermee voegt u een parameter toe aan een bericht aan de service. Deze methode werkt niet voor de verbinding van SpeechSynthesizer. Toegevoegd in versie 1.7.0.

Parameters

  • path het berichtpad.

  • propertyName Naam van de eigenschap.

  • propertyValue Waarde van de eigenschap. Dit is een json-tekenreeks.

Retouren

Void.

SendMessageasync

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

Een bericht verzenden naar de spraakservice. Deze methode werkt niet voor de verbinding van SpeechSynthesizer. Toegevoegd in versie 1.7.0.

Parameters

  • path Het pad van het bericht.

  • payload De nettolading van het bericht. Dit is een json-tekenreeks.

Retouren

Een lege toekomst.

SendMessageasync

Syntaxis: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Een binair bericht verzenden naar de spraakservice. Deze methode werkt niet voor de verbinding van SpeechSynthesizer. Toegevoegd in versie 1.10.0.

Parameters

  • path Het pad van het bericht.

  • payload De binaire nettolading van het bericht.

  • size De grootte van de binaire nettolading.

Retouren

Een lege toekomst.

Verbinding

Syntaxis: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Interne constructor. Hiermee maakt u een nieuw exemplaar met behulp van de opgegeven ingang.

Parameters

  • handle De verbindingsingang.

~Verbinding

Syntaxis: public inline ~Connection ( );

Destructor.

FromRecognizer

Syntaxis: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Hiermee haalt u het verbindingsexemplaar op van de opgegeven recognizer.

Parameters

  • recognizer De recognizer die is gekoppeld aan de verbinding.

Retouren

Het verbindingsexemplaar van de recognizer.

FromConversationTranslator

Syntaxis: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Hiermee haalt u het verbindingsexemplaar op van de opgegeven gespreksvertaler.

Parameters

  • convTrans De gespreksvertaler die is gekoppeld aan de verbinding.

Retouren

Het verbindingsexemplaar van de gespreksvertaler.

FromDialogServiceConnector

Syntaxis: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Hiermee haalt u het verbindingsexemplaren op van de opgegeven dialoogvensterserviceconnector, die wordt gebruikt voor het observeren en beheren van de verbinding en het verbreken van de verbinding met de spraakservice.

Parameters

  • dialogServiceConnector De dialoogvensterserviceconnector die is gekoppeld aan de verbinding.

Retouren

Het verbindingsexemplaren van de dialoogvensterserviceconnector.

FromSpeechSynthesizer

Syntaxis: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Hiermee haalt u het verbindingsexemplaren op van de opgegeven spraaksynthesizer. Toegevoegd in versie 1.17.0.

Parameters

  • synthesizer De spraaksynthesizer die aan de verbinding is gekoppeld.

Retouren

Het verbindingsexemplaren van de spraaksynthesizer.