Share via

sınıf Bağlantısı

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

Bağlantı, belirtilen Tanıyıcının konuşma hizmetine bağlantıyı yönetmek için bir ara sunucu sınıfıdır. Varsayılan olarak, Bir Tanıyıcı gerektiğinde hizmete bağlantıyı otonom olarak yönetir. Connection sınıfı, kullanıcıların bir bağlantıyı açıkça açması veya kapatması ve bağlantı durumu değişikliklerine abone olması için ek yöntemler sağlar. Bağlantı kullanımı isteğe bağlıdır. Bağlantı durumuna göre uygulama davranışının ince ayarının gerekli olduğu senaryolara yöneliktir. Kullanıcılar isteğe bağlı olarak Open() çağrısı yapabilir ve bu Bağlantıyla ilişkilendirilmiş Tanıyıcıda tanımayı başlatmadan önce el ile bir hizmet bağlantısı başlatabilir. Tanımayı başlattıktan sonra Open() veya Close() çağrıları başarısız olabilir. Bu, Tanıyıcıyı veya devam eden tanımayı etkilemez. Bağlantı çeşitli nedenlerle düşebilir, Tanıyıcı sürekli işlemleri garanti etmek için gerektiğinde bağlantıyı her zaman yeniden başlatmayı dener. Tüm bu durumlarda Bağlı/Bağlantısı kesilen olaylar bağlantı durumunun değiştiğini gösterir. Sürüm 1.17.0 güncelleştirildi.

Üyeler

Bağlı

Söz dizimi: public EventSignal< constConnectionEventArgs & > Connected;

Tanıyıcının hizmete bağlı olduğunu belirtmek için Bağlandı olayı.

Bağlantı kesildi

Söz dizimi: public EventSignal< constConnectionEventArgs & > Disconnected;

Tanıyıcının hizmetle bağlantısının kesildiğini belirtmek için Bağlantısı Kesildi olayı.

MessageReceived

Söz dizimi: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

Temel alınan protokolün hizmetten bir ileti aldığını belirten MessageReceived olayı. Sürüm 1.10.0'da eklendi.

Open

Söz dizimi: public inline void Open ( bool forContinuousRecognition );

Hizmete bağlantıyı ayarlamaya başlar. Kullanıcılar, bu Bağlantıyla ilişkilendirilmiş Tanıyıcı/Sentezleyici üzerinde tanıma/senteze başlamadan önce önceden bir bağlantı kurmak için isteğe bağlı olarak Open() çağrısı yapabilir. Tanımayı başlattıktan sonra, Tanıyıcı/Sentezleyici'nin işlem durumuna bağlı olarak Open() çağrısı başarısız olabilir. Ancak hata, ilişkili Tanıyıcı/Sentezleyicinin durumunu etkilemez. Not: Dönüşte bağlantı henüz hazır olmayabilir. Bağlantı kurulduğunda bildirim almak için lütfen Bağlı olayına abone olun.

Parametreler

  • forContinuousRecognition Bağlantının sürekli tanıma veya tek çekim tanıma için kullanılıp kullanılmadığını gösterir. Bağlantı SpeechSynthsizer'dan olduğunda hiçbir etkisi olmaz.

Kapat

Söz dizimi: public inline void Close ( );

Hizmet bağlantısını kapatır. Kullanıcılar, ilişkili Tanıyıcı/Sentezleyici bağlantısını el ile kapatmak için isteğe bağlı olarak Close() öğesini çağırabilir. Çağrı, Tanıyıcı/Sentezleyici'nin işlem durumuna bağlı olarak başarısız olabilir. Ancak hata, ilişkili Tanıyıcı/Sentezleyicinin durumunu etkilemez.

SetMessageProperty

Söz dizimi: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

İletideki bir parametreyi hizmete ekler. Bu yöntem SpeechSynthesizer bağlantısı için çalışmaz. Sürüm 1.7.0'da eklendi.

Parametreler

  • path ileti yolunu seçin.

  • propertyName Özelliğin adı.

  • propertyValue özelliğinin değeri. Bu bir json dizesidir.

Döndürülenler

Void.

SendMessageAsync

Söz dizimi: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Konuşma hizmetine bir ileti gönderin. Bu yöntem SpeechSynthesizer bağlantısı için çalışmaz. Sürüm 1.7.0'da eklendi.

Parametreler

  • path İletinin yolu.

  • payload İletinin yükü. Bu bir json dizesidir.

Döndürülenler

Boş bir gelecek.

SendMessageAsync

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

Konuşma hizmetine ikili bir ileti gönderin. Bu yöntem SpeechSynthesizer bağlantısı için çalışmaz. Sürüm 1.10.0'da eklendi.

Parametreler

  • path İletinin yolu.

  • payload İletinin ikili yükü.

  • size İkili yükün boyutu.

Döndürülenler

Boş bir gelecek.

Bağlantı

Söz dizimi: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

İç oluşturucu. Sağlanan tanıtıcıyı kullanarak yeni bir örnek oluşturur.

Parametreler

  • handle Bağlantı tutamacı.

~Bağlantı

Söz dizimi: public inline ~Connection ( );

Yıkıcı.

FromRecognizer

Söz dizimi: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Belirtilen tanıyıcıdan Bağlantı örneğini alır.

Parametreler

  • recognizer Bağlantıyla ilişkili tanıyıcı.

Döndürülenler

Tanıyıcının Bağlantı örneği.

FromConversationTranslator

Söz dizimi: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Belirtilen konuşma çeviricisinden Bağlantı örneğini alır.

Parametreler

  • convTrans Bağlantıyla ilişkilendirilmiş konuşma çeviricisi.

Döndürülenler

Konuşma çeviricisinin Bağlantı örneği.

FromDialogServiceConnector

Söz dizimi: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Bağlantı örneğini belirtilen iletişim kutusu hizmeti bağlayıcısından alır. Konuşma hizmetiyle bağlantı ve bağlantı kesilmesini gözlemlemek ve yönetmek için kullanılır.

Parametreler

  • dialogServiceConnector Bağlantıyla ilişkilendirilmiş iletişim kutusu hizmeti bağlayıcısı.

Döndürülenler

İletişim kutusu hizmeti bağlayıcısının Bağlantı örneği.

FromSpeechSynthesizer

Söz dizimi: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Belirtilen konuşma sentezleyicisinden Connection örneğini alır. Sürüm 1.17.0'da eklendi.

Parametreler

  • synthesizer Bağlantıyla ilişkili konuşma sentezleyici.

Döndürülenler

Konuşma sentezleyicisinin Bağlantı örneği.