التشغيل السريع: تثبيت Speech SDK

الوثائق | المرجعيةحزمة (NuGet) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل C#‎.

متطلبات النظام الأساسي

Speech SDK ل C# متوافق مع Windows وLinux وmacOS.

بالنسبة لنظام التشغيل

في Windows، يجب استخدام بنية الهدف 64 بت. مطلوب Windows 10 أو إصدار أحدث.

قم بتثبيت Microsoft Visual C++ Redistributable ل Visual Studio 2015 و2017 و2019 و2022 للنظام الأساسي الخاص بك. قد يتطلب تثبيت هذه الحزمة للمرة الأولى إعادة تشغيل.

يدعم Speech SDK ل C# فقط التوزيعات التالية على بنى x64 و ARM32 و ARM64:

• Ubuntu 20.04/22.04/24.04
• دبيان 11/12
• Amazon Linux 2023
• Azure Linux 3.0

مهم

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL، الإصدار 1.x (libssl1) أو 3.x (libssl3)، والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

دبيان 11/12

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

شغَّل هذه الأوامر:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

شغَّل هذه الأوامر:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

مطلوب macOS بالإصدار 10.14 أو أحدث.

تثبيت Speech SDK ل C#‎

يتوفر Speech SDK ل C# كحزمة NuGet وينفذ .NET Standard 2.0. لمزيد من المعلومات، راجع Microsoft.CognitiveServices.Speech.

المحطه الطرفيه

يمكن تثبيت Speech SDK ل C# من .NET CLI باستخدام الأمر التالي dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

بوويرشيل

يمكن تثبيت Speech SDK ل C# باستخدام الأمر التالي Install-Package :

Install-Package Microsoft.CognitiveServices.Speech

الوثائق | المرجعيةحزمة (NuGet) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل C++‎.

متطلبات النظام الأساسي

Speech SDK ل C++ متوافق مع Windows وLinux وmacOS.

بالنسبة لنظام التشغيل

في Windows، يجب استخدام بنية الهدف 64 بت. مطلوب Windows 10 أو إصدار أحدث.

قم بتثبيت Microsoft Visual C++ Redistributable ل Visual Studio 2015 و2017 و2019 و2022 للنظام الأساسي الخاص بك. قد يتطلب تثبيت هذه الحزمة للمرة الأولى إعادة تشغيل.

يدعم Speech SDK ل C++ فقط التوزيعات التالية على بنى x64 وARM32 وARM64:

• Ubuntu 20.04/22.04/24.04
• دبيان 11/12
• Amazon Linux 2023
• Azure Linux 3.0

مهم

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL، الإصدار 1.x (libssl1) أو 3.x (libssl3)، والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

دبيان 11/12

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

شغَّل هذه الأوامر:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

شغَّل هذه الأوامر:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

مطلوب macOS بالإصدار 10.14 أو أحدث.

تثبيت Speech SDK ل C++‎

يتوفر Speech SDK ل C++ كحزمة NuGet. لمزيد من المعلومات، راجع Microsoft.CognitiveServices.Speech.

المحطه الطرفيه

يمكن تثبيت Speech SDK ل C++ من .NET CLI باستخدام الأمر التالي dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

بوويرشيل

يمكن تثبيت Speech SDK ل C++ باستخدام الأمر التالي Install-Package :

Install-Package Microsoft.CognitiveServices.Speech

يمكنك اتباع هذه الدلائل لمزيد من الخيارات.

يوضح هذا الدليل كيفية تثبيت Speech SDK لنظام Linux.

استخدم الإجراء التالي لتنزيل SDK وتثبيته. تتضمن الخطوات تنزيل المكتبات المطلوبة وملفات العنوان كملف .tar .

1. اختر دليلا لملفات Speech SDK. SPEECHSDK_ROOT تعيين متغير البيئة للإشارة إلى هذا الدليل. يسهل هذا المتغير الرجوع إلى الدليل في الأوامر المستقبلية.

   لاستخدام speechsdk الدليل في الدليل الرئيسي الخاص بك، قم بتشغيل الأمر التالي:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. إنشاء الدليل إذا لم يكن موجودا:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. قم بتنزيل واستخراج أرشيف .tar.gz الذي يحتوي على ثنائيات Speech SDK:

   wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary
   tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
   

