Rövid útmutató: A Speech SDK telepítése

  • Cikk

Referenciadokumentáció-csomag (NuGet) | További minták a GitHubon |

Ebben a rövid útmutatóban a C#-hoz készült Speech SDK-t telepíti.

A dokumentációban szereplő kódminták c# 8-ban vannak megírva, és a .NET standard 2.0-s verzióján futnak.

Platformkövetelmények

A C#-hoz készült Speech SDK kompatibilis a Windows, Linux és macOS rendszerrel.

Figyelemfelhívás

Ez a cikk a CentOS-ra, egy olyan Linux-disztribúcióra hivatkozik, amely közel áll az élettartam (EOL) állapotához. Ennek megfelelően fontolja meg a használatot és a tervezést. További információ: CentOS End Of Life útmutató.

Windows rendszeren a 64 bites célarchitektúrát kell használnia. Windows 10 vagy újabb rendszerre van szükség.

Telepítse a Visual Studio 2015, 2017, 2019 és 2022 Microsoft Visual C++ terjeszthető verzióját a platformhoz. A csomag első telepítése újraindítást igényelhet.

A Speech SDK telepítése c-hez#

A Speech SDK for C# NuGet-csomagként érhető el, és a .NET Standard 2.0-t implementálja. További információ: Microsoft.CognitiveServices.Speech.

A Speech SDK for C# a .NET CLI-ről telepíthető a következő dotnet add paranccsal:

dotnet add package Microsoft.CognitiveServices.Speech

További lehetőségekért kövesse ezeket az útmutatókat.

Ez az útmutató bemutatja, hogyan telepítheti a Speech SDK-t egy .NET-keretrendszer (Windows) konzolalkalmazáshoz.

Ehhez az útmutatóhoz a következőre van szükség:

Visual Studio-projekt létrehozása és a Speech SDK telepítése

Telepítenie kell a Speech SDK NuGet-csomagot , hogy hivatkozhass rá a kódban. Ehhez először létre kell hoznia egy helloworld-projektet . Ha már rendelkezik .NET asztali fejlesztési számítási feladattal rendelkező projekttel, használhatja ezt a projektet, és a Speech SDK telepítéséhez ugorjon a NuGet Csomagkezelő használatára.

Helloworld-projekt létrehozása

  1. Nyissa meg a Visual Studiót.

  2. Az Első lépések csoportban válassza az Új projekt létrehozása lehetőséget.

  3. Az Új projekt létrehozása területen válassza a Konzolalkalmazás (.NET-keretrendszer) lehetőséget, majd válassza a Tovább gombot.

  4. Az új projekt konfigurálásakor a Projekt neve mezőben adja meg a helloworld nevet, válassza ki vagy hozza létre a címtár elérési útját a Hely területen, majd válassza a Létrehozás lehetőséget.

  5. A Visual Studio menüsávon válassza az Eszközök lekérése>eszközök és szolgáltatások lehetőséget. Ez a lépés megnyitja a Visual Studio Installert, és megjeleníti a Módosítás párbeszédpanelt .

  6. Ellenőrizze, hogy elérhető-e a .NET asztali fejlesztési számítási feladat. Ha a számítási feladat nincs telepítve, jelölje ki, majd válassza a Módosítás lehetőséget a telepítés elindításához. A letöltés és a telepítés eltarthat néhány percig.

    Ha a .NET asztali fejlesztése már be van jelölve, a párbeszédpanel bezárásához kattintson a Bezárás gombra.

    Képernyőkép a .NET asztali fejlesztésének engedélyezéséről.

  7. Zárja be a Visual Studio Installert.

A Speech SDK telepítéséhez használja a NuGet Csomagkezelő

  1. A Megoldáskezelő kattintson a jobb gombbal a helloworld projektre, majd válassza a NuGet-csomagok kezelése lehetőséget a NuGet-Csomagkezelő megjelenítéséhez.

  2. A jobb felső sarokban keresse meg a Csomagforrás legördülő menüt, és győződjön meg arról, hogy a nuget.org ki van jelölve.

    A NuGet Csomagkezelő ábrázoló képernyőkép.

  3. A bal felső sarokban válassza a Tallózás lehetőséget.

  4. A keresőmezőbe írja be a Microsoft.CognitiveServices.Speech kifejezést, és válassza az Enter lehetőséget.

  5. A keresési eredmények között válassza a Microsoft.CognitiveServices.Speech csomagot, majd a Telepítés lehetőséget a legújabb stabil verzió telepítéséhez.

    Képernyőkép a Microsoft.CognitiveServices.Speech NuGet-csomag telepítéséről.

  6. A telepítés megkezdéséhez fogadja el az összes szerződést és licencet.

    A csomag telepítése után megjelenik egy megerősítés a Csomagkezelő konzolablakban.

