SpeechTranslationConfig class

الحزمة:

microsoft-cognitiveservices-speech-sdk

تكوين ترجمة الكلام.

Extends

SpeechConfig

الخصائص

authorizationToken	الحصول على/تعيين رمز التخويل المميز. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق استدعاء هذا المعين برمز مميز صالح جديد.
endpointId	يحصل على معرف نقطة النهاية لنموذج كلام مخصص يستخدم للتعرف على الكلام.
outputFormat	الحصول على تنسيق إخراج التعرف على الكلام (بسيط أو مفصل). ملاحظة: تنسيق الإخراج هذا مخصص لنتيجة التعرف على الكلام، استخدم [SpeechConfig.speechSynthesisOutputFormat] للحصول على تنسيق إخراج الصوت المركب.
region
speechRecognitionLanguage	الحصول على/تعيين لغة التعرف على الكلام.
speechSynthesisLanguage	الحصول على لغة تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
speechSynthesisOutputFormat	الحصول على تنسيق إخراج تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
speechSynthesisVoiceName	يحصل على صوت تركيب الكلام. تمت إضافته في الإصدار 1.11.0.
subscriptionKey
targetLanguages	يحصل على اللغة الهدف (النص) للترجمة إليها.
voiceName	الحصول على اسم الصوت المحدد.

الأساليب

addTargetLanguage(string)	أضف لغة هدف (نص) للترجمة إليها.
close()	التخلص من الموارد المقترنة.
fromAuthorizationToken(string, string)	تم إرجاع مثيل ثابت من SpeechTranslationConfig عن طريق تمرير رمز التخويل المميز ومنطقة الخدمة. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق تعيين خاصية authorizationToken برمز مميز صالح جديد. وإلا، ستواجه جميع أدوات التعرف التي تم إنشاؤها بواسطة مثيل SpeechTranslationConfig هذا أخطاء أثناء التعرف. عند نسخ قيم التكوين عند إنشاء أداة التعرف الجديدة، لن تنطبق قيمة الرمز المميز الجديدة على أدوات التعرف التي تم إنشاؤها بالفعل. بالنسبة إلى أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز لأداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف أخطاء أثناء التعرف.
fromEndpoint(URL, string)	إنشاء مثيل لتكوين ترجمة الكلام بنقطة نهاية محددة ومفتاح اشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون نقطة نهاية خدمة غير قياسية أو المعلمات. ملاحظة: لا يتم تغيير خصائص الاستعلام المحددة في عنوان URL لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي واجهات برمجة تطبيقات أخرى. على سبيل المثال، إذا تم تعريف اللغة في uri كمعلمة استعلام "language=de-DE"، وتم تعيينها أيضا بواسطة الخاصية speechRecognitionLanguage، فإن إعداد اللغة في uri له الأسبقية، واللغة الفعالة هي "de-DE". يمكن تعيين الخصائص التي لم يتم تحديدها في عنوان URL لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز.
fromHost(URL, string)	إنشاء مثيل لتكوين الكلام مع المضيف المحدد ومفتاح الاشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون مضيف خدمة غير افتراضي. سيتم افتراض مسار المورد القياسي. بالنسبة للخدمات ذات مسار مورد غير قياسي أو بدون مسار على الإطلاق، استخدم منEndpoint بدلا من ذلك. ملاحظة: معلمات الاستعلام غير مسموح بها في URI المضيف ويجب تعيينها بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز تخويل مميز مع fromHost، استخدم fromHost(URL)، ثم قم بتعيين الخاصية AuthorizationToken على مثيل SpeechConfig الذي تم إنشاؤه. ملاحظة: تمت إضافته في الإصدار 1.9.0.
fromSubscription(string, string)	تم إرجاع مثيل ثابت من SpeechTranslationConfig عن طريق تمرير مفتاح اشتراك ومنطقة خدمة.
setProperty(string | PropertyId, string)	تعيين خاصية مسماة كقيمة

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