4. التحقق من صحة محتويات دليل المستوى الأعلى للحزمة المستخرجة:

   ls -l "$SPEECHSDK_ROOT"
   

   يجب أن تحتوي قائمة الدليل على إشعارات الشريك وملفات الترخيص. يجب أن تحتوي القائمة أيضا على دليل تضمين يحتوي على ملفات العنوان (.h) ودليل lib الذي يحتوي على مكتبات ل arm32 و arm64 و x64 و x86.

   المسار	الوصف
   license.md	الترخيص
   ThirdPartyNotices.md	إشعارات الشريك
   REDIST.txt	إشعار إعادة التوزيع
   أدخل	ملفات الرأس المطلوبة ل C++‎
   lib/arm32	المكتبة الأصلية ل ARM32 المطلوبة لربط التطبيق الخاص بك
   lib/arm64	مكتبة أصلية ل ARM64 مطلوبة لربط التطبيق الخاص بك
   lib/x64	مكتبة أصلية للإصدار x64 مطلوبة لربط التطبيق الخاص بك
   lib/x86	مكتبة أصلية للإصدار x86 مطلوبة لربط تطبيقك

يوضح هذا الدليل كيفية تثبيت Speech SDK ل C++ على macOS 10.14 أو أحدث. تتضمن الخطوات تنزيل المكتبات المطلوبة وملفات العنوان كملف .zip .

1. اختر دليلا لملفات Speech SDK. SPEECHSDK_ROOT تعيين متغير البيئة للإشارة إلى هذا الدليل. يسهل هذا المتغير الرجوع إلى الدليل في الأوامر المستقبلية.

   لاستخدام speechsdk الدليل في الدليل الرئيسي الخاص بك، قم بتشغيل الأمر التالي:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. إنشاء الدليل إذا لم يكن موجودا:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. قم بتنزيل واستخراج أرشيف .zip الذي يحتوي على Speech SDK XCFramework:

   wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
   unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
   

4. التحقق من صحة محتويات دليل المستوى الأعلى للحزمة المستخرجة:

   ls -l "$SPEECHSDK_ROOT"
   

   يجب أن تحتوي قائمة الدليل على إشعار الشريك وملفات الترخيص ودليل MicrosoftCognitiveServicesSpeech.xcframework .

بالنسبة لنظام التشغيل

يوضح هذا الدليل كيفية تثبيت Speech SDK ل C++ على أنظمة تشغيل سطح مكتب Windows.

يتطلب دليل الإعداد هذا ما يلي:

• Microsoft Visual C++ Redistributable ل Visual Studio للنظام الأساسي ل Windows. قد يتطلب تثبيته للمرة الأولى إعادة تشغيل.
• Visual Studio.

إنشاء مشروع في Visual Studio وتثبيت Speech SDK

لإنشاء مشروع Visual Studio لتطوير سطح المكتب C++، تحتاج إلى:

• إعداد خيارات تطوير Visual Studio.
• إنشاء المشروع.
• حدد البنية الهدف.
• تثبيت Speech SDK.

إعداد خيارات تطوير Visual Studio

للبدء، تأكد من إعدادك بشكل صحيح في Visual Studio لتطوير سطح المكتب C++‎:

1. افتح Visual Studio 2019 لعرض نافذة البدء.

2. حدد Continue without code للانتقال إلى Visual Studio IDE.

   

3. من شريط القوائم Visual Studio، حدد أدوات>الحصول على الأدوات والميزات لفتح Visual Studio Installer وعرض مربع الحوار تعديل .

4. في علامة التبويب أحمال العمل ، ضمن Windows، ابحث عن تطوير سطح المكتب مع حمل عمل C++‎ . إذا لم يكن حمل العمل هذا محددا بالفعل، فحدده.

   

5. في علامة التبويب Individual components ، ابحث عن NuGet package manager. إذا لم يكن محددا بالفعل، فحدده.

6. حدد إغلاق أو تعديل. يختلف اسم الزر استنادا إلى ما إذا كنت قد حددت أي ميزات للتثبيت.

   إذا قمت بتحديد تعديل، يبدأ التثبيت. قد تستغرق العملية بعض الوقت.

7. أغلق Visual Studio Installer.

إنشاء مشروع

بعد ذلك، أنشئ مشروعك وحدد البنية الهدف:

1. من قائمة Visual Studio، حدد ملف>مشروع جديد> لعرض نافذة إنشاء مشروع جديد.

2. ابحث عن تطبيق وحدة التحكم وحدده. تأكد من تحديد إصدار C++ من نوع المشروع هذا، بدلا من C# أو Visual Basic.

3. حدد التالي.

   

4. في مربع الحوار تكوين مشروعك الجديد ، في اسم المشروع، أدخل helloworld.