Célarchitektúra kiválasztása

A konzolalkalmazás létrehozásához és futtatásához hozzon létre egy platformkonfigurációt, amely megfelel a számítógép architektúrájának.

  1. A menüben válassza a Build>Configuration Manager lehetőséget. Megnyílik a Configuration Manager párbeszédpanel.

  2. Az Aktív megoldás platform legördülő listájában válassza az Új lehetőséget. Megjelenik az Új megoldásplatform párbeszédpanel.

    Képernyőkép a Configuration Manager párbeszédpanelről.

  3. A Típus vagy az új platform legördülő listából válassza a következőt:

    • Ha 64 bites Windowst futtat, válassza az x64 lehetőséget.
    • Ha 32 bites Windowst futtat, válassza az x86 lehetőséget.

  4. Kattintson az OK gombra , majd a Bezárás gombra.

Referenciadokumentáció-csomag (NuGet) | További minták a GitHubon |

Ebben a rövid útmutatóban a C++-hoz készült Speech SDK-t telepíti.

Platformkövetelmények

A C++-hoz készült Speech SDK kompatibilis a Windows, Linux és macOS rendszerrel.

Windows rendszeren a 64 bites célarchitektúrát kell használnia. Windows 10 vagy újabb rendszerre van szükség.

Telepítse a Visual Studio 2015, 2017, 2019 és 2022 Microsoft Visual C++ terjeszthető verzióját a platformhoz. A csomag első telepítése újraindítást igényelhet.

A Speech SDK telepítése c++ nyelven

A Speech SDK for C++ NuGet-csomagként érhető el. További információ: Microsoft.CognitiveServices.Speech.

A Speech SDK for C++ a .NET CLI-ről telepíthető a következő dotnet add paranccsal:

dotnet add package Microsoft.CognitiveServices.Speech

További lehetőségekért kövesse ezeket az útmutatókat.

Ez az útmutató bemutatja, hogyan telepítheti a Linuxhoz készült Speech SDK-t .

Az SDK letöltéséhez és telepítéséhez kövesse az alábbi eljárást. A lépések közé tartozik a szükséges kódtárak és fejlécfájlok letöltése .tar fájlként.

  1. Válasszon egy könyvtárat a Speech SDK-fájlokhoz. Állítsa a környezeti változót arra a SPEECHSDK_ROOT könyvtárra. Ez a változó megkönnyíti, hogy a későbbi parancsokban a könyvtárra hivatkozzon.

    A címtár speechsdkjének a kezdőkönyvtárban való használatához futtassa a következő parancsot:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Hozza létre a könyvtárat, ha nem létezik:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Töltse le és bontsa ki a Speech SDK bináris fájljait tartalmazó .tar.gz archívumot:

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

  4. Ellenőrizze a kibontott csomag legfelső szintű könyvtárának tartalmát:

    ls -l "$SPEECHSDK_ROOT"

    A címtárlistának tartalmaznia kell a partneri értesítéseket és a licencfájlokat. A listaelemnek tartalmaznia kell egy fejlécfájlokat (.h) tartalmazó könyvtárat, valamint egy olyan könyvtárat is, amely arm32, arm64, x64 és x86 kódtárakat tartalmaz.

    Elérési út Leírás
    license.md Licenc
    ThirdPartyNotices.md Partneri közlemények
    REDIST.txt Újraterjesztési értesítés
    Tartalmaz A C++-hoz szükséges fejlécfájlok
    lib/arm32 Natív arm32-kódtár szükséges az alkalmazás összekapcsolásához
    lib/arm64 Az alkalmazás összekapcsolásához natív ARM64-kódtár szükséges
    lib/x64 Az alkalmazás csatlakoztatásához szükséges x64 natív könyvtár
    lib/x86 Az alkalmazás csatlakoztatásához szükséges x86 natív könyvtár

Referenciadokumentáció csomag (Go) | További minták a GitHubon |

Ebben a rövid útmutatóban telepíti a Speech SDK for Go eszközt.

Platformkövetelmények

Figyelemfelhívás

