DialogServiceConnector class

موصل خدمة مربع الحوار

Extends

المنشئون

DialogServiceConnector(DialogServiceConfig, AudioConfig)

تهيئة مثيل DialogServiceConnector.

الخصائص

activityReceived

يشير نشاط الحدث إلى أنه تم تلقي نشاط.

authorizationToken

يحصل على رمز التخويل المميز المستخدم للاتصال بالخدمة.

canceled

قام الحدث بإلغاء الإشارات إلى حدوث خطأ أثناء التعرف.

internalData
properties

مجموعة الخصائص وقيمها المحددة ل DialogServiceConnector هذا.

recognized

يشير الحدث الذي تم التعرف عليه إلى تلقي نتيجة التعرف النهائية.

recognizing

يشير الحدث الذي يتعرف على الإشارات إلى تلقي نتيجة التعرف المتوسطة.

speechActivityTemplate

يحصل على قالب النشاط الذي تم إنشاؤه بواسطة الخدمة من الكلام. سيتم ختم الخصائص من القالب على النشاط الذي تم إنشاؤه. يمكن أن يكون فارغا

telemetryEnabled

يقوم هذا الأسلوب بإرجاع الحالة الحالية لإعداد بيانات تتبع الاستخدام.

turnStatusReceived

يشير الحدث turnStatusReceived إلى تلقي رسالة حالة تحول. ترتبط هذه الرسائل بكل من التفاعل والمحادثة. يتم استخدامها لإعلام العميل في حالة فشل التفاعل مع الواجهة الخلفية لمربع الحوار، على سبيل المثال في حالة حدوث مشكلة في الشبكة أو انتهاء المهلة أو التعطل أو مشكلة أخرى.

الخصائص الموروثة

sessionStarted

يحدد معالج الأحداث لأحداث بدء جلسة العمل.

sessionStopped

يحدد معالج الأحداث للأحداث المتوقفة عن الجلسة.

speechEndDetected

يحدد معالج الأحداث للأحداث المتوقفة عن الكلام.

speechStartDetected

يحدد معالج الأحداث لأحداث بدء الكلام.

الأساليب

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

إغلاق كافة الموارد الخارجية التي يحتفظ بها مثيل من هذه الفئة.

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

بدء اتصال بالخدمة. يمكن للمستخدمين اختياريا الاتصال () لإعداد اتصال يدويا مسبقا، قبل بدء التفاعلات.

ملاحظة: عند العودة، قد لا يكون الاتصال جاهزا بعد. يرجى الاشتراك في الحدث المتصل ليتم إعلامك عند إنشاء الاتصال.

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

إغلاق الاتصال بالخدمة. يمكن للمستخدمين اختياريا استدعاء disconnect() لإيقاف اتصال DialogServiceConnector المقترن يدويا.

إذا تم استدعاء disconnect() أثناء التعرف، فسيفشل التعرف ويلغى مع وجود خطأ.

listenOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

يبدأ التعرف ويتوقف بعد التعرف على التعبير الأول.

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

الأساليب المتوارثة

enableTelemetry(boolean)

يمكن هذا الأسلوب بيانات تتبع الاستخدام أو يعطلها بشكل عام.

تفاصيل المنشئ

DialogServiceConnector(DialogServiceConfig, AudioConfig)

تهيئة مثيل DialogServiceConnector.

new DialogServiceConnector(dialogConfig: DialogServiceConfig, audioConfig?: AudioConfig)

المعلمات

dialogConfig
DialogServiceConfig

مجموعة من الخصائص لتكوين أداة التعرف هذه.

audioConfig
AudioConfig

تكوين صوت اختياري مقترن بأداة التعرف

تفاصيل الخاصية

activityReceived

يشير نشاط الحدث إلى أنه تم تلقي نشاط.