5. في الموقع، انتقل إلى المجلد الذي تريد حفظ مشروعك فيه وحدده أو أنشئه، ثم حدد إنشاء.

   

6. حدد بنية النظام الأساسي المستهدف. في شريط أدوات Visual Studio، ابحث عن مربع القائمة المنسدلة Solution Platforms . إذا لم تتمكن من رؤيته، فحدد عرض>أشرطة> الأدواتالقياسية لعرض شريط الأدوات الذي يحتوي على الأنظمة الأساسية للحلول.

   إذا كنت تقوم بتشغيل Windows 64 بت، فحدد x64 في مربع القائمة المنسدلة. يمكن لنظام Windows 64 بت أيضا تشغيل تطبيقات 32 بت، بحيث يمكنك اختيار x86 إذا كنت تفضل ذلك.

تثبيت Speech SDK باستخدام Visual Studio

وأخيرا، قم بتثبيت حزمة Speech SDK NuGet والإشارة إلى Speech SDK في مشروعك:

1. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق الحل الخاص بك، ثم حدد إدارة حزم NuGet للحل للانتقال إلى نافذة NuGet - الحل .

2. حدد استعراض.

3. في مصدر الحزمة، حدد nuget.org.

   

4. في مربع البحث ، أدخل Microsoft.CognitiveServices.Speech. اختر هذه الحزمة بعد ظهورها في نتائج البحث.

5. في جزء حالة الحزمة بجوار نتائج البحث، حدد مشروع helloworld .

6. حدد تثبيت.

   

7. في مربع الحوار معاينة التغييرات ، حدد موافق.

8. في مربع الحوار قبول الترخيص ، اعرض الترخيص، ثم حدد قبول. يبدأ تثبيت الحزمة. عند اكتمال التثبيت، يعرض جزء الإخراج رسالة مشابهة للنص التالي: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.

الوثائق | المرجعيةالحزمة (Go) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Go.

متطلبات النظام الأساسي

يدعم Speech SDK for Go التوزيعات التالية على بنية x64:

• Ubuntu 20.04/22.04/24.04
• دبيان 11/12

مهم

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL، الإصدار 1.x (libssl1) أو 3.x (libssl3)، والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

دبيان 11/12

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

شغَّل هذه الأوامر:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

شغَّل هذه الأوامر:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

قم بتثبيت الإصدار الثنائي Go 1.13 أو أحدث.

تثبيت Speech SDK ل Go

استخدم الإجراء التالي لتنزيل SDK وتثبيته. تتضمن الخطوات تنزيل المكتبات المطلوبة وملفات العنوان كملف .tar .

1. اختر دليلا لملفات Speech SDK. SPEECHSDK_ROOT تعيين متغير البيئة للإشارة إلى هذا الدليل. يسهل هذا المتغير الرجوع إلى الدليل في الأوامر المستقبلية.

   لاستخدام speechsdk الدليل في الدليل الرئيسي الخاص بك، قم بتشغيل الأمر التالي:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. إنشاء الدليل إذا لم يكن موجودا:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. قم بتنزيل واستخراج أرشيف .tar.gz الذي يحتوي على ثنائيات Speech SDK:

   wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary
   tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
   

4. التحقق من صحة محتويات دليل المستوى الأعلى للحزمة المستخرجة:

   ls -l "$SPEECHSDK_ROOT"
   

   يجب أن تحتوي قائمة الدليل على إشعارات الشريك وملفات الترخيص. يجب أن تحتوي القائمة أيضا على دليل تضمين يحتوي على ملفات العنوان (.h) ودليل lib الذي يحتوي على مكتبات ل arm32 و arm64 و x64 و x86.

   المسار	الوصف
   license.md	الترخيص
   ThirdPartyNotices.md	إشعارات الشريك
   REDIST.txt	إشعار إعادة التوزيع
   أدخل	ملفات الرأس المطلوبة ل C++‎
   lib/arm32	المكتبة الأصلية ل ARM32 المطلوبة لربط التطبيق الخاص بك
   lib/arm64	مكتبة أصلية ل ARM64 مطلوبة لربط التطبيق الخاص بك
   lib/x64	مكتبة أصلية للإصدار x64 مطلوبة لربط التطبيق الخاص بك
   lib/x86	مكتبة أصلية للإصدار x86 مطلوبة لربط تطبيقك

تكوين بيئة Go

تمكن الخطوات التالية بيئة Go من العثور على Speech SDK.

