التشغيل السريع: إعداد بيئة التطوير

  • مقالة
  • قراءة خلال 27 دقائق

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

يوضح هذا الدليل كيفية تثبيت حزمة SDK للكلام .NET Framework (Windows). إذا كنت لا تريد سوى اسم الحزمة لتبدأ بنفسك، فقم بتشغيل Install-Package Microsoft.CognitiveServices.Speech وحدة التحكم NuGet.

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

المتطلبات الأساسية

يتطلب هذا التشغيل السريع:

أنشئ مشروع Visual Studio، وتثبيت Speech SDK

تحتاج إلى تثبيت حزمة Speech SDK NuGet حتى تتمكن من الرجوع إليها في التعليمات البرمجية الخاصة بك. للقيام بذلك ، قد تحتاج أولا إلى إنشاء مشروع helloworld . إذا كان لديك بالفعل مشروع يتوفر به حمل عمل ⁧⁩ تطوير سطح مكتب .NET ⁧⁩، يمكنك استخدام هذا المشروع، والتخطي إلى ⁧⁩ استخدام NuGet Package Manager لتثبيت Speech SDK ⁧⁩.

إنشاء مشروع مرحبا العالم

  1. افتح Visual Studio 2019.

  2. من نافذة Start، اختر Create a new project.

  3. في نافذة ⁧⁩Create a new project⁧⁩، اختر⁧⁩ Console App (.NET Framework)⁧⁩، ثم حدد ⁧⁩Next⁧⁩.

  4. في نافذة ⁧⁩Configure your new project⁧⁩، أدخل ⁧⁩ helloworld ⁧⁩ في ⁧⁩Project name⁧⁩، واختر مسار الدليل، أو أنشئه في ⁧⁩ Location⁧⁩ ، ثم حدد ⁧⁩Create⁧⁩.

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

  6. تحقق مما إذا كان حمل عمل ⁧⁩.NET desktop development ⁧⁩ متاحًا. إذا لم يتم تثبيت حمل العمل، فحدد مربع الاختيار المجاور له، ثم حدد⁧⁩Modify⁧⁩ لبدء التثبيت. قد يستغرق التنزيل والتثبيت بضع دقائق.

    إذا كانت خانة الاختيار الموجودة بجوار تطوير سطح المكتب.NET محددة بالفعل، فحدد إغلاق لإغلاق مربع الحوار.

    Screenshot that shows enabling .NET desktop development.

  7. أغلق Visual Studio Installer.

استخدم NuGet Package Manager لتثبيت Speech SDK

  1. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق مشروع helloworld، ثم حدد إدارة حزم NuGet لإظهار NuGet مدير الحِزَم.

  2. في الزاوية العلوية اليسرى، ابحث عن المربع المنسدل مصدر الحزمة ، وتأكد من تحديد nuget.org .

    Screenshot that shows NuGet Package Manager.

  3. في الزاوية العلوية اليمنى، حدد⁧⁩ Browse⁧⁩.

  4. في مربع البحث، اكتب⁧⁩ Microsoft.CognitiveServices.Speech⁧⁩ وحدد⁧⁩Enter⁧⁩.

  5. من نتائج البحث، حدد حزمة⁧⁩ Microsoft.CognitiveServices.Speech ⁧⁩، ثم حدد⁧⁩Install⁧⁩ لتثبيت أحدث إصدار ثابت.

    Screenshot that shows installing the Microsoft.CognitiveServices.Speech NuGet package.

  6. اقبل جميع الاتفاقيات والتراخيص لبدء التثبيت.

    بعد تثبيت الحزمة، يظهر تأكيد في نافذة⁧⁩Package Manager Console⁧⁩.

اختيار بنية الهدف

لإنشاء تطبيق وحدة التحكم وتشغيله، قم بإنشاء تكوين نظام أساسي يطابق بنية الكمبيوتر.

  1. من شريط القائمة، حدد⁧⁩ Build⁧⁩⁧>⁩⁧⁩Configuration Manager⁧⁩. يظهر مربع الحوار Configuration Manager.

  2. في المربع المنسدل ⁧⁩Active solution platform⁧⁩، حدد ⁧⁩New⁧⁩. يظهر مربع الحوار "النظام الأساسي للحلول الجديدة ".

    Screenshot that shows the Configuration Manager dialog.

  3. في المربع المنسدل⁧⁩Type or select the new platform⁧⁩:

    • إذا كنت تقوم بتشغيل Windows 64 بت، فحدد⁧⁩ x64⁧⁩.
    • إذا كنت تقوم بتشغيل Windows 32 بت، فحدد⁧⁩ x86 ⁧⁩.

  4. حدد ⁧⁩OK⁧⁩، ثم ⁧⁩Close⁧⁩.

الخطوات التالية

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

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

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

متطلبات النظام

راجع متطلبات النظام وإرشادات الإعداد لنظام التشغيل Linux.

تثبيت Speech SDK

استخدم الإجراء التالي لتنزيل SDK وتثبيته. تتضمن الخطوات تنزيل المكتبات المطلوبة وملفات الرأس كملف .tar من https://aka.ms/csspeech/linuxbinary.

  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"

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

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

الخطوات التالية

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

يوضح هذا الدليل كيفية تثبيت Speech SDK ل Java. إذا كنت لا تريد سوى اسم الحزمة للبدء بنفسك، فإن Java SDK غير متوفر في مستودع Maven المركزي. سواء كنت تستخدم Gradle أو ملف تبعية pom.xml، فأنت بحاجة إلى إضافة مستودع مخصص يشير إلى https://azureai.azureedge.net/maven/. (انظر أدناه للاطلاع على اسم الحزمة.)

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

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

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

