SpeechTranslationConfig class

الحزمة:

microsoft-cognitiveservices-speech-sdk

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

يمتد

SpeechConfig

الخصائص

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

الأساليب

addTargetLanguage(string)	إضافة لغة هدف (نص) للترجمة إليها.
close()	التخلص من الموارد المقترنة.
fromAuthorizationToken(string, string)	تم إرجاع مثيل ثابت من SpeechTranslationConfig عن طريق تمرير رمز التخويل المميز ومنطقة الخدمة. ملاحظة: يحتاج المتصل إلى التأكد من أن رمز التخويل المميز صالح. قبل انتهاء صلاحية الرمز المميز للتخويل، يحتاج المتصل إلى تحديثه عن طريق تعيين الخاصية authorizationToken برمز مميز صالح جديد. وإلا، ستواجه جميع أدوات التعرف التي تم إنشاؤها بواسطة مثيل SpeechTranslationConfig هذا أخطاء أثناء التعرف. نظرا لنسخ قيم التكوين عند إنشاء أداة التعرف الجديدة، لن تنطبق قيمة الرمز المميز الجديد على أدوات التعرف التي تم إنشاؤها بالفعل. بالنسبة إلى أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز لأداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف أخطاء أثناء التعرف.
fromEndpoint(URL, KeyCredential | TokenCredential)	ينشئ مثيلا لتكوين ترجمة الكلام مع نقطة نهاية مخصصة وبيانات اعتماد. لا يتم تغيير معلمات الاستعلام المحددة في عنوان URI لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي استدعاء واجهة برمجة تطبيقات آخر. على سبيل المثال، إذا تم تعريف لغة التعرف في معلمة استعلام URI على أنها "language=de-DE"، وتم تعيين الخاصية SpeechRecognitionLanguage إلى "en-US"، فإن اللغة المعينة في URI لها الأسبقية، وتظل "de-DE" هي اللغة المتوقعة. نظرا لأن المعلمات المضمنة في عنوان URI لنقطة النهاية لها الأولوية، يمكن تعيين المعلمات التي لم يتم تحديدها في عنوان URI لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. أنواع بيانات الاعتماد المدعومة: KeyCredential: للمصادقة المستندة إلى مفتاح واجهة برمجة التطبيقات. TokenCredential: للمصادقة المستندة إلى Microsoft Azure Active Directory. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز.
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، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد الكلام الممكن للتخزين الخاص بك (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

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

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[]

tokenCredential

يحصل على مثيل TokenCredential إذا تم تكوينه. متاح فقط في حالة استخدام المصادقة المستندة إلى AAD عبر TokenCredential.

undefined | TokenCredential tokenCredential

قيمة الخاصية

undefined | TokenCredential

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, KeyCredential | TokenCredential)

ينشئ مثيلا لتكوين ترجمة الكلام مع نقطة نهاية مخصصة وبيانات اعتماد. لا يتم تغيير معلمات الاستعلام المحددة في عنوان URI لنقطة النهاية، حتى إذا تم تعيينها بواسطة أي استدعاء واجهة برمجة تطبيقات آخر. على سبيل المثال، إذا تم تعريف لغة التعرف في معلمة استعلام URI على أنها "language=de-DE"، وتم تعيين الخاصية SpeechRecognitionLanguage إلى "en-US"، فإن اللغة المعينة في URI لها الأسبقية، وتظل "de-DE" هي اللغة المتوقعة. نظرا لأن المعلمات المضمنة في عنوان URI لنقطة النهاية لها الأولوية، يمكن تعيين المعلمات التي لم يتم تحديدها في عنوان URI لنقطة النهاية فقط بواسطة واجهات برمجة التطبيقات الأخرى. أنواع بيانات الاعتماد المدعومة:

• KeyCredential: للمصادقة المستندة إلى مفتاح واجهة برمجة التطبيقات.
• TokenCredential: للمصادقة المستندة إلى Microsoft Azure Active Directory. ملاحظة: لاستخدام رمز التخويل المميز مع fromEndpoint، مرر سلسلة فارغة إلى subscriptionKey في أسلوب fromEndpoint، ثم قم بتعيين authorizationToken="token" على مثيل SpeechConfig الذي تم إنشاؤه لاستخدام رمز التخويل المميز.

static function fromEndpoint(endpoint: URL, credential: KeyCredential | TokenCredential): SpeechTranslationConfig

المعلمات

endpoint

URL

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

credential

KeyCredential | TokenCredential

بيانات الاعتماد المستخدمة للمصادقة.

المرتجعات

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): SpeechTranslationConfig

المعلمات

hostName

URL

subscriptionKey

string

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

المرتجعات

SpeechTranslationConfig

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

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، أو في حساب التخزين الخاص بك المرتبط باشتراك الخدمات المعرفية (إنشاء مورد الكلام الممكن للتخزين الخاص بك (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