1. نظرا لأن الروابط تعتمد على cgo، تحتاج إلى تعيين متغيرات البيئة حتى يتمكن Go من العثور على SDK.

   export CGO_CFLAGS="-I$SPEECHSDK_ROOT/include/c_api"
   export CGO_LDFLAGS="-L$SPEECHSDK_ROOT/lib/<architecture> -lMicrosoft.CognitiveServices.Speech.core"
   

   مهم

   استبدل <architecture> ببنية المعالج لوحدة المعالجة المركزية الخاصة بك: x64أو arm32أو .arm64

2. لتشغيل التطبيقات وSDK، تحتاج إلى إخبار نظام التشغيل بمكان العثور على المكتبات.

   export LD_LIBRARY_PATH="$SPEECHSDK_ROOT/lib/<architecture>:$LD_LIBRARY_PATH"
   

   مهم

   استبدل <architecture> ببنية المعالج لوحدة المعالجة المركزية الخاصة بك: x64أو arm32أو .arm64

الوثائق | المرجعيةعينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Java.

متطلبات النظام الأساسي

اختر البيئة المستهدفة:

وقت تشغيل Java

يتوافق Speech SDK لـ Java مع أنظمة التشغيل Windows وLinux وmacOS.

بالنسبة لنظام التشغيل

في Windows، يجب استخدام بنية الهدف 64 بت. مطلوب Windows 10 أو إصدار أحدث.

قم بتثبيت Microsoft Visual C++ Redistributable ل Visual Studio 2015 و2017 و2019 و2022 للنظام الأساسي الخاص بك. قد يتطلب تثبيت هذه الحزمة للمرة الأولى إعادة تشغيل.

لا يدعم Speech SDK ل Java Windows على ARM64.

يدعم Speech SDK ل Java التوزيعات التالية على بنيات x64 وARM32 وARM64:

• Ubuntu 20.04/22.04/24.04
• دبيان 11/12
• Amazon Linux 2023
• Azure Linux 3.0

مهم

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL، الإصدار 1.x (libssl1) أو 3.x (libssl3)، والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

دبيان 11/12

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

شغَّل هذه الأوامر:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

شغَّل هذه الأوامر:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

مطلوب macOS بالإصدار 10.14 أو أحدث.

الروبوت

يتوافق Speech SDK مع أجهزة Android التي تحتوي على معالج ARM 32/64 بت ومعالجات Intel x86/x64 المتوافقة.

تثبيت Java Development Kit مثل Azul Zulu OpenJDK. يجب أن يعمل Microsoft Build of OpenJDK أو JDK المفضل لديك أيضًا.

تثبيت SDK الكلام لـ Java

بعض الإرشادات تستخدم إصدار SDK معينًا مثل 1.43.0. للتحقق من أحدث إصدار، ابحث في مستودع GitHub.

اختر البيئة المستهدفة:

وقت تشغيل Java

هذا الدليل يوضح كيفية تثبيت Speech SDK لـ Java على Java Runtime.

أنظمة التشغيل المدعومة

تُتاح Speech SDK لحزمة Java لأنظمة التشغيل هذه:

• Windows: 64 بت فقط.
• Mac - macOS X الإصدار 10.14 أو أحدث.
• Linux: راجع توزيعات Linux المدعومة والبنى المستهدفة.

مخضرم

اتبع هذه الخطوات لتثبيت Speech SDK لـ Java باستخدام Apache Maven:

1. قم بتثبيت Apache Maven.

2. افتح موجه الأوامر حيث تريد المشروع الجديد، وأنشئ ملف pom.xml جديد.

3. انسخ محتوى XML التالي إلى pom.xml:

   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <groupId>com.microsoft.cognitiveservices.speech.samples</groupId>
       <artifactId>quickstart-eclipse</artifactId>
       <version>1.0.0-SNAPSHOT</version>
       <build>
           <sourceDirectory>src</sourceDirectory>
           <plugins>
           <plugin>
               <artifactId>maven-compiler-plugin</artifactId>
               <version>3.7.0</version>
               <configuration>
               <source>1.8</source>
               <target>1.8</target>
               </configuration>
           </plugin>
           </plugins>
       </build>
       <dependencies>
           <dependency>
           <groupId>com.microsoft.cognitiveservices.speech</groupId>
           <artifactId>client-sdk</artifactId>
           <version>1.43.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. يجب تشغيل أمر Maven التالي لتثبيت Speech SDK والتبعيات.

   mvn clean dependency:copy-dependencies
   

كسوف

إنشاء مشروع Eclipse وتثبيت Speech SDK

