Connection class

Paket:

microsoft-cognitiveservices-speech-sdk

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 ve çoğunlukla bağlantı durumuna göre uygulama davranışının ince ayarının gerekli olduğu senaryolar için kullanılır. Kullanıcılar, bu Bağlantıyla ilişkilendirilmiş Tanıyıcıda tanımayı başlatmadan önce önceden el ile bağlantı kurmak için isteğe bağlı olarak Open() çağrısı yapabilir. Tanıyıcının hizmete bağlanması veya bağlantısını kesmesi gerekiyorsa, bağlantıyı bağımsız olarak ayarlar veya kapatır. Bu durumda Bağlantı, Bağlı/Bağlantısı Kesilmiş olaylar aracılığıyla bağlantı durumunun değiştirilmesiyle bildirilir. Sürüm 1.2.1'de eklendi.

Özellikler

connected	Tanıyıcının hizmete bağlı olduğunu belirtmek için Bağlandı olayı.
disconnected	Tanıyıcının hizmetle bağlantısının kesildiğini belirtmek için Bağlantısı Kesildi olayı.
messageReceived	Konuşma Tanıma Hizmetinden alınan tüm ileti.
messageSent	Konuşma Tanıma Hizmeti'ne gönderilen tüm ileti.
receivedServiceMessage	Hizmetten gelen ve diğer üst düzey tanıyıcılar tarafından işlenmeyen herhangi bir ileti. 2.0'da kaldırılacak.

Yöntemler

close()	İlişkili kaynakları at.
closeConnection(() => void, (error: string) => void)	Hizmet bağlantısını kapatır. Kullanıcılar, ilişkili Tanıyıcı'nın bağlantısını el ile kapatmak için isteğe bağlı olarak closeConnection() çağrısı yapabilir. Tanıma sırasında closeConnection() çağrılırsa tanıma başarısız olur ve bir hatayla iptal edilir.
fromRecognizer(Recognizer | ConversationTranscriber)	Belirtilen tanıyıcıdan Bağlantı örneğini alır.
fromSynthesizer(SpeechSynthesizer)	Belirtilen birleştiriciden Bağlantı örneğini alır.
openConnection(() => void, (error: string) => void)	Hizmete bağlantıyı ayarlamaya başlar. Kullanıcılar isteğe bağlı olarak openConnection() çağrısı yapabilir ve bu Bağlantıyla ilişkilendirilmiş Tanıyıcı'da tanımayı başlatmadan önce bağlantıyı önceden el ile ayarlayabilir. Tanımayı başlattıktan sonra Open() çağrısının hiçbir etkisi olmaz 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.
sendMessageAsync(string, string | ArrayBuffer, () => void, (error: string) => void)	Konuşma hizmetine bir ileti gönderir. Sürüm 1.13.0'da eklendi.
setMessageProperty(string, string, string | object)	İletideki bir parametreyi hizmete ekler. Sürüm 1.12.1'de eklendi.

Özellik Ayrıntıları

connected

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

connected: (args: ConnectionEventArgs) => void

Özellik Değeri

(args: ConnectionEventArgs) => void

disconnected

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

disconnected: (args: ConnectionEventArgs) => void

Özellik Değeri

(args: ConnectionEventArgs) => void

messageReceived

Konuşma Tanıma Hizmetinden alınan tüm ileti.

messageReceived: (args: ConnectionMessageEventArgs) => void

Özellik Değeri

(args: ConnectionMessageEventArgs) => void

messageSent

Konuşma Tanıma Hizmeti'ne gönderilen tüm ileti.

messageSent: (args: ConnectionMessageEventArgs) => void

Özellik Değeri

(args: ConnectionMessageEventArgs) => void

receivedServiceMessage

Hizmetten gelen ve diğer üst düzey tanıyıcılar tarafından işlenmeyen herhangi bir ileti.

2.0'da kaldırılacak.

receivedServiceMessage: (args: ServiceEventArgs) => void

Özellik Değeri

(args: ServiceEventArgs) => void

Yöntem Ayrıntıları

close()

İlişkili kaynakları at.

function close()

closeConnection(() => void, (error: string) => void)

Hizmet bağlantısını kapatır. Kullanıcılar, ilişkili Tanıyıcı'nın bağlantısını el ile kapatmak için isteğe bağlı olarak closeConnection() çağrısı yapabilir.

Tanıma sırasında closeConnection() çağrılırsa tanıma başarısız olur ve bir hatayla iptal edilir.

function closeConnection(cb?: () => void, err?: (error: string) => void)

Parametreler

cb

() => void

err

(error: string) => void

fromRecognizer(Recognizer | ConversationTranscriber)

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

static function fromRecognizer(recognizer: Recognizer | ConversationTranscriber): Connection

Parametreler

recognizer

Recognizer | ConversationTranscriber

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

Döndürülenler

Connection

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

fromSynthesizer(SpeechSynthesizer)

Belirtilen birleştiriciden Bağlantı örneğini alır.

static function fromSynthesizer(synthesizer: SpeechSynthesizer): Connection

Parametreler

synthesizer

SpeechSynthesizer

Bağlantıyla ilişkili sentezleyici.

Döndürülenler

Connection

Birleştiricinin Bağlantı örneği.

openConnection(() => void, (error: string) => void)

Hizmete bağlantıyı ayarlamaya başlar. Kullanıcılar isteğe bağlı olarak openConnection() çağrısı yapabilir ve bu Bağlantıyla ilişkilendirilmiş Tanıyıcı'da tanımayı başlatmadan önce bağlantıyı önceden el ile ayarlayabilir. Tanımayı başlattıktan sonra Open() çağrısının hiçbir etkisi olmaz

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.

function openConnection(cb?: () => void, err?: (error: string) => void)

Parametreler

cb

() => void

err

(error: string) => void

sendMessageAsync(string, string | ArrayBuffer, () => void, (error: string) => void)

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

function sendMessageAsync(path: string, payload: string | ArrayBuffer, success?: () => void, error?: (error: string) => void)

Parametreler

path

string

İletinin WebSocket yolu

payload

string | ArrayBuffer

İletinin yükü. Bu bir json dizesi veya ArrayBuffer dizesidir.

success

() => void

Başarılı olduğunu belirtmek için bir geri çağırma.

error

(error: string) => void

Bir hatayı belirtmek için geri çağırma.

setMessageProperty(string, string, string | object)

İletideki bir parametreyi hizmete ekler. Sürüm 1.12.1'de eklendi.

function setMessageProperty(path: string, propertyName: string, propertyValue: string | object)

Parametreler

path

string

Ağ iletisinin yolu.

propertyName

string

Özelliğin adı

propertyValue

string | object

Özelliğin değeri. Bu bir json dizesidir.