klasseVerbinding

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 autonoom verbinding met de service wanneer dat nodig is. De verbindingsklasse biedt aanvullende methoden voor gebruikers om expliciet een verbinding te openen of te sluiten en om u te abonneren op wijzigingen in de verbindingsstatus. Het gebruik van verbinding is optioneel. Het is bedoeld voor scenario's waarbij het gedrag van toepassingen op basis van de verbindingsstatus is vereist. Gebruikers kunnen optioneel Open() aanroepen om handmatig een serviceverbinding te starten voordat ze herkenning starten op de Recognizer die aan deze verbinding is gekoppeld. Nadat u een herkenning hebt gestart, 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 afnemen. De Recognizer zal altijd proberen om de verbinding opnieuw in te stellen, indien vereist 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< const ConnectionEventArgs & > Connected;

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

Niet verbonden

Syntaxis: public EventSignal< const ConnectionEventArgs & > Disconnected;

De gebeurtenis Verbinding verbroken om aan te geven dat de recognizer is losgekoppeld van de service.

MessageReceived

Syntaxis: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

De MessageReceived-gebeurtenis 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 vooraf handmatig een verbinding in te stellen voordat ze herkenning/synthese starten op de Recognizer/Synthesizer die aan deze verbinding is gekoppeld. Na het starten van 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 retour is de verbinding mogelijk nog niet gereed. Abonneer u op de verbonden gebeurtenis om op de hoogte te worden gesteld wanneer de verbinding tot stand is gebracht.

Parameterwaarden

• forContinuousRecognition Geeft aan of de verbinding wordt gebruikt voor continue herkenning of eenmalige herkenning. Dit heeft geen effect als de verbinding afkomstig is van SpeechSynthsizer.

Sluiten

Syntaxis: public inline void Close ( );

Hiermee sluit u de verbinding met de service. Gebruikers kunnen optioneel Close() aanroepen om de verbinding van de bijbehorende Recognizer/Synthesizer handmatig af te sluiten. 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 );

Voegt een parameter toe aan een bericht aan de service. Toegevoegd in versie 1.7.0.

Parameterwaarden

• path het berichtpad.

• propertyName naam van de eigenschap.

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

Retouren

leegte.

SendMessageAsync

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

Een bericht verzenden naar de spraakservice. Toegevoegd in versie 1.7.0.

Parameterwaarden

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

Parameterwaarden

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

Parameterwaarden

• handle de verbindingsgreep.

~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 verbindingsexemplaren op van de opgegeven recognizer.

Parameterwaarden

• recognizer De recognizer die aan de verbinding is gekoppeld.

Retouren

Het verbindingsexemplaren van de recognizer.

FromConversationTranslator

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

Hiermee haalt u het verbindingsexemplaren op van de opgegeven gespreksvertaler.

Parameterwaarden

• convTrans De gespreksvertaler die is gekoppeld aan de verbinding.

Retouren

Het verbindingsexemplaren 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 connector voor de dialoogvensterservice, die wordt gebruikt voor het observeren en beheren van de verbinding en het verbreken van de verbinding met de spraakservice.

Parameterwaarden

• dialogServiceConnector De verbindingslijn voor de dialoogvensterservice 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 spraaksynthese. Toegevoegd in versie 1.17.0.

Parameterwaarden

• synthesizer De spraaksynthese die aan de verbinding is gekoppeld.

Retouren

Het Verbindingsexemplaren van de spraaksynthese.