1. قم بتثبيت Eclipse Java IDE. يتطلب IDE هذا تثبيت Java بالفعل.

2. تشغيل Eclipse.

3. في Eclipse Launcher في المربع مساحة العمل، أدخل اسم دليل مساحة عمل جديد. ثم حدد تشغيل.

   

4. وفي لحظة، تظهر النافذة الرئيسية لـ Eclipse Launcher. أغلق شاشة الترحيب إذا كان أحد موجوداً.

5. من قائمة Eclipse، حدد File>>

6. يظهر مربع الحوار للمشروع الجديد. حدد مشروع Java، ثم حدد التالي.

   

7. يبدأ معالج المشروع الجديد لـ Java. في الحقل Project name، أدخِل quickstart. اختر JavaSE-1.8 لتكون بيئة التنفيذ. حدد إنهاء.

   

8. ماذا يحدث في حالةAssociated Perspective المفتوحة؟تظهر النافذة، وبعدها قم بتحديدOpen Perspective.

9. في Package explorer، اضغط بزر الماوس الأيمن فوق مشروع التشغيل السريع. حدد Configure>Convert to Maven Project من قائمة السياق.

   

10. تظهر نافذة إنشاء POM جديد. في حقل معرف المجموعة، أدخل com.microsoft.cognitiveservices.speech.samples. في الحقل Artifact Id، أدخل quickstart. ثم حدد إنهاء.

    

11. افتح ملف pom.xml ثم حرره:

    1. أضف عنصرا dependencies في نهاية الملف، قبل علامة </project>الإغلاق ، مع Speech SDK كتبعية:

    <dependencies>
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.43.0</version>
      </dependency>
    </dependencies>
    

    1. ا‏‏حفظ التغييرات.

جرادل

تكوينات Gradle

تتطلب تكوينات Gradle مرجعا صريحا إلى ملحق التبعية .jar :

// build.gradle

dependencies {
    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.43.0", ext: "jar"
}

الروبوت

يوضح هذا الدليل كيفية تثبيت Speech SDK لـ Java على Android.

يتم تجميع Speech SDK لنظام Android في حزمة ملف Android Archive (AAR)، والتي تتضمن المكتبات الضرورية وأذونات Android المطلوبة.

تثبيت Speech SDK باستخدام Android Studio

أنشئ مشروعًا جديدًا في Android Studio وإضافة Speech SDK ل Java كتبعية مكتبة. ويستند الإعداد على حزمة Speech SDK Maven، وAndroid Studio Chipmunk 2021.2.1.

إنشاء مشروع فارغ

1. افتح Android Studio وحدد New project.

   

2. في نافذة New project التي تظهر، حدد Phone and Tablet>Empty Activity، ثم حدد Next.

   

3. أدخل SpeechQuickstart في مربع النص Name.

   

4. أدخل samples.speech.cognitiveservices.microsoft.com في مربع النص Package name.

5. حدد دليل مشروع في مربع التحديد حفظ الموقع.

6. حدد Java في مربع التحديد Language.

7. حدد API 26: Android 8.0 (Oreo) في مربع تحديد الحد الأدنى لمستوى واجهة برمجة التطبيقات .

8. حدد إنهاء.

يستغرق Android Studio بعض الوقت لإعداد مشروعك الجديد. للمرة الأولى التي تستخدم فيها Android Studio، قد يستغرق الأمر بضع دقائق لتعيين التفضيلات وقبول التراخيص وإكمال المعالج.

تثبيت SDK الكلام لـ Java على Android

أضف Speech SDK كتبعية في مشروعك.

1. حدد File>Project structure>Dependencies>app.

2. حدد رمز الجمع (+) لإضافة تبعية ضمن Declared Dependencies. ثم حدد تبعية المكتبة من القائمة المنسدلة.

   

3. في نافذة Add Library Dependency التي تظهر، أدخل اسم وإصدار Speech SDK ل Java: com.microsoft.cognitiveservices.speech:client-sdk:1.43.0. ثم حدد بحث.

4. تأكد من أن Group ID المحدد هو com.microsoft.cognitiveservices.speech، ثم حدد OK.

5. حدد OK لإغلاق نافذة Project Structure وتطبيق تغييراتك على المشروع.

الوثائق | المرجعيةالحزمة (npm) | عينات إضافية على GitHub | التعليمات البرمجية المصدر للمكتبة

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل JavaScript.

يتوفر Speech SDK ل JavaScript كحزمة npm. راجع microsoft-cognitiveservices-speech-sdk ومستودع GitHub المصاحب له cognitive-services-speech-sdk-js.

