SpeechRecognizer class

الحزمة:

microsoft-cognitiveservices-speech-sdk

يقوم بإجراء التعرف على الكلام من الميكروفون أو الملف أو تدفقات إدخال الصوت الأخرى، ويحصل على نص منسوخ نتيجة لذلك.

Extends

Recognizer

المنشئون

SpeechRecognizer(SpeechConfig, AudioConfig)

منشئ SpeechRecognizer.

الخصائص

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

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

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

الأساليب

close(() => void, (error: string) => void)	إغلاق كافة الموارد الخارجية التي يحتفظ بها مثيل من هذه الفئة.
dispose(boolean)	التخلص من أي موارد يحتفظ بها الكائن.
FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)	منشئ SpeechRecognizer.
recognizeOnceAsync((e: SpeechRecognitionResult) => 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)	إيقاف التعرف المستمر على الكلام. ملاحظة: تتوفر وظيفة تحديد الكلمات الرئيسية فقط على Speech Devices SDK. هذه الوظيفة غير مضمنة حاليا في SDK نفسها.

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

enableTelemetry(boolean)

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

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

SpeechRecognizer(SpeechConfig, AudioConfig)

منشئ SpeechRecognizer.

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

المعلمات

speechConfig

SpeechConfig

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

audioConfig

AudioConfig

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

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

authorizationToken

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

string authorizationToken

قيمة الخاصية

string

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

canceled

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

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

قيمة الخاصية

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

endpointId

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

string endpointId

قيمة الخاصية

string

معرف نقطة النهاية لنموذج كلام مخصص يستخدم للتعرف على الكلام.

internalData

object internalData

قيمة الخاصية

object

outputFormat

الحصول على تنسيق الإخراج للتعرف.

OutputFormat outputFormat

قيمة الخاصية

OutputFormat

تنسيق الإخراج للتعرف.

properties

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

PropertyCollection properties

قيمة الخاصية

PropertyCollection

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

recognized

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

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

قيمة الخاصية

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

recognizing

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

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

قيمة الخاصية

(sender: Recognizer, event: SpeechRecognitionEventArgs) => 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

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

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

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

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

المعلمات

cb

() => void

errorCb

(error: string) => void

dispose(boolean)

التخلص من أي موارد يحتفظ بها الكائن.

function dispose(disposing: boolean): Promise<void>

المعلمات

disposing

boolean

صحيح إذا تم التخلص من الكائن.

المرتجعات

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

منشئ SpeechRecognizer.

static function FromConfig(speechConfig: SpeechConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): SpeechRecognizer

المعلمات

speechConfig

SpeechConfig

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

autoDetectSourceLanguageConfig

AutoDetectSourceLanguageConfig

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

audioConfig

AudioConfig

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

المرتجعات

SpeechRecognizer

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

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

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

المعلمات

cb

(e: SpeechRecognitionResult) => void

رد الاتصال الذي تلقى SpeechRecognitionResult.

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)

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

function stopKeywordRecognitionAsync(cb?: () => void)

المعلمات

cb

() => void

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

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

enableTelemetry(boolean)

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

static function enableTelemetry(enabled: boolean)

المعلمات

enabled

boolean

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

موروث منRecognizer.enableTelemetry