SpeechTranslationConfig الفصل

الفئة التي تحدد تكوينات الترجمة باستخدام إدخال الكلام.

يمكن تهيئة التكوين بطرق مختلفة:

  • من الاشتراك: تمرير مفتاح اشتراك ومنطقة

  • من نقطة النهاية: تمرير مفتاح اشتراك ونقطة نهاية

  • من المضيف: تمرير مفتاح اشتراك وعنوان مضيف

  • من رمز التخويل المميز: تمرير رمز التخويل المميز والمنطقة

توريث
SpeechTranslationConfig

الدالمنشئ

SpeechTranslationConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, target_languages: Iterable[str] = None, voice_name: str = '', speech_recognition_language: str = '')

المعلمات

الاسم الوصف
subscription

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

القيمة الافتراضية: None
region

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

القيمة الافتراضية: None
endpoint

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

القيمة الافتراضية: None
host

مضيف الخدمة للاتصال به. سيتم افتراض مسار المورد القياسي. التنسيق هو "protocol://host:port" حيث يكون ":p ort" اختياريا.

القيمة الافتراضية: None
auth_token

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

القيمة الافتراضية: None
speech_recognition_language
مطلوب

لغة الإدخال إلى التعرف على الكلام. يتم تحديد اللغة بتنسيق BCP-47.

target_languages

اللغات المستهدفة للترجمة.

القيمة الافتراضية: None
voice_name
مطلوب

الصوت الذي يجب استخدامه للإخراج المركب.

الأساليب

add_target_language

إضافة لغة إلى قائمة اللغات المستهدفة للترجمة.

enable_audio_logging

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

enable_dictation

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

get_property

احصل على خاصية حسب المعرف.

get_property_by_name

احصل على خاصية بالاسم.

remove_target_language

إزالة اللغة من قائمة اللغات المستهدفة للترجمة.

ملاحظة

تمت إضافته في الإصدار 1.7.0.

request_word_level_timestamps

يتضمن الطوابع الزمنية على مستوى الكلمات في نتيجة الاستجابة.

ملاحظة

تمت إضافته في الإصدار 1.5.0.

set_profanity

تعيين خيار الألفاظ النابية.

ملاحظة

تمت إضافته في الإصدار 1.5.0.

set_properties

تعيين خصائص متعددة حسب المعرف.

set_properties_by_name

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

set_property

تعيين خاصية حسب المعرف.

set_property_by_name

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

set_proxy

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

ملاحظة

وظيفة الوكيل غير متوفرة على macOS. لن يكون لهذه الدالة أي تأثير على

هذا النظام الأساسي.

set_service_property

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

set_speech_synthesis_output_format

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

add_target_language

إضافة لغة إلى قائمة اللغات المستهدفة للترجمة.

add_target_language(language: str)

المعلمات

الاسم الوصف
language
مطلوب

التعليمة البرمجية للغة المراد إضافتها.

enable_audio_logging

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

enable_audio_logging()

enable_dictation

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

enable_dictation()

get_property

احصل على خاصية حسب المعرف.

get_property(property_id: PropertyId) -> str

المعلمات

الاسم الوصف
property_id
مطلوب

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

المرتجعات

النوع الوصف

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

get_property_by_name

احصل على خاصية بالاسم.

get_property_by_name(property_name: str) -> str

المعلمات

الاسم الوصف
property_name
مطلوب

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

المرتجعات

النوع الوصف

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

remove_target_language

إزالة اللغة من قائمة اللغات المستهدفة للترجمة.

ملاحظة

تمت إضافته في الإصدار 1.7.0.

remove_target_language(language: str)

المعلمات

الاسم الوصف
language
مطلوب

التعليمة البرمجية للغة المراد إزالتها.

request_word_level_timestamps

يتضمن الطوابع الزمنية على مستوى الكلمات في نتيجة الاستجابة.

ملاحظة

تمت إضافته في الإصدار 1.5.0.

request_word_level_timestamps()

set_profanity

تعيين خيار الألفاظ النابية.

ملاحظة

تمت إضافته في الإصدار 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

المعلمات

الاسم الوصف
profanity_option
مطلوب

مستوى الألفاظ النابية المراد تعيينه.

set_properties

تعيين خصائص متعددة حسب المعرف.

set_properties(properties: Dict[PropertyId, str])

المعلمات

الاسم الوصف
properties
مطلوب

معرفات خاصية تعيين الإملاء إلى القيم التي سيتم تعيينها.

set_properties_by_name

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

set_properties_by_name(properties: Dict[str, str])

المعلمات

الاسم الوصف
properties
مطلوب

معرفات خاصية تعيين الإملاء إلى القيم التي سيتم تعيينها.

set_property

تعيين خاصية حسب المعرف.

set_property(property_id: PropertyId, value: str)

المعلمات

الاسم الوصف
property_id
مطلوب

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

value
مطلوب

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

set_property_by_name

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

set_property_by_name(property_name: str, value: str)

المعلمات

الاسم الوصف
property_name
مطلوب

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

value
مطلوب

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

set_proxy

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

ملاحظة

وظيفة الوكيل غير متوفرة على macOS. لن يكون لهذه الدالة أي تأثير على

هذا النظام الأساسي.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

المعلمات

الاسم الوصف
hostname
مطلوب

اسم المضيف للخادم الوكيل. لا تقم بإضافة معلومات البروتوكول (http) إلى اسم المضيف.

port
مطلوب

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

username

اسم المستخدم للخادم الوكيل.

القيمة الافتراضية: None
password

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

القيمة الافتراضية: None

set_service_property

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

ملاحظة

تمت إضافته في الإصدار 1.5.0.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

المعلمات

الاسم الوصف
name
مطلوب

اسم الخاصية.

value
مطلوب

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

channel
مطلوب

القناة المستخدمة لتمرير الخاصية المحددة إلى الخدمة.

set_speech_synthesis_output_format

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

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

المعلمات

الاسم الوصف
format_id
مطلوب

معرف تنسيق الصوت، على سبيل المثال Riff16Khz16BitMonoPcm.

السمات

authorization_token

الرمز المميز للتخويل الذي سيتم استخدامه للاتصال بالخدمة.

ملاحظة

يحتاج المتصل إلى التأكد من أن رمز التخويل المميز صالح. قبل

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

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

لن تنطبق قيمة الرمز المميز الجديدة على أدوات التعرف التي تم إنشاؤها بالفعل. من أجل

أدوات التعرف التي تم إنشاؤها من قبل، تحتاج إلى تعيين رمز التخويل المميز ل

أداة التعرف المقابلة لتحديث الرمز المميز. وإلا، ستواجه أدوات التعرف

أخطاء أثناء التعرف.

endpoint_id

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

output_format

تنسيق الإخراج (بسيط أو مفصل) لنتيجة التعرف على الكلام.

region

مفتاح المنطقة الذي تم استخدامه لإنشاء Recognizer.

speech_recognition_language

اسم اللغة المنطوقة التي سيتم التعرف عليها بتنسيق BCP-47.

speech_synthesis_language

احصل على لغة تركيب الكلام.

speech_synthesis_output_format_string

الحصول على سلسلة تنسيق صوت إخراج تركيب الكلام.

speech_synthesis_voice_name

احصل على اسم صوت تركيب الكلام.

subscription_key

مفتاح الاشتراك الذي تم استخدامه لإنشاء Recognizer.

target_languages

اللغات المستهدفة للترجمة.

voice_name

الصوت الذي يجب استخدامه للإخراج المركب.