متطلبات النظام الأساسي

فهم الآثار المعمارية بين متصفحات الويب Node.js والعميل. على سبيل المثال، نموذج عنصر المستند (DOM) غير متوفر للتطبيقات من جانب الخادم. نظام ملفاتNode.js غير متوفر للتطبيقات من جانب العميل.

تثبيت Speech SDK ل JavaScript

اعتمادا على البيئة المستهدفة، استخدم أحد الدلائل التالية:

Node.js

يوضح هذا الدليل كيفية تثبيت Speech SDK ل JavaScript للاستخدام مع Node.js.

1. تثبيت Node.js.

2. قم بإنشاء دليل جديد، وقم بتشغيل npm init، وتصفح المطالبات.

3. لتثبيت Speech SDK ل JavaScript، قم بتشغيل الأمر التالي npm install :

   npm install microsoft-cognitiveservices-speech-sdk
   

لمزيد من المعلومات، راجع عيناتNode.js.

مستند إلى المستعرض

يوضح هذا الدليل كيفية تثبيت Speech SDK ل JavaScript للاستخدام مع صفحة ويب.

فك حزمة إلى مجلد

1. إنشاء مجلد جديد فارغ. إذا كنت تريد استضافة العينة على خادم ويب، فتأكد من أن خادم الويب يمكنه الوصول إلى المجلد.

2. قم بتنزيل Speech SDK كحزمة.zip وقم بفكها في المجلد الذي تم إنشاؤه حديثا. يتم فك حزم هذه الملفات:

   • microsoft.cognitiveservices.speech.sdk.bundle.js: نسخة يمكن للبشر قراءتها من Speech SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.js.map: ملف خريطة لاستخدامه لتصحيح أخطاء التعليمات البرمجية ل SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.d.ts: تعريفات الكائنات لاستخدامها مع TypeScript.
   • microsoft.cognitiveservices.speech.sdk.bundle-min.js: إصدار تم تصغيره من Speech SDK.
   • speech-processor.js: تعليمات برمجية لتحسين الأداء على بعض المتصفحات.

3. أنشئ ملفا جديدا باسم index.html في المجلد، وافتح هذا الملف باستخدام محرر نص.

علامة البرنامج النصي HTML

قم بتنزيل واستخراج ملف microsoft.cognitiveservices.speech.sdk.bundle.js من Speech SDK ل JavaScript. ضعه في مجلد يمكن لملف HTML الوصول إليه.

<script src="microsoft.cognitiveservices.speech.sdk.bundle.js"></script>;

تلميح

إذا كنت تستهدف مستعرض ويب وتستخدم العلامة <script> ، فلن تكون هناك حاجة إلى البادئة sdk . البادئة sdk هي اسم مستعار يستخدم لتسمية الوحدة النمطية require .

بدلا من ذلك، يمكنك تضمين <script> علامة مباشرة في عنصر HTML <head> ، اعتمادا على JSDelivr.

<script src="https://cdn.jsdelivr.net/npm/microsoft-cognitiveservices-speech-sdk@latest/distrib/browser/microsoft.cognitiveservices.speech.sdk.bundle-min.js">
</script>

لمزيد من المعلومات، راجع العينات المستندة إلى المستعرض.

استخدام Speech SDK

• أضف عبارة الاستيراد التالية لاستخدام Speech SDK في مشروع JavaScript الخاص بك:

  import * as sdk from "microsoft-cognitiveservices-speech-sdk";
  

لمزيد من المعلومات حول import، راجع التصدير والاستيراد على موقع JavaScript على الويب.

بدلا من ذلك، يمكنك استخدام عبارة طلب:

const sdk = require("microsoft-cognitiveservices-speech-sdk");

الوثائق | المرجعيةحزمة (تنزيل) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Objective-C.

تلميح

لمزيد من المعلومات حول استخدام Speech SDK ل Swift، راجع استيراد Objective-C إلى Swift.

تثبيت Speech SDK ل Objective-C

الماك

يتوفر Speech SDK Objective-C في الأصل كحزمة CocoaPod للأنظمة المستندة إلى Mac x64 وARM.

متطلبات النظام لنظام التشغيل Mac:

• إصدار macOS 10.14 أو أحدث

تتوفر حزمة macOS CocoaPod للتنزيل والاستخدام مع Xcode 9.4.1 أو بيئة التطوير المتكاملة اللاحقة (IDE).

1. انتقل إلى دليل Xcode حيث يوجد ملف مشروع .xcodeproj .

