IntentRecognizer class

الحزمة:

microsoft-cognitiveservices-speech-sdk

أداة التعرف على الهدف.

Extends

Recognizer

المنشئون

IntentRecognizer(SpeechConfig, AudioConfig)

تهيئة مثيل IntentRecognizer.

الخصائص

authorizationToken	يحصل على رمز التخويل المميز المستخدم للاتصال بالخدمة.
canceled	ألغى الحدث إشارات إلى حدوث خطأ أثناء التعرف.
internalData
properties	مجموعة الخصائص وقيمها المحددة لهذا IntentRecognizer.
recognized	يشير الحدث الذي تم التعرف عليه إلى تلقي نتيجة التعرف النهائية.
recognizing	يشير الحدث الذي يتعرف على الإشارات إلى تلقي نتيجة التعرف المتوسطة.
speechRecognitionLanguage	يحصل على لغة التعرف المنطوقة.
telemetryEnabled	ترجع هذه الطريقة الحالة الحالية لإعداد بيانات تتبع الاستخدام.

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

sessionStarted	يحدد معالج الأحداث للأحداث التي بدأت في جلسة العمل.
sessionStopped	يحدد معالج الأحداث للأحداث المتوقفة عن الجلسة.
speechEndDetected	يحدد معالج الأحداث للأحداث المتوقفة عن الكلام.
speechStartDetected	يحدد معالج الأحداث لأحداث بدء الكلام.

الأساليب

addAllIntents(LanguageUnderstandingModel, string)
addIntent(string, string)	يضيف عبارة يجب التعرف عليها كهدف.
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)	إضافة هدف من خدمة Language Understanding للتعرف عليه.
close(() => void, (error: string) => void)	إغلاق كافة الموارد الخارجية التي يحتفظ بها مثيل من هذه الفئة.
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)	يبدأ التعرف على الهدف، ويتوقف بعد التعرف على التعبير الأول. ترجع المهمة نص التعرف والهدف نتيجة لذلك. ملاحظة: ترجع RecognizeOnceAsync() عند التعرف على التعبير الأول، لذلك فهي مناسبة فقط للتعرف على لقطة واحدة مثل الأمر أو الاستعلام. للتعرف على المدى الطويل، استخدم StartContinuousRecognitionAsync() بدلا من ذلك.
startContinuousRecognitionAsync(() => void, (e: string) => void)	يبدأ التعرف على الكلام، حتى يتم استدعاء stopContinuousRecognitionAsync(). يجب على المستخدم الاشتراك في الأحداث لتلقي نتائج التعرف.
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)	يبدأ التعرف على الكلام مع تحديد الكلمات الأساسية، حتى يتم استدعاء stopKeywordRecognitionAsync(). يجب على المستخدم الاشتراك في الأحداث لتلقي نتائج التعرف. ملاحظة: تتوفر وظيفة تحديد الكلمات الرئيسية فقط على Speech Devices SDK. هذه الوظيفة غير مضمنة حاليا في SDK نفسها.
stopContinuousRecognitionAsync(() => void, (e: string) => void)	إيقاف التعرف المستمر على الهدف.
stopKeywordRecognitionAsync(() => void, (e: string) => void)	إيقاف التعرف المستمر على الكلام. ملاحظة: تتوفر وظيفة تحديد الكلمات الرئيسية فقط على Speech Devices SDK. هذه الوظيفة غير مضمنة حاليا في SDK نفسها.

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

enableTelemetry(boolean)

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

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

IntentRecognizer(SpeechConfig, AudioConfig)

تهيئة مثيل IntentRecognizer.

new IntentRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

المعلمات

speechConfig

SpeechConfig

مجموعة خصائص التكوين.

audioConfig

AudioConfig

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

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

authorizationToken

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

string authorizationToken

قيمة الخاصية

string

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

canceled

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