enableAudioLogging()	تمكين تسجيل الصوت في الخدمة. يتم تخزين سجلات الصوت والمحتوى إما في التخزين المملوك ل Microsoft، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد Speech الممكن للتخزين الخاص بك (BYOS). ستتم إزالة السجلات بعد 30 يوما. تمت الإضافة في الإصدار 1.7.0.
enableDictation()	تمكين الإملاء. مدعوم فقط في التعرف المستمر على الكلام. تمت الإضافة في الإصدار 1.7.0.
getProperty(string, string)	إرجاع القيمة الحالية لخاصية عشوائية.
requestWordLevelTimestamps()	يتضمن طوابع زمنية على مستوى الكلمات. تمت الإضافة في الإصدار 1.7.0.
setProfanity(ProfanityOption)	تعيين خيار الألفاظ النابية. تمت الإضافة في الإصدار 1.7.0.
setProxy(string, number)	تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0.
setProxy(string, number, string, string)	تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	تعيين قيمة خاصية سيتم تمريرها إلى الخدمة باستخدام القناة المحددة. تمت الإضافة في الإصدار 1.7.0.

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

authorizationToken

الحصول على/تعيين رمز التخويل المميز. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق استدعاء هذا المعين برمز مميز صالح جديد.

void authorizationToken

قيمة الخاصية

void

endpointId

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

string endpointId

قيمة الخاصية

string

معرف نقطة النهاية

outputFormat

الحصول على تنسيق إخراج التعرف على الكلام (بسيط أو مفصل). ملاحظة: تنسيق الإخراج هذا مخصص لنتيجة التعرف على الكلام، استخدم [SpeechConfig.speechSynthesisOutputFormat] للحصول على تنسيق إخراج الصوت المركب.

OutputFormat outputFormat

قيمة الخاصية

OutputFormat

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

region

string region

قيمة الخاصية

string

المنطقة المعينة على التكوين.

speechRecognitionLanguage

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

void speechRecognitionLanguage

قيمة الخاصية

void

speechSynthesisLanguage

الحصول على لغة تركيب الكلام. تمت إضافته في الإصدار 1.11.0.

string speechSynthesisLanguage

قيمة الخاصية

string

إرجاع لغة تركيب الكلام.

speechSynthesisOutputFormat

الحصول على تنسيق إخراج تركيب الكلام. تمت إضافته في الإصدار 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

قيمة الخاصية

SpeechSynthesisOutputFormat

إرجاع تنسيق إخراج تركيب الكلام

speechSynthesisVoiceName

يحصل على صوت تركيب الكلام. تمت إضافته في الإصدار 1.11.0.

string speechSynthesisVoiceName

قيمة الخاصية

string

إرجاع صوت تركيب الكلام.

subscriptionKey

string subscriptionKey

قيمة الخاصية

string

تم تعيين مفتاح الاشتراك على التكوين.

targetLanguages

يحصل على اللغة الهدف (النص) للترجمة إليها.

string[] targetLanguages

قيمة الخاصية

string[]

voiceName

الحصول على اسم الصوت المحدد.

string voiceName

قيمة الخاصية

string

اسم الصوت.

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

addTargetLanguage(string)

أضف لغة هدف (نص) للترجمة إليها.

function addTargetLanguage(value: string)

المعلمات

value

string

اللغة مثل de-DE

close()

التخلص من الموارد المقترنة.

function close()

fromAuthorizationToken(string, string)

تم إرجاع مثيل ثابت من SpeechTranslationConfig عن طريق تمرير رمز التخويل المميز ومنطقة الخدمة. ملاحظة: يحتاج المتصل إلى التأكد من أن الرمز المميز للتخويل صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق تعيين خاصية authorizationToken برمز مميز صالح جديد. وإلا، ستواجه جميع أدوات التعرف التي تم إنشاؤها بواسطة مثيل SpeechTranslationConfig هذا أخطاء أثناء التعرف. عند نسخ قيم التكوين عند إنشاء أداة التعرف الجديدة، لن تنطبق قيمة الرمز المميز الجديدة على أدوات التعرف التي تم إنشاؤها بالفعل. بالنسبة إلى أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز لأداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف أخطاء أثناء التعرف.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

المعلمات

authorizationToken

string

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

region

string

اسم المنطقة (راجع صفحة المنطقة).

المرتجعات

SpeechTranslationConfig

تكوين ترجمة الكلام.