2. قم بتشغيل pod init لإنشاء ملف pod يسمى Podfile.

3. استبدل محتويات Podfile بالمحتوى التالي. قم بتحديث target الاسم من AppName إلى اسم تطبيقك. تحديث النظام الأساسي أو إصدار الجراب حسب الحاجة.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0'
   end
   

4. قم بتشغيل pod install لتثبيت Speech SDK.

بدلا من ذلك، قم بتنزيل CocoaPod الثنائي واستخرج محتوياته. في مشروع Xcode، أضف مرجعا إلى مجلد MicrosoftCognitiveServicesSpeech.xcframework المستخرج ومحتوياته .

دائره الرقابه الداخليه

يتوفر Speech SDK Objective-C في الأصل كحزمة CocoaPod.

متطلبات النظام لنظام التشغيل iOS:

• إصدار macOS 10.14 أو أحدث
• هدف iOS 9.3 أو أحدث

تتوفر حزمة macOS CocoaPod للتنزيل والاستخدام مع Xcode 9.4.1 أو بيئة التطوير المتكاملة اللاحقة (IDE).

1. انتقل إلى دليل Xcode حيث يوجد ملف مشروع .xcodeproj .

2. قم بتشغيل pod init لإنشاء ملف pod يسمى Podfile.

3. استبدل محتويات Podfile بالمحتوى التالي. قم بتحديث target الاسم من AppName إلى اسم تطبيقك. تحديث النظام الأساسي أو إصدار الجراب حسب الحاجة.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.0'
   end
   

4. قم بتشغيل pod install لتثبيت Speech SDK.

بدلا من ذلك، قم بتنزيل CocoaPod الثنائي واستخرج محتوياته. في مشروع Xcode، أضف مرجعا إلى مجلد MicrosoftCognitiveServicesSpeech.xcframework المستخرج ومحتوياته .

الوثائق | المرجعيةحزمة (تنزيل) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Swift.

تلميح

لمزيد من المعلومات حول استخدام Speech SDK ل Swift، راجع استيراد Objective-C إلى Swift.

تثبيت Speech SDK ل Swift

الماك

يتوفر Speech SDK ل Swift في الأصل كحزمة CocoaPod للأنظمة المستندة إلى Mac x64 وARM.

متطلبات النظام لنظام التشغيل Mac:

• إصدار macOS 10.14 أو أحدث

تتوفر حزمة macOS CocoaPod للتنزيل والاستخدام مع Xcode 9.4.1 أو بيئة التطوير المتكاملة اللاحقة (IDE).

1. انتقل إلى دليل Xcode حيث يوجد ملف مشروع .xcodeproj .

2. قم بتشغيل pod init لإنشاء ملف pod يسمى Podfile.

3. استبدل محتويات Podfile بالمحتوى التالي. قم بتحديث target الاسم من AppName إلى اسم تطبيقك. تحديث النظام الأساسي أو إصدار الجراب حسب الحاجة.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0'
   end
   

4. قم بتشغيل pod install لتثبيت Speech SDK.

بدلا من ذلك، قم بتنزيل CocoaPod الثنائي واستخرج محتوياته. في مشروع Xcode، أضف مرجعا إلى مجلد MicrosoftCognitiveServicesSpeech.xcframework المستخرج ومحتوياته .

دائره الرقابه الداخليه

يتوفر Speech SDK ل Swift في الأصل كحزمة CocoaPod.

متطلبات النظام لنظام التشغيل iOS:

• إصدار macOS 10.14 أو أحدث
• هدف iOS 9.3 أو أحدث

تتوفر حزمة macOS CocoaPod للتنزيل والاستخدام مع Xcode 9.4.1 أو بيئة التطوير المتكاملة اللاحقة (IDE).

1. انتقل إلى دليل Xcode حيث يوجد ملف مشروع .xcodeproj .

2. قم بتشغيل pod init لإنشاء ملف pod يسمى Podfile.

3. استبدل محتويات Podfile بالآتي. قم بتحديث target الاسم من AppName إلى اسم تطبيقك. تحديث النظام الأساسي أو إصدار الجراب حسب الحاجة.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.0'
   end
   

4. قم بتشغيل pod install لتثبيت Speech SDK.

بدلا من ذلك، قم بتنزيل CocoaPod الثنائي واستخرج محتوياته. في مشروع Xcode، أضف مرجعا إلى مجلد MicrosoftCognitiveServicesSpeech.xcframework المستخرج ومحتوياته .

الوثائق | المرجعيةالحزمة (PyPi) | عينات إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Python.

