sınıf Bağlantısı

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ı'nın kullanımı isteğe bağlıdır. Bağlantı durumuna göre uygulama davranışının ince ayarlanması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ı üzerinde 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ısı 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 her zaman bağlantıyı yeniden başlatmayı dener. Tüm bu durumlarda Bağlı/Bağlantısı kesilmiş olaylar bağlantı durumunun değiştiğini gösterir. Sürüm 1.17.0 güncelleştirildi.

Üyeler

Bağlandı

Sözdizimi: public EventSignal< const ConnectionEventArgs & > Connected;

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

Bağlantısı kesilmiş

Sözdizimi: public EventSignal< const ConnectionEventArgs & > Disconnected;

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

MessageReceived

Sözdizimi: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

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

Açık

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

Hizmete bağlantıyı ayarlamaya başlar. Kullanıcılar isteğe bağlı olarak, bu Bağlantıyla ilişkilendirilmiş Tanıyıcı/Sentezleyici üzerinde tanıma/sentezi başlatmadan önce el ile bağlantı kurmak için Open() öğesini çağırabilir. 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 seferlik tanıma için kullanılıp kullanılmadığını gösterir. Bağlantı SpeechSynthsizer'dan geliyorsa hiçbir etkisi olmaz.

Kapat

Sözdizimi: 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() ç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özdizimi: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

İletideki bir parametreyi hizmete ekler. Sürüm 1.7.0'da eklendi.

Parametreler

• İleti yolunu path.

• özelliğin adını propertyName.

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

İade

boşluk.

SendMessageAsync

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

Konuşma hizmetine bir ileti gönderin. Sürüm 1.7.0'da eklendi.

Parametreler

• path İletinin yolu.

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

İade

Boş bir gelecek.

SendMessageAsync

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

Konuşma hizmetine ikili 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.

İade

Boş bir gelecek.

Bağlantı

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

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

Parametreler

• Bağlantı tutamacını handle.

~Bağlantı

Sözdizimi: public inline ~Connection ( );

Yıkıcı.

FromRecognizer

Sözdizimi: 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ı.

İade

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

FromConversationTranslator

Sözdizimi: 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.

İade

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

FromDialogServiceConnector

Sözdizimi: 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 ve 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ı.

İade

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

FromSpeechSynthesizer

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

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

Parametreler

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

İade

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