Ez a cikk a CentOS-ra, egy olyan Linux-disztribúcióra hivatkozik, amely közel áll az élettartam (EOL) állapotához. Ennek megfelelően fontolja meg a használatot és a tervezést. További információ: CentOS End Of Life útmutató.

A Speech SDK for Go az alábbi disztribúciókat támogatja az x64 architektúrában:

  • Ubuntu 18.04/20.04
  • Debian 9/10/11
  • Red Hat Enterprise Linux (RHEL) 8
  • CentOS 7

Fontos

Használja a Linux-disztribúció legújabb LTS-kiadását. Ha például az Ubuntu 20.04 LTS-t használja, használja az Ubuntu 20.04.X legújabb kiadását.

A Speech SDK a következő Linux-rendszerkódtáraktól függ:

  • A GNU C-kódtár megosztott kódtárai, beleértve a POSIX Threads Programozási könyvtárat is. libpthreads
  • Az OpenSSL-kódtár (libssl) 1.x-es verziója és a tanúsítványok (ca-certificates).
  • Az ALSA-alkalmazások megosztott kódtára (libasound).

A biztonságos websocket létrehozásához és a hiba elkerüléséhez telepítenie ca-certificates kell a telepítést WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED is.

Fontos

A Speech SDK még nem támogatja az OpenSSL 3.0-t, amely az alapértelmezett az Ubuntu 22.04-ben és a Debian 12-ben.

Futtassa a következő parancsokat:

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

Telepítse a Go bináris 1.13-es vagy újabb verzióját.

A Speech SDK for Go telepítése

Az SDK letöltéséhez és telepítéséhez kövesse az alábbi eljárást. A lépések közé tartozik a szükséges kódtárak és fejlécfájlok letöltése .tar fájlként.

  1. Válasszon egy könyvtárat a Speech SDK-fájlokhoz. Állítsa a környezeti változót arra a SPEECHSDK_ROOT könyvtárra. Ez a változó megkönnyíti, hogy a későbbi parancsokban a könyvtárra hivatkozzon.

    A címtár speechsdkjének a kezdőkönyvtárban való használatához futtassa a következő parancsot:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Hozza létre a könyvtárat, ha nem létezik:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Töltse le és bontsa ki a Speech SDK bináris fájljait tartalmazó .tar.gz archívumot:

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

  4. Ellenőrizze a kibontott csomag legfelső szintű könyvtárának tartalmát:

    ls -l "$SPEECHSDK_ROOT"

    A címtárlistának tartalmaznia kell a partneri értesítéseket és a licencfájlokat. A listaelemnek tartalmaznia kell egy fejlécfájlokat (.h) tartalmazó könyvtárat, valamint egy olyan könyvtárat is, amely arm32, arm64, x64 és x86 kódtárakat tartalmaz.

    Elérési út Leírás
    license.md Licenc
    ThirdPartyNotices.md Partneri közlemények
    REDIST.txt Újraterjesztési értesítés
    Tartalmaz A C++-hoz szükséges fejlécfájlok
    lib/arm32 Natív arm32-kódtár szükséges az alkalmazás összekapcsolásához
    lib/arm64 Az alkalmazás összekapcsolásához natív ARM64-kódtár szükséges
    lib/x64 Az alkalmazás csatlakoztatásához szükséges x64 natív könyvtár
    lib/x86 Az alkalmazás csatlakoztatásához szükséges x86 natív könyvtár

A Go-környezet konfigurálása

Az alábbi lépések lehetővé teszik, hogy a Go-környezet megkeresse a Speech SDK-t.

  1. Mivel a kötések támaszkodnak cgo, be kell állítania a környezeti változókat, hogy a Go megtalálja az SDK-t.

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

    Fontos

    Cserélje le <architecture> a processzor processzorarchitektúrájára: x86, x64, arm32vagy arm64.

  2. Az alkalmazások és az SDK futtatásához meg kell adnia az operációs rendszernek, hogy hol találhatók a kódtárak.

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

    Fontos

    Cserélje le <architecture> a processzor processzorarchitektúrájára: x86, x64, arm32vagy arm64.

Referenciadokumentáció | – További minták a GitHubon

Ebben a rövid útmutatóban telepíti a Java Speech SDK-t .

Platformkövetelmények

Válassza ki a célkörnyezetet:

A Java Speech SDK kompatibilis a Windows, a Linux és a macOS rendszerrel.

Windows rendszeren a 64 bites célarchitektúrát kell használnia. Windows 10 vagy újabb rendszerre van szükség.

