SpeechConfig class
تكوين الكلام.
الخصائص
authorization |
يحصل على رمز التخويل المميز. |
endpoint |
يحصل على معرف نقطة النهاية لنموذج كلام مخصص يستخدم للتعرف على الكلام. |
output |
الحصول على تنسيق إخراج التعرف على الكلام (بسيط أو مفصل). ملاحظة: تنسيق الإخراج هذا مخصص لنتيجة التعرف على الكلام، استخدم [SpeechConfig.speechSynthesisOutputFormat] للحصول على تنسيق إخراج الصوت المركب. |
region | |
speech |
إرجاع اللغة المكونة. |
speech |
الحصول على لغة تركيب الكلام. تمت إضافته في الإصدار 1.11.0. |
speech |
يحصل على تنسيق إخراج تركيب الكلام. تمت إضافته في الإصدار 1.11.0. |
speech |
يحصل على صوت تركيب الكلام. تمت إضافته في الإصدار 1.11.0. |
subscription |
الأساليب
close() | إغلاق التكوين. |
enable |
تمكين تسجيل الصوت في الخدمة. يتم تخزين سجلات الصوت والمحتوى إما في التخزين المملوك ل Microsoft، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد Speech الممكن للتخزين الخاص بك (BYOS). ستتم إزالة السجلات بعد 30 يوما. تمت الإضافة في الإصدار 1.7.0. |
enable |
تمكين الإملاء. مدعوم فقط في التعرف المستمر على الكلام. تمت الإضافة في الإصدار 1.7.0. |
from |
إنشاء مثيل لمصنع الكلام مع رمز التخويل الأساسي المحدد والمنطقة. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق استدعاء هذا المعين برمز مميز صالح جديد. ملاحظة: يرجى استخدام رمز مميز مشتق من مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف. عند نسخ قيم التكوين عند إنشاء أداة التعرف الجديدة، لن تنطبق قيمة الرمز المميز الجديدة على أدوات التعرف التي تم إنشاؤها بالفعل. بالنسبة إلى أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز لأداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف أخطاء أثناء التعرف. |
from |
إنشاء مثيل لتكوين الكلام بنقطة نهاية محددة ومفتاح اشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون نقطة نهاية خدمة غير قياسية أو معلمات. ملاحظة: يرجى استخدام مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف. ملاحظة: لا يتم تغيير معلمات الاستعلام المحددة في عنوان URL لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي واجهات برمجة تطبيقات أخرى. على سبيل المثال، إذا تم تعريف اللغة في uri كمعلمة استعلام "language=de-DE"، وتم تعيينها أيضا بواسطة SpeechConfig.speechRecognitionLanguage = "en-US"، فإن إعداد اللغة في uri له الأسبقية، واللغة الفعالة هي "de-DE". يمكن تعيين المعلمات التي لم يتم تحديدها في عنوان URL لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز. |
from |
إنشاء مثيل لتكوين الكلام مع المضيف المحدد ومفتاح الاشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون مضيف خدمة غير افتراضي. سيتم افتراض مسار المورد القياسي. بالنسبة للخدمات ذات مسار مورد غير قياسي أو بدون مسار على الإطلاق، استخدم منEndpoint بدلا من ذلك. ملاحظة: معلمات الاستعلام غير مسموح بها في URI المضيف ويجب تعيينها بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز تخويل مميز مع fromHost، استخدم fromHost(URL)، ثم قم بتعيين الخاصية AuthorizationToken على مثيل SpeechConfig الذي تم إنشاؤه. ملاحظة: تمت إضافته في الإصدار 1.9.0. |
from |
تم إرجاع مثيل ثابت من SpeechConfig عن طريق تمرير subscriptionKey ومنطقة الخدمة. ملاحظة: يرجى استخدام مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف. |
get |
إرجاع القيمة الحالية لخاصية عشوائية. |
request |
يتضمن طوابع زمنية على مستوى الكلمات. تمت الإضافة في الإصدار 1.7.0. |
set |
تعيين خيار الألفاظ النابية. تمت الإضافة في الإصدار 1.7.0. |
set |
تعيين خاصية عشوائية. |
set |
تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0. |
set |
تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0. |
set |
تعيين قيمة خاصية سيتم تمريرها إلى الخدمة باستخدام القناة المحددة. تمت الإضافة في الإصدار 1.7.0. |
تفاصيل الخاصية
authorizationToken
يحصل على رمز التخويل المميز.
string authorizationToken
قيمة الخاصية
string
endpointId
يحصل على معرف نقطة النهاية لنموذج كلام مخصص يستخدم للتعرف على الكلام.
string endpointId
قيمة الخاصية
string
معرف نقطة النهاية
outputFormat
الحصول على تنسيق إخراج التعرف على الكلام (بسيط أو مفصل). ملاحظة: تنسيق الإخراج هذا مخصص لنتيجة التعرف على الكلام، استخدم [SpeechConfig.speechSynthesisOutputFormat] للحصول على تنسيق إخراج الصوت المركب.
OutputFormat outputFormat
قيمة الخاصية
إرجاع تنسيق الإخراج.
region
string region
قيمة الخاصية
string
المنطقة المعينة على التكوين.
speechRecognitionLanguage
إرجاع اللغة المكونة.
string speechRecognitionLanguage
قيمة الخاصية
string
speechSynthesisLanguage
الحصول على لغة تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
string speechSynthesisLanguage
قيمة الخاصية
string
إرجاع لغة تركيب الكلام.
speechSynthesisOutputFormat
يحصل على تنسيق إخراج تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
SpeechSynthesisOutputFormat speechSynthesisOutputFormat
قيمة الخاصية
إرجاع تنسيق إخراج تركيب الكلام
speechSynthesisVoiceName
يحصل على صوت تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
string speechSynthesisVoiceName
قيمة الخاصية
string
إرجاع صوت تركيب الكلام.
subscriptionKey
string subscriptionKey
قيمة الخاصية
string
تم تعيين مفتاح الاشتراك على التكوين.
تفاصيل الأسلوب
close()
إغلاق التكوين.
function close()
enableAudioLogging()
تمكين تسجيل الصوت في الخدمة. يتم تخزين سجلات الصوت والمحتوى إما في التخزين المملوك ل Microsoft، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد Speech الممكن للتخزين الخاص بك (BYOS). ستتم إزالة السجلات بعد 30 يوما. تمت الإضافة في الإصدار 1.7.0.
function enableAudioLogging()
enableDictation()
تمكين الإملاء. مدعوم فقط في التعرف المستمر على الكلام. تمت الإضافة في الإصدار 1.7.0.
function enableDictation()
fromAuthorizationToken(string, string)
إنشاء مثيل لمصنع الكلام مع رمز التخويل الأساسي المحدد والمنطقة. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق استدعاء هذا المعين برمز مميز صالح جديد. ملاحظة: يرجى استخدام رمز مميز مشتق من مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف. عند نسخ قيم التكوين عند إنشاء أداة التعرف الجديدة، لن تنطبق قيمة الرمز المميز الجديدة على أدوات التعرف التي تم إنشاؤها بالفعل. بالنسبة إلى أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز لأداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف أخطاء أثناء التعرف.
static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechConfig
المعلمات
- authorizationToken
-
string
الرمز المميز للتخويل الأولي.
- region
-
string
اسم المنطقة (راجع صفحة المنطقة).
المرتجعات
مثيل مصنع الكلام.
fromEndpoint(URL, string)
إنشاء مثيل لتكوين الكلام بنقطة نهاية محددة ومفتاح اشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون نقطة نهاية خدمة غير قياسية أو معلمات. ملاحظة: يرجى استخدام مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف. ملاحظة: لا يتم تغيير معلمات الاستعلام المحددة في عنوان URL لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي واجهات برمجة تطبيقات أخرى. على سبيل المثال، إذا تم تعريف اللغة في uri كمعلمة استعلام "language=de-DE"، وتم تعيينها أيضا بواسطة SpeechConfig.speechRecognitionLanguage = "en-US"، فإن إعداد اللغة في uri له الأسبقية، واللغة الفعالة هي "de-DE". يمكن تعيين المعلمات التي لم يتم تحديدها في عنوان URL لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز.
static function fromEndpoint(endpoint: URL, subscriptionKey?: string): SpeechConfig
المعلمات
- endpoint
-
URL
نقطة نهاية الخدمة للاتصال بها.
- subscriptionKey
-
string
مفتاح الاشتراك. إذا لم يتم تحديد مفتاح اشتراك، فيجب تعيين رمز مميز للتخويل.
المرتجعات
مثيل مصنع الكلام.
fromHost(URL, string)
إنشاء مثيل لتكوين الكلام مع المضيف المحدد ومفتاح الاشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون مضيف خدمة غير افتراضي. سيتم افتراض مسار المورد القياسي. بالنسبة للخدمات ذات مسار مورد غير قياسي أو بدون مسار على الإطلاق، استخدم منEndpoint بدلا من ذلك. ملاحظة: معلمات الاستعلام غير مسموح بها في URI المضيف ويجب تعيينها بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز تخويل مميز مع fromHost، استخدم fromHost(URL)، ثم قم بتعيين الخاصية AuthorizationToken على مثيل SpeechConfig الذي تم إنشاؤه. ملاحظة: تمت إضافته في الإصدار 1.9.0.
static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig
المعلمات
- hostName
-
URL
- subscriptionKey
-
string
مفتاح الاشتراك. إذا لم يتم تحديد مفتاح اشتراك، فيجب تعيين رمز مميز للتخويل.
المرتجعات
مثيل مصنع الكلام.
fromSubscription(string, string)
تم إرجاع مثيل ثابت من SpeechConfig عن طريق تمرير subscriptionKey ومنطقة الخدمة. ملاحظة: يرجى استخدام مفتاح اشتراك LanguageUnderstanding في حالة رغبتك في استخدام أداة التعرف على الهدف.
static function fromSubscription(subscriptionKey: string, region: string): SpeechConfig
المعلمات
- subscriptionKey
-
string
مفتاح الاشتراك.
- region
-
string
اسم المنطقة (راجع صفحة المنطقة).
المرتجعات
مصنع الكلام
getProperty(string, string)
إرجاع القيمة الحالية لخاصية عشوائية.
function getProperty(name: string, def?: string): string
المعلمات
- name
-
string
اسم الخاصية للاستعلام.
- def
-
string
القيمة المراد إرجاعها في حالة عدم معرفة الخاصية.
المرتجعات
string
القيمة الحالية، أو الافتراضية المقدمة، للخاصية المحددة.
requestWordLevelTimestamps()
يتضمن طوابع زمنية على مستوى الكلمات. تمت الإضافة في الإصدار 1.7.0.
function requestWordLevelTimestamps()
setProfanity(ProfanityOption)
تعيين خيار الألفاظ النابية. تمت الإضافة في الإصدار 1.7.0.
function setProfanity(profanity: ProfanityOption)
المعلمات
- profanity
- ProfanityOption
setProperty(string | PropertyId, string)
تعيين خاصية عشوائية.
function setProperty(name: string | PropertyId, value: string)
المعلمات
- name
-
string | PropertyId
اسم الخاصية المراد تعيينها.
- value
-
string
القيمة الجديدة للخاصية .
setProxy(string, number)
تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0.
function setProxy(proxyHostName: string, proxyPort: number)
المعلمات
- proxyHostName
-
string
اسم المضيف للخادم الوكيل.
- proxyPort
-
number
رقم المنفذ للخادم الوكيل.
setProxy(string, number, string, string)
تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0.
function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)
المعلمات
- proxyHostName
-
string
اسم المضيف للخادم الوكيل، دون نظام البروتوكول (http://)
- proxyPort
-
number
رقم المنفذ للخادم الوكيل.
- proxyUserName
-
string
اسم المستخدم للخادم الوكيل.
- proxyPassword
-
string
كلمة مرور الخادم الوكيل.
setServiceProperty(string, string, UriQueryParameter)
تعيين قيمة خاصية سيتم تمريرها إلى الخدمة باستخدام القناة المحددة. تمت الإضافة في الإصدار 1.7.0.
function setServiceProperty(name: string, value: string, channel: UriQueryParameter)
المعلمات
- name
-
string
- value
-
string
- channel
- UriQueryParameter