مشاركة عبر

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

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

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

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

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

في Windows، يجب استخدام بنية الهدف 64 بت. ويندوز 11 أو أحدثه مطلوب.

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

تثبيت 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

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

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

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

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

في Windows، يجب استخدام بنية الهدف 64 بت. ويندوز 11 أو أحدثه مطلوب.

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

تثبيت 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 لنظام 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"

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

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

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

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

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

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

  • أوبونتو 20.04 / 22.04 / 24.04
  • دبيان 11/12

Important

استخدم أحدث إصدار 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).

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

sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev 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"

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

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

تكوين بيئة 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"

    Important

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

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

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

    Important

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

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

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

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

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

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

في Windows، يجب استخدام بنية الهدف 64 بت. ويندوز 11 أو أحدثه مطلوب.

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

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

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

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

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

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

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

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

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

اتبع هذه الخطوات لتثبيت 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

الوثائق | المرجعيةالحزمة (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

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

يوضح هذا الدليل كيفية تثبيت 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

  • أضف عبارة الاستيراد التالية لاستخدام 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.

Tip

لمزيد من المعلومات حول استخدام 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 المستخرج ومحتوياته .

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

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

Tip

لمزيد من المعلومات حول استخدام 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 المستخرج ومحتوياته .

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

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

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

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

في Windows، يجب استخدام بنية الهدف 64 بت. ويندوز 11 أو أحدثه مطلوب.

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

Important

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

تثبيت إصدار من 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

لتثبيت 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

استخدام Speech SDK

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

import azure.cognitiveservices.speech as speechsdk

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

تتوفر نماذج التعليمات البرمجية في مستودع Azure-Samples/cognitive-services-speech-sdk على GitHub. هناك عينات ل C# (بما في ذلك منصة ويندوز العالمية (UWP))، ++C، جافا، جافا سكريبت (بما في ذلك المتصفح وNode.js)، أوبجتيكيت-سي، بايثون، وسويفت. تتوفر نماذج التعليمات البرمجية ل Go في مستودع Microsoft/cognitive-services-speech-sdk-go على GitHub.

محتوى ذو صلة

  • Last updated on