Telepítse a Visual Studio 2015, 2017, 2019 és 2022 Microsoft Visual C++ terjeszthető verzióját a platformhoz. A csomag első telepítése újraindítást igényelhet.

A Java Speech SDK nem támogatja az ARM64-alapú Windowst.

Telepítsen egy Java-fejlesztőkészletet, például az Azul Zulu OpenJDK-t. Az OpenJDK Microsoft buildjének vagy az előnyben részesített JDK-nak is működnie kell.

A Java Speech SDK telepítése

Egyes utasítások egy adott SDK-verziót használnak, például 1.24.2. A legújabb verzió ellenőrzéséhez keresse meg a GitHub-adattárat.

Válassza ki a célkörnyezetet:

Ez az útmutató bemutatja, hogyan telepítheti a Java Speech SDK-t a Java-futtatókörnyezetre.

Támogatott operációs rendszerek

A Java-hoz készült Speech SDK csomag az alábbi operációs rendszerekhez érhető el:

A Java Speech SDK Apache Maven használatával történő telepítéséhez kövesse az alábbi lépéseket:

  1. Telepítse az Apache Maven-t.

  2. Nyisson meg egy parancssort, ahol az új projektet szeretné, és hozzon létre egy új pom.xml fájlt.

  3. Másolja a következő XML-tartalmat a 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.37.0</version>
        </dependency>
    </dependencies>
</project>

  4. Futtassa a következő Maven-parancsot a Speech SDK és a függőségek telepítéséhez.

    mvn clean dependency:copy-dependencies

Referenciadokumentáció csomag (npm) | További minták a GitHub | Library forráskódján |

Ebben a rövid útmutatóban telepíti a JavaScripthez készült Speech SDK-t .

A JavaScripthez készült Speech SDK npm-csomagként érhető el. Lásd: microsoft-cognitiveservices-speech-sdk és a hozzá tartozó GitHub-adattár cognitive-services-speech-sdk-js.

Platformkövetelmények

Ismerje meg a Node.js és az ügyfél webböngészők közötti architekturális következményeket. A dokumentumobjektum-modell (DOM) például nem érhető el kiszolgálóoldali alkalmazásokhoz. A Node.js fájlrendszer nem érhető el az ügyféloldali alkalmazások számára.

A JavaScripthez készült Speech SDK telepítése

A célkörnyezettől függően használja az alábbi útmutatók egyikét:

Ez az útmutató bemutatja, hogyan telepítheti a JavaScripthez készült Speech SDK-t a Node.js való használatra.

  1. A Node.js telepítése.

  2. Hozzon létre egy új könyvtárat, futtassa npm init, és haladjon végig az utasításokat.

  3. A JavaScripthez készült Speech SDK telepítéséhez futtassa a következő npm install parancsot:

    npm install microsoft-cognitiveservices-speech-sdk

További információ: Node.js minták.

A Speech SDK használata

  • Adja hozzá a következő importálási utasítást a Speech SDK JavaScript-projektben való használatához:

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

További információ: importExportálás és importálás a JavaScript webhelyén.

Másik lehetőségként szükségutasítást is használhat:

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

Referenciadokumentáció csomag (Letöltés) | További minták a GitHubon |

Ebben a rövid útmutatóban telepíti a Speech SDK for Objective-C eszközt.

Tipp.

További információ a Speech SDK swifthez való használatáról: Objective-C importálása Swiftbe.

A Speech SDK telepítése Objective-C-hez

Az Objective-C-hez készült Speech SDK natív módon elérhető a Mac x64 és ARM-alapú rendszerekhez készült CocoaPod-csomagként.

A Mac rendszerkövetelményei:

  • MacOS 10.14-es vagy újabb verzió

A macOS CocoaPod csomag letölthető és használható az Xcode 9.4.1 vagy újabb integrált fejlesztői környezettel (IDE).

  1. Lépjen arra az Xcode könyvtárra, ahol az .xcodeproj projektfájl található.

  2. Futtassa pod init a Podfile nevű podfájl létrehozásához.

  3. Cserélje le a Podfile tartalmát a következő tartalomra. Frissítse a nevet AppName az target alkalmazás nevére. Szükség szerint frissítse a platform vagy a pod verzióját.

    platform :osx, 10.14
use_frameworks!

target 'AppName' do
  pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.37.0'
end

  4. Futtassa pod install a Speech SDK telepítését.

Másik lehetőségként töltse le a bináris CocoaPodot , és bontsa ki annak tartalmát. Az Xcode-projektben adjon hozzá egy hivatkozást a kinyert MicrosoftCognitiveServicesSpeech.xcframework mappára és annak tartalmára.