المتطلبات الأساسية

تكوينات غرادل

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

// build.gradle

repositories {
    maven {
        url "https://azureai.azureedge.net/maven/"
    }
}

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

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

  1. بدء Eclipse.

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

    Screenshot of Eclipse Launcher.

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

  4. من شريط القوائم Eclipse، قم بإنشاء مشروع جديد عن طريق تحديد FileNew>>Project.

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

    Screenshot of the New Project dialog, with Java Project highlighted.

  6. يبدأ معالج المشروع الجديد لـ Java. في حقل اسم Project، أدخل مفتاح التشغيل السريع. اختر JavaSE-1.8 كبيئة التنفيذ. اختر ⁧⁩إنهاء⁧⁩.

    Screenshot of the New Java Project wizard, with selections for creating a Java project.

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

  8. في " مستكشف الحزمة"، انقر بزر الماوس الأيمن فوق مشروع التشغيل السريع . حدد ConfigureConvert>إلى Maven Project من القائمة المختصرة.

    Screenshot of Package Explorer and the commands for converting to a Maven project.

  9. تظهر نافذة إنشاء POM جديد. في الحقل "معرف المجموعة"، أدخل com.microsoft.cognitiveservices.speech.samples. في الحقل "معرف القطع الأثرية "، أدخل "التشغيل السريع". ثم حدد إنهاء.

    Screenshot of the window for creating a new POM.

  10. افتح ملف pom.xml وقم بتحريره:

    • في نهاية الملف ، قبل علامة </project>الإغلاق ، قم بإنشاء repositories عنصر بالإشارة إلى مستودع Maven ل Speech SDK:

      <repositories>
  <repository>
    <id>maven-cognitiveservices-speech</id>
    <name>Microsoft Cognitive Services Speech Maven Repository</name>
    <url>https://csspeechstorage.blob.core.windows.net/maven/</url>
  </repository>
</repositories>

    • dependencies إضافة عنصر، باستخدام الإصدار 1.21.0 من Speech SDK كتبعية:

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

    • حفظ التغييرات.

الخطوات التالية

يوضح هذا الدليل كيفية تثبيت Speech SDK الخاصة بـ Python. إذا كنت لا تريد سوى اسم الحزمة لتبدأ بنفسك، فقم بتشغيل pip install azure-cognitiveservices-speech.

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

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

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

المتطلبات الأساسية

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

هام

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

تثبيت Speech SDK من PyPI

تتوفر حزمة SDK للكلام Python كوحدة نمطية لفهرس حزمة Python (PyPI). لمزيد من المعلومات، راجع azure-cognitiveservices-speech . تتوافق حزمة تطوير البرامج Python Speech SDK مع Windows وLinux وmacOS. قم بتثبيت إصدار من Python من 3.7 إلى 3.10.

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

لتثبيت حزمة SDK للكلام، قم بتشغيل هذا الأمر في محطة طرفية.

pip install azure-cognitiveservices-speech

إذا كنت تعمل على macOS وواجهت مشكلات في التثبيت، فقد تحتاج إلى تشغيل هذا الأمر أولاً.

python3 -m pip install --upgrade pip

يمكنك الآن استيراد Speech SDK إلى مشروع Python الخاص بك.

import azure.cognitiveservices.speech as speechsdk

تثبيت "حزمة SDK الكلام" باستخدام "التعليمات البرمجية Visual Studio"

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

  1. تنزيل ⁧⁩Visual Studio Code⁧⁩ وتثبيته.

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

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

    Screenshot that shows selections for installing the Python extension.

  3. حدد TerminalNew>Terminal لفتح محطة طرفية ضمن رمز Visual Studio.

  4. في موجه المحطة الطرفية، قم بتشغيل الأمر python -m pip install azure-cognitiveservices-speech لتثبيت حزمة Speech SDK Python.

لمزيد من المعلومات حول Visual Studio Code و Python، راجع وثائق رمز Visual Studio والبرنامج التعليمي Visual Studio Code Python.

الدعم والتحديثات

يتم توزيع تحديثات حزمة Python Speech SDK عبر PyPI ويتم الإعلان عنها في ملاحظات الإصدار.

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

pip install --upgrade azure-cognitiveservices-speech

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

pip list

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

الخطوات التالية

يوضح هذا الدليل كيفية تثبيت Speech SDK for Go على Linux.

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

متطلبات النظام

قبل تثبيت Speech SDK for Go، تحتاج إلى:

تثبيت Speech SDK

استخدم الإجراء التالي لتنزيل SDK وتثبيته. تتضمن الخطوات تنزيل المكتبات المطلوبة وملفات الرأس كملف .tar من https://aka.ms/csspeech/linuxbinary.

  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"

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

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

تكوين بيئة Go

تمكن الخطوات التالية بيئة Go من العثور على حزمة SDK للكلام. في كلتا الخطوتين، استبدل <architecture> ببنية المعالج لوحدة المعالجة المركزية الخاصة بك. وسيؤدي ذلك إلى x86 أو x64 أو arm32 أو arm64.

  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"

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

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

الخطوات التالية

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

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

هام

عن طريق تنزيل أي من حزم SDK الخاصة Azure Cognitive Services Speech، فإنك تقر بترخيصها. لمزيد من المعلومات، راجع:

إنشاء مجلد

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

فك حزم حزمة SDK الكلام لجافا سكريبت في المجلد الجديد

حمل 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: نسخة مصغرة من SDK الكلام.
  • speech-processor.js: رمز لتحسين الأداء على بعض المتصفحات.

أنشئ صفحة index.html

قم بإنشاء ملف جديد باسم index.html في المجلد، وافتح هذا الملف باستخدام محرر نصوص.

الخطوات التالية