fromEndpoint(URL, string)

إنشاء مثيل لتكوين ترجمة الكلام بنقطة نهاية محددة ومفتاح اشتراك. هذا الأسلوب مخصص فقط للمستخدمين الذين يستخدمون نقطة نهاية خدمة غير قياسية أو المعلمات. ملاحظة: لا يتم تغيير خصائص الاستعلام المحددة في عنوان URL لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي واجهات برمجة تطبيقات أخرى. على سبيل المثال، إذا تم تعريف اللغة في uri كمعلمة استعلام "language=de-DE"، وتم تعيينها أيضا بواسطة الخاصية speechRecognitionLanguage، فإن إعداد اللغة في uri له الأسبقية، واللغة الفعالة هي "de-DE". يمكن تعيين الخصائص التي لم يتم تحديدها في عنوان URL لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

المعلمات

endpoint

URL

نقطة نهاية الخدمة للاتصال بها.

subscriptionKey

string

مفتاح الاشتراك.

المرتجعات

SpeechTranslationConfig

مثيل تكوين الكلام.

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

مفتاح الاشتراك. إذا لم يتم تحديد مفتاح اشتراك، فيجب تعيين رمز مميز للتخويل.

المرتجعات

SpeechConfig

مثيل مصنع الكلام.

fromSubscription(string, string)

تم إرجاع مثيل ثابت من SpeechTranslationConfig عن طريق تمرير مفتاح اشتراك ومنطقة خدمة.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

المعلمات

subscriptionKey

string

مفتاح الاشتراك.

region

string

اسم المنطقة (راجع صفحة المنطقة).

المرتجعات

SpeechTranslationConfig

تكوين ترجمة الكلام.

setProperty(string | PropertyId, string)

تعيين خاصية مسماة كقيمة

function setProperty(name: string | PropertyId, value: string)

المعلمات

name

string | PropertyId

اسم الخاصية المراد تعيينها.

value

string

القيمة الجديدة للخاصية .

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

enableAudioLogging()

تمكين تسجيل الصوت في الخدمة. يتم تخزين سجلات الصوت والمحتوى إما في التخزين المملوك ل Microsoft، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد Speech الممكن للتخزين الخاص بك (BYOS). ستتم إزالة السجلات بعد 30 يوما. تمت الإضافة في الإصدار 1.7.0.

function enableAudioLogging()

موروث منSpeechConfig.enableAudioLogging

enableDictation()

تمكين الإملاء. مدعوم فقط في التعرف المستمر على الكلام. تمت الإضافة في الإصدار 1.7.0.

function enableDictation()

موروث منSpeechConfig.enableDictation

getProperty(string, string)

إرجاع القيمة الحالية لخاصية عشوائية.

function getProperty(name: string, def?: string): string

المعلمات

name

string

اسم الخاصية للاستعلام.

def

string

القيمة المراد إرجاعها في حالة عدم معرفة الخاصية.

المرتجعات

string

القيمة الحالية، أو الافتراضية المقدمة، للخاصية المحددة.

موروث منSpeechConfig.getProperty

requestWordLevelTimestamps()

يتضمن طوابع زمنية على مستوى الكلمات. تمت الإضافة في الإصدار 1.7.0.

function requestWordLevelTimestamps()

موروث منSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

تعيين خيار الألفاظ النابية. تمت الإضافة في الإصدار 1.7.0.

function setProfanity(profanity: ProfanityOption)

المعلمات

profanity

ProfanityOption

موروث منSpeechConfig.setProfanity

setProxy(string, number)

تعيين تكوين الوكيل. ذات صلة فقط في بيئات Node.js. تمت الإضافة في الإصدار 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

المعلمات

proxyHostName

string

اسم المضيف للخادم الوكيل.

proxyPort

number

رقم المنفذ للخادم الوكيل.

موروث منSpeechConfig.setProxy

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

كلمة مرور الخادم الوكيل.

موروث منSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

تعيين قيمة خاصية سيتم تمريرها إلى الخدمة باستخدام القناة المحددة. تمت الإضافة في الإصدار 1.7.0.

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

المعلمات

name

string

value

string

channel

UriQueryParameter

موروث منSpeechConfig.setServiceProperty