public activityReceived: (sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

قيمة الخاصية

(sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

authorizationToken

يحصل على رمز التخويل المميز المستخدم للاتصال بالخدمة.

string authorizationToken

قيمة الخاصية

string

رمز التخويل المميز.

canceled

قام الحدث بإلغاء الإشارات إلى حدوث خطأ أثناء التعرف.

public canceled: (sender: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

قيمة الخاصية

(sender: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

internalData

object internalData

قيمة الخاصية

object

properties

مجموعة الخصائص وقيمها المحددة ل DialogServiceConnector هذا.

PropertyCollection properties

قيمة الخاصية

مجموعة الخصائص وقيمها المحددة ل DialogServiceConnector هذا.

recognized

يشير الحدث الذي تم التعرف عليه إلى تلقي نتيجة التعرف النهائية.

public recognized: (sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

قيمة الخاصية

(sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

recognizing

يشير الحدث الذي يتعرف على الإشارات إلى تلقي نتيجة التعرف المتوسطة.

public recognizing: (sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

قيمة الخاصية

(sender: DialogServiceConnector, event: SpeechRecognitionEventArgs) => void

speechActivityTemplate

يحصل على قالب النشاط الذي تم إنشاؤه بواسطة الخدمة من الكلام. سيتم ختم الخصائص من القالب على النشاط الذي تم إنشاؤه. يمكن أن يكون فارغا

string speechActivityTemplate

قيمة الخاصية

string

telemetryEnabled

يقوم هذا الأسلوب بإرجاع الحالة الحالية لإعداد بيانات تتبع الاستخدام.

static boolean telemetryEnabled

قيمة الخاصية

boolean

صحيح إذا تم تمكين بيانات تتبع الاستخدام، خطأ بخلاف ذلك.

turnStatusReceived

يشير الحدث turnStatusReceived إلى تلقي رسالة حالة تحول. ترتبط هذه الرسائل بكل من التفاعل والمحادثة. يتم استخدامها لإعلام العميل في حالة فشل التفاعل مع الواجهة الخلفية لمربع الحوار، على سبيل المثال في حالة حدوث مشكلة في الشبكة أو انتهاء المهلة أو التعطل أو مشكلة أخرى.

public turnStatusReceived: (sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

قيمة الخاصية

(sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

تفاصيل الخاصية الموروثة

sessionStarted

يحدد معالج الأحداث لأحداث بدء جلسة العمل.

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

قيمة الخاصية

(sender: Recognizer, event: SessionEventArgs) => void

موروث منRecognizer.sessionStarted

sessionStopped

يحدد معالج الأحداث للأحداث المتوقفة عن الجلسة.

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

قيمة الخاصية

(sender: Recognizer, event: SessionEventArgs) => void

موروث منRecognizer.sessionStopped

speechEndDetected

يحدد معالج الأحداث للأحداث المتوقفة عن الكلام.

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

قيمة الخاصية

(sender: Recognizer, event: RecognitionEventArgs) => void

موروث منRecognizer.speechEndDetected

speechStartDetected

يحدد معالج الأحداث لأحداث بدء الكلام.

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

قيمة الخاصية

(sender: Recognizer, event: RecognitionEventArgs) => void

موروث منRecognizer.speechStartDetected

تفاصيل الأسلوب

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

إغلاق كافة الموارد الخارجية التي يحتفظ بها مثيل من هذه الفئة.

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

المعلمات

cb

() => void

err

(error: string) => void

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

بدء اتصال بالخدمة. يمكن للمستخدمين اختياريا الاتصال () لإعداد اتصال يدويا مسبقا، قبل بدء التفاعلات.

ملاحظة: عند العودة، قد لا يكون الاتصال جاهزا بعد. يرجى الاشتراك في الحدث المتصل ليتم إعلامك عند إنشاء الاتصال.

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

المعلمات

cb

() => void

err

(error: string) => void

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

إغلاق الاتصال بالخدمة. يمكن للمستخدمين اختياريا استدعاء disconnect() لإيقاف اتصال DialogServiceConnector المقترن يدويا.

إذا تم استدعاء disconnect() أثناء التعرف، فسيفشل التعرف ويلغى مع وجود خطأ.

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

المعلمات

cb

() => void

err

(error: string) => void

listenOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

يبدأ التعرف ويتوقف بعد التعرف على التعبير الأول.

function listenOnceAsync(cb?: (e: SpeechRecognitionResult) => void, err?: (e: string) => void)

المعلمات

cb

(e: SpeechRecognitionResult) => void

رد الاتصال الذي تلقى النتيجة عند اكتمال reco.

err

(e: string) => void

رد الاتصال الذي تم استدعاؤه في حالة حدوث خطأ.

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

function sendActivityAsync(activity: string, cb?: () => void, errCb?: (error: string) => void)

المعلمات

activity

string

cb

() => void

errCb

(error: string) => void

تفاصيل الأساليب المتوارثة

enableTelemetry(boolean)

يمكن هذا الأسلوب بيانات تتبع الاستخدام أو يعطلها بشكل عام.

static function enableTelemetry(enabled: boolean)

المعلمات

enabled

boolean

الإعداد العمومي لمجموعة بيانات تتبع الاستخدام. إذا تم تعيينها إلى true، يتم جمع معلومات القياس عن بعد مثل أخطاء الميكروفون، ويتم جمع أخطاء التعرف وإرسالها إلى Microsoft. إذا تم تعيينه إلى خطأ، فلن يتم إرسال أي بيانات تتبع الاستخدام إلى Microsoft.

موروث منRecognizer.enableTelemetry