متطلبات النظام الأساسي

Speech SDK ل Python متوافق مع Windows وLinux وmacOS.

بالنسبة لنظام التشغيل

في Windows، يجب استخدام بنية الهدف 64 بت. مطلوب Windows 10 أو إصدار أحدث.

قم بتثبيت Microsoft Visual C++ Redistributable ل Visual Studio 2015 و2017 و2019 و2022 للنظام الأساسي الخاص بك. قد يتطلب تثبيت هذه الحزمة للمرة الأولى إعادة تشغيل.

مهم

تأكد من تثبيت حزم من نفس البنية الهدف. على سبيل المثال، إذا قمت بتثبيت حزمة x64 القابلة لإعادة التوزيع، فقم بتثبيت حزمة x64 Python.

يدعم Speech SDK ل Python التوزيعات التالية على تصميمي x64 و ARM64:

• Ubuntu 20.04/22.04/24.04
• دبيان 11/12
• Amazon Linux 2023
• Azure Linux 3.0

مهم

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL، الإصدار 1.x (libssl1) أو 3.x (libssl3)، والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

دبيان 11/12

شغَّل هذه الأوامر:

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget

Amazon Linux 2023

شغَّل هذه الأوامر:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

شغَّل هذه الأوامر:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

مطلوب macOS بالإصدار 10.14 أو أحدث.

تثبيت إصدار من Python من 3.8 أو أحدث.

• للتحقق من التثبيت، افتح محطة طرفية وقم بتشغيل الأمر python --version. إذا تم تثبيت Python بشكل صحيح، فستحصل على استجابة مثل Python 3.8.10.

• إذا كنت تستخدم macOS أو Linux، فقد تحتاج إلى تشغيل الأمر python3 --version بدلا من ذلك.

  لتمكين استخدام بدلا من pythonpython3، قم بتشغيل alias python='python3' لإعداد اسم مستعار. تحدد python نماذج التشغيل السريع ل Speech SDK الاستخدام.

تثبيت Speech SDK ل Python

قبل تثبيت Speech SDK ل Python، تأكد من تلبية متطلبات النظام الأساسي.

PyPI

تثبيت من PyPI

لتثبيت Speech SDK ل Python، قم بتشغيل هذا الأمر في نافذة وحدة التحكم:

pip install azure-cognitiveservices-speech

الترقية إلى أحدث Speech SDK

للترقية إلى أحدث Speech SDK، قم بتشغيل هذا الأمر في نافذة وحدة التحكم:

pip install --upgrade azure-cognitiveservices-speech

يمكنك التحقق من Speech SDK لإصدار Python المثبت حاليا عن طريق فحص azure.cognitiveservices.speech.__version__ المتغير. على سبيل المثال، قم بتشغيل هذا الأمر في نافذة وحدة التحكم:

pip list

VS Code

تثبيت Speech SDK باستخدام Visual Studio Code

لتثبيت Speech SDK ل Python:

1. بادر بتنزيل Visual Studio Code وتثبيته.

2. تشغيل Visual Studio Code وتثبيت ملحق Python:

   1. > حددملحقات>.
   2. ابحث عن Python، وابحث عن ملحق Python ل Visual Studio Code الذي نشرته Microsoft، ثم حدد تثبيت.

   

3. حدد Terminal>New Terminal لفتح محطة طرفية داخل Visual Studio Code.

4. في موجه المحطة الطرفية، قم بتشغيل الأمر التالي لتثبيت Speech SDK لحزمة Python.

   python -m pip install azure-cognitiveservices-speech
   

لمزيد من المعلومات حول Visual Studio Code وPython، راجع Visual Studio Codeوبدء استخدام Python في VS Code.

استخدام Speech SDK

أضف عبارة الاستيراد التالية لاستخدام Speech SDK في مشروع Python الخاص بك:

import azure.cognitiveservices.speech as speechsdk

نماذج التعليمات البرمجية

تتوفر عينات متعمقة في مستودع Azure-Samples/cognitive-services-speech-sdk على GitHub. هناك نماذج ل C# (بما في ذلك UWP وUnity) وC++وJava وJavaScript (بما في ذلك المتصفح Node.js) و Objective-C و Python و Swift. تتوفر نماذج التعليمات البرمجية ل Go في مستودع Microsoft/cognitive-services-speech-sdk-go على GitHub.

المحتوى ذو الصلة

• التشغيل السريع لتحويل الكلام إلى نص
• التشغيل السريع لتحويل النص إلى كلام
• التشغيل السريع لترجمة الكلام