Feljegyzés

A .NET-fejlesztők natív macOS-alkalmazásokat hozhatnak létre a Xamarin.Mac alkalmazás-keretrendszer használatával. További információ: Xamarin.Mac.

Referenciadokumentáció csomag (Letöltés) | További minták a GitHubon |

Ebben a rövid útmutatóban telepíti a Speech SDK for Swiftet.

Tipp.

További információ a Speech SDK swifthez való használatáról: Objective-C importálása Swiftbe.

A Speech SDK telepítése Swifthez

A Speech SDK for Swift natív módon elérhető a Mac x64- és ARM-alapú Rendszerekhez készült CocoaPod-csomagként.

A Mac rendszerkövetelményei:

  • MacOS 10.14-es vagy újabb verzió

A macOS CocoaPod csomag letölthető és használható az Xcode 9.4.1 vagy újabb integrált fejlesztői környezettel (IDE).

  1. Lépjen arra az Xcode könyvtárra, ahol az .xcodeproj projektfájl található.

  2. Futtassa pod init a Podfile nevű podfájl létrehozásához.

  3. Cserélje le a Podfile tartalmát a következő tartalomra. Frissítse a nevet AppName az target alkalmazás nevére. Szükség szerint frissítse a platform vagy a pod verzióját.

    platform :osx, 10.14
use_frameworks!

target 'AppName' do
  pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.37.0'
end

  4. Futtassa pod install a Speech SDK telepítését.

Másik lehetőségként töltse le a bináris CocoaPodot , és bontsa ki annak tartalmát. Az Xcode-projektben adjon hozzá egy hivatkozást a kinyert MicrosoftCognitiveServicesSpeech.xcframework mappára és annak tartalmára.

Feljegyzés

A .NET-fejlesztők natív macOS-alkalmazásokat hozhatnak létre a Xamarin.Mac alkalmazás-keretrendszer használatával. További információ: Xamarin.Mac.

Referenciadokumentáció-csomag (PyPi) | További minták a GitHubon |

Ebben a rövid útmutatóban telepíti a Pythonhoz készült Speech SDK-t .

Platformkövetelmények

A PythonHoz készült Speech SDK kompatibilis a Windows, a Linux és a macOS rendszerrel.

Windows rendszeren a 64 bites célarchitektúrát kell használnia. Windows 10 vagy újabb rendszerre van szükség.

Telepítse a Visual Studio 2015, 2017, 2019 és 2022 Microsoft Visual C++ terjeszthető verzióját a platformhoz. A csomag első telepítése újraindítást igényelhet.

Fontos

Győződjön meg arról, hogy az azonos célarchitektúra csomagjai telepítve vannak. Ha például az x64 terjeszthető csomagot telepíti, telepítse az x64 Python-csomagot.

Telepítse a Python 3.7-es vagy újabb verzióját.

  • A telepítés ellenőrzéséhez nyisson meg egy terminált, és futtassa a parancsot python --version. Ha a Python megfelelően van telepítve, a rendszer a következőképpen válaszol: .Python 3.8.10

  • Ha macOS vagy Linux rendszert használ, előfordulhat, hogy inkább a parancsot python3 --version kell futtatnia.

    A helyetti pythonpython3használat engedélyezéséhez futtassa alias python='python3' az alias beállítását. A Speech SDK gyorsútmutató-mintái határozzák meg a használatot python .

A Pythonhoz készült Speech SDK telepítése

A Pythonhoz készült Speech SDK telepítése előtt győződjön meg arról, hogy megfelel a platform követelményeinek.

Telepítés a PyPI-ból

A PythonHoz készült Speech SDK telepítéséhez futtassa ezt a parancsot egy konzolablakban:

pip install azure-cognitiveservices-speech

Frissítés a legújabb Speech SDK-ra

A legújabb Speech SDK-ra való frissítéshez futtassa ezt a parancsot a konzolablakban:

pip install --upgrade azure-cognitiveservices-speech

A változó vizsgálatával azure.cognitiveservices.speech.__version__ ellenőrizheti, hogy a Pythonhoz készült Speech SDK melyik verziója van telepítve. Futtassa például ezt a parancsot egy konzolablakban:

pip list

A Speech SDK használata

Adja hozzá a következő importálási utasítást a Speech SDK használatához a Python-projektben:

import azure.cognitiveservices.speech as speechsdk

Kapcsolódó tartalom