public canceled: (sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

قيمة الخاصية

(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

internalData

object internalData

قيمة الخاصية

object

properties

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

PropertyCollection properties

قيمة الخاصية

PropertyCollection

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

recognized

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

public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

قيمة الخاصية

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

recognizing

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

public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

قيمة الخاصية

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

speechRecognitionLanguage

يحصل على لغة التعرف المنطوقة.

string speechRecognitionLanguage

قيمة الخاصية

string

لغة التعرف المنطوقة.

telemetryEnabled

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

static boolean telemetryEnabled

قيمة الخاصية

boolean

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

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

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

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

addAllIntents(LanguageUnderstandingModel, string)

function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)

المعلمات

model

LanguageUnderstandingModel

نموذج فهم اللغة الذي يحتوي على الأهداف.

intentId

string

سلسلة معرف مخصصة سيتم إرجاعها في أسلوب getIntentId() الخاص ب IntentRecognitionResult.

addIntent(string, string)

يضيف عبارة يجب التعرف عليها كهدف.

function addIntent(simplePhrase: string, intentId?: string)

المعلمات

simplePhrase

string

intentId

string

سلسلة تمثل معرف الهدف المراد التعرف عليه.

addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

إضافة هدف من خدمة Language Understanding للتعرف عليه.

function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)

المعلمات

intentId

string

سلسلة تمثل معرف الهدف المراد التعرف عليه. يتم تجاهله إذا كان intentName فارغا.

model

LanguageUnderstandingModel

نموذج الهدف من خدمة Language Understanding.

intentName

string

اسم الهدف المحدد في نموذج الهدف. إذا كان فارغا، فستتم إضافة جميع أسماء الأهداف المحددة في النموذج.

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

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

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

المعلمات

cb

() => void

errorCb

(error: string) => void

recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

يبدأ التعرف على الهدف، ويتوقف بعد التعرف على التعبير الأول. ترجع المهمة نص التعرف والهدف نتيجة لذلك. ملاحظة: ترجع RecognizeOnceAsync() عند التعرف على التعبير الأول، لذلك فهي مناسبة فقط للتعرف على لقطة واحدة مثل الأمر أو الاستعلام. للتعرف على المدى الطويل، استخدم StartContinuousRecognitionAsync() بدلا من ذلك.

function recognizeOnceAsync(cb?: (e: IntentRecognitionResult) => void, err?: (e: string) => void)

المعلمات

cb

(e: IntentRecognitionResult) => void

انتهى رد الاتصال الذي تلقى التعرف باستخدام IntentRecognitionResult.

err

(e: string) => void

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

startContinuousRecognitionAsync(() => void, (e: string) => void)

يبدأ التعرف على الكلام، حتى يتم استدعاء stopContinuousRecognitionAsync(). يجب على المستخدم الاشتراك في الأحداث لتلقي نتائج التعرف.

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

المعلمات

cb

() => void

رد الاتصال الذي تم استدعاؤه بمجرد بدء التعرف.

err

(e: string) => void

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

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

يبدأ التعرف على الكلام مع تحديد الكلمات الأساسية، حتى يتم استدعاء stopKeywordRecognitionAsync(). يجب على المستخدم الاشتراك في الأحداث لتلقي نتائج التعرف. ملاحظة: تتوفر وظيفة تحديد الكلمات الرئيسية فقط على Speech Devices SDK. هذه الوظيفة غير مضمنة حاليا في SDK نفسها.

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

المعلمات

model

KeywordRecognitionModel

نموذج التعرف على الكلمة الأساسية الذي يحدد الكلمة الأساسية التي سيتم التعرف عليها.

cb

() => void

رد الاتصال الذي تم استدعاؤه بمجرد بدء التعرف.

err

(e: string) => void

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

stopContinuousRecognitionAsync(() => void, (e: string) => void)

إيقاف التعرف المستمر على الهدف.

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

المعلمات

cb

() => void

رد الاتصال الذي تم استدعاؤه بمجرد توقف التعرف.

err

(e: string) => void

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

stopKeywordRecognitionAsync(() => void, (e: string) => void)

إيقاف التعرف المستمر على الكلام. ملاحظة: تتوفر وظيفة تحديد الكلمات الرئيسية فقط على Speech Devices SDK. هذه الوظيفة غير مضمنة حاليا في SDK نفسها.

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

المعلمات

cb

() => void

رد الاتصال الذي تم استدعاؤه بمجرد توقف التعرف.

err

(e: string) => void

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

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

enableTelemetry(boolean)

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

static function enableTelemetry(enabled: boolean)

المعلمات

enabled

boolean

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

الموروث منRecognizer.enableTelemetry