Instalace sady Speech SDK

  • Článek
  • 35 min ke čtení

Referenční dokumentace | Balíček (NuGet) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro C#.

Ukázky kódu v dokumentaci jsou napsané v jazyce C# 8 a běží na .NET Standard 2.0.

Požadavky platformy

Sada Speech SDK pro C# je kompatibilní s Windows, Linuxem a macOS.

Ve Windows musíte použít 64bitovou cílovou architekturu. Windows 10 nebo novější.

Musíte nainstalovat Microsoft Visual C++ Redistributable pro Visual Studio 2015, 2017, 2019 a 2022 pro vaši platformu. První instalace tohoto balíčku může vyžadovat restartování.

Instalace sady Speech SDK pro jazyk C #

Sada Speech SDK pro C# je k dispozici jako balíček NuGet a implementuje .NET Standard 2.0. Další informace najdete v tématu Microsoft.CognitiveServices.Speech.

Sadu Speech SDK pro C# je možné nainstalovat z rozhraní příkazového řádku .NET pomocí následujícího dotnet add příkazu:

dotnet add package Microsoft.CognitiveServices.Speech

Sadu Speech SDK pro C# je možné nainstalovat pomocí následujícího Install-Package příkazu:

Install-Package Microsoft.CognitiveServices.Speech

Další možnosti najdete v níže uvedeném průvodci.

Volba cílového prostředí

Tento průvodce ukazuje, jak nainstalovat sadu Speech SDK pro konzolovou aplikaci .NET Framework (Windows).

Požadavky

Tato příručka vyžaduje:

Vytvoření projektu sady Visual Studio a instalace sady Speech SDK

Musíte nainstalovat balíček NuGet sady Speech SDK , abyste na něj mohli v kódu odkazovat. K tomu možná budete muset nejprve vytvořit projekt helloworld . Pokud už máte projekt s dostupnou úlohou vývoj desktopových aplikací .NET , můžete ho použít a přeskočit k části Použití Správce balíčků NuGet k instalaci sady Speech SDK.

Vytvoření projektu helloworld

  1. Otevřete Visual Studio 2019.

  2. V okně Start vyberte Vytvořit nový projekt.

  3. V okně Vytvořit nový projekt zvolte Konzolová aplikace (.NET Framework) a pak vyberte Další.

  4. V okně Konfigurace nového projektu zadejte do pole Název projektuhelloworld, zvolte nebo vytvořte cestu k adresáři v umístění a pak vyberte Vytvořit.

  5. V řádku nabídek sady Visual Studio vyberte Nástroje>Získat nástroje a funkce. Tento krok otevře Instalační program pro Visual Studio a zobrazí dialogové okno Úpravy.

  6. Zkontrolujte, jestli je dostupná úloha vývoj desktopových aplikací .NET . Pokud úloha není nainstalovaná, zaškrtněte políčko vedle ní a pak výběrem možnosti Upravit spusťte instalaci. Stažení a instalace může trvat několik minut.

    Pokud je zaškrtnuté políčko vývoj desktopových aplikací pro .NET , zavřete dialogové okno výběrem možnosti Zavřít .

    Snímek obrazovky znázorňující povolení vývoje pro desktopové aplikace .NET

  7. Zavřete Instalační program pro Visual Studio.

Instalace sady Speech SDK pomocí Správce balíčků NuGet

  1. V Průzkumník řešení klikněte pravým tlačítkem na projekt helloworld a pak vyberte Spravovat balíčky NuGet, aby se zobrazil Správce balíčků NuGet.

  2. V pravém horním rohu vyhledejte rozevírací seznam Zdroj balíčku a ujistěte se, že je vybraná nuget.org .

    Snímek obrazovky znázorňující Správce balíčků NuGet

  3. V levém horním rohu vyberte Procházet.

  4. Do vyhledávacího pole zadejte Microsoft.CognitiveServices.Speech a vyberte Enter.

  5. Ve výsledcích hledání vyberte balíček Microsoft.CognitiveServices.Speech a pak výběrem možnosti Nainstalovat nainstalujte nejnovější stabilní verzi.

    Snímek obrazovky znázorňující instalaci balíčku NuGet Microsoft.CognitiveServices.Speech

  6. Přijměte všechny smlouvy a licence pro spuštění instalace.

    Po instalaci balíčku se v okně konzoly Správce balíčků zobrazí potvrzení.

Volba cílové architektury

Pokud chcete sestavit a spustit konzolovou aplikaci, vytvořte konfiguraci platformy, která odpovídá architektuře počítače.

  1. V řádku nabídek vyberte Sestavit>Configuration Manager. Zobrazí se dialogové okno Configuration Manager.

  2. V rozevíracím seznamu Aktivní platforma řešení vyberte Nové. Zobrazí se dialogové okno Nová platforma řešení .

    Snímek obrazovky s dialogovým oknem Configuration Manager

  3. V rozevíracím seznamu Zadejte nebo vyberte novou platformu :

    • Pokud používáte 64bitovou verzi Windows, vyberte x64.
    • Pokud používáte 32bitovou verzi Windows, vyberte x86.

  4. Vyberte OK a pak Zavřít.

Referenční dokumentace | Balíček (NuGet) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro C++.

Požadavky platformy

Sada Speech SDK pro C++ je kompatibilní s Windows, Linuxem a macOS.

Ve Windows musíte použít 64bitovou cílovou architekturu. Windows 10 nebo novější.

Musíte nainstalovat Microsoft Visual C++ Redistributable pro Visual Studio 2015, 2017, 2019 a 2022 pro vaši platformu. První instalace tohoto balíčku může vyžadovat restartování.

Instalace sady Speech SDK pro C++

Sada Speech SDK pro C++ je k dispozici jako balíček NuGet. Další informace najdete v tématu Microsoft.CognitiveServices.Speech.

Sadu Speech SDK pro C++ je možné nainstalovat z rozhraní příkazového řádku .NET pomocí následujícího dotnet add příkazu:

dotnet add package Microsoft.CognitiveServices.Speech

Sadu Speech SDK pro C# je možné nainstalovat pomocí následujícího Install-Package příkazu:

Install-Package Microsoft.CognitiveServices.Speech

Další možnosti najdete v níže uvedeném průvodci.

Volba cílového prostředí

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Linux.

Ke stažení a instalaci sady SDK použijte následující postup. Postup zahrnuje stažení požadovaných knihoven a souborů hlaviček jako souboru .tar z https://aka.ms/csspeech/linuxbinarywebu .

  1. Vyberte adresář, do kterého se mají soubory sady Speech SDK extrahovat, a proměnnou prostředí SPEECHSDK_ROOT nastavte tak, aby odkazovala na tento adresář. Tato proměnná umožňuje snadno odkazovat na adresář v budoucích příkazech.

    Pokud třeba chcete používat adresář speechsdk ve svém domovském adresáři, použijte příkaz podobný tomuto:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Pokud adresář ještě neexistuje, vytvořte ho:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Stáhněte a extrahujte .tar.gz archiv, který obsahuje binární soubory sady 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. Ověřte obsah adresáře nejvyšší úrovně extrahovaného balíčku:

    ls -l "$SPEECHSDK_ROOT"

    Seznam adresářů by měl obsahovat soubory s poznámkami a licencemi třetích stran. Výpis by měl obsahovat include také adresář, který obsahuje soubory hlaviček (.h), a lib adresář, který obsahuje knihovny pro arm32, arm64, x64 a x86.

    Cesta Popis
    license.md Licence
    ThirdPartyNotices.md Oznámení třetích stran
    REDIST.txt Oznámení o redistribuci
    include Požadované soubory hlaviček pro C++
    lib/arm32 Nativní knihovna pro ARM32 potřebná k propojení vaší aplikace
    lib/arm64 Nativní knihovna pro ARM64 požadovaná k propojení vaší aplikace
    lib/x64 Nativní knihovna pro x64 požadovaná pro propojení vaší aplikace
    lib/x86 Nativní knihovna pro x86 požadovaná pro propojení vaší aplikace

Referenční dokumentace | Balíček (Go) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Go.

Požadavky platformy

Sada Speech SDK pro Go při použití s Linuxem podporuje jenom Ubuntu 18.04/20.04/22.04, Debian 10/9/11, Red Hat Enterprise Linux (RHEL) 8 a CentOS 8 v architektuře x64.

Důležité

Použijte nejnovější verzi LTS linuxové distribuce. Pokud například používáte Ubuntu 20.04 LTS, použijte nejnovější verzi Ubuntu 20.04.X.

Sada Speech SDK závisí na následujících systémových knihovnách Linuxu:

  • Sdílené knihovny knihovny GNU C, včetně knihovny POSIX Threads Programming, libpthreads
  • Knihovna OpenSSL (libssl) verze 1.x
  • Sdílená knihovna pro aplikace ALSA (libasound)
sudo apt-get update
sudo apt-get install build-essential libssl-dev libasound2 wget

Důležité

Sada Speech SDK nepodporuje OpenSSL 3.0, což je výchozí nastavení v Ubuntu 22.04.

Pouze na Ubuntu 22.04 nainstalujte nejnovější knihovnu libssl1.1 buď jako binární balíček, nebo jeho kompilací ze zdrojů.

Musíte nainstalovat binární verzi Jazyka Go 1.13 nebo novější.

Instalace sady Speech SDK pro Go

Ke stažení a instalaci sady SDK použijte následující postup. Postup zahrnuje stažení požadovaných knihoven a souborů hlaviček jako souboru .tar z https://aka.ms/csspeech/linuxbinarywebu .

  1. Vyberte adresář, do kterého se mají soubory sady Speech SDK extrahovat, a proměnnou prostředí SPEECHSDK_ROOT nastavte tak, aby odkazovala na tento adresář. Tato proměnná umožňuje snadno odkazovat na adresář v budoucích příkazech.

    Pokud třeba chcete používat adresář speechsdk ve svém domovském adresáři, použijte příkaz podobný tomuto:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Pokud adresář ještě neexistuje, vytvořte ho:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Stáhněte a extrahujte .tar.gz archiv, který obsahuje binární soubory sady 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. Ověřte obsah adresáře nejvyšší úrovně extrahovaného balíčku:

    ls -l "$SPEECHSDK_ROOT"

    Seznam adresářů by měl obsahovat soubory s poznámkami a licencemi třetích stran. Výpis by měl obsahovat include také adresář, který obsahuje soubory hlaviček (.h), a lib adresář, který obsahuje knihovny pro arm32, arm64, x64 a x86.

    Cesta Popis
    license.md Licence
    ThirdPartyNotices.md Oznámení třetích stran
    REDIST.txt Oznámení o redistribuci
    include Požadované soubory hlaviček pro C++
    lib/arm32 Nativní knihovna pro ARM32 potřebná k propojení vaší aplikace
    lib/arm64 Nativní knihovna pro ARM64 požadovaná k propojení vaší aplikace
    lib/x64 Nativní knihovna pro x64 požadovaná pro propojení vaší aplikace
    lib/x86 Nativní knihovna pro x86 požadovaná pro propojení vaší aplikace

Konfigurace prostředí Go

Následující kroky umožní vašemu prostředí Go najít sadu Speech SDK. V obou krocích nahraďte <architecture> architekturou procesoru procesoru. x86Bude to , x64, arm32nebo arm64.

  1. Vzhledem k tomu, že vazby spoléhají na cgo, musíte nastavit proměnné prostředí, aby Go mohl najít sadu SDK.

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

  2. Pokud chcete spouštět aplikace a sadu SDK, musíte operačnímu systému sdělit, kde má knihovny najít.

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

Referenční dokumentace | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Javu.

Požadavky platformy

Volba cílového prostředí

Sada Speech SDK pro Javu je kompatibilní s Windows, Linuxem a macOS.

Ve Windows musíte použít 64bitovou cílovou architekturu. Windows 10 nebo novější.

Musíte nainstalovat Microsoft Visual C++ Redistributable pro Visual Studio 2015, 2017, 2019 a 2022 pro vaši platformu. První instalace tohoto balíčku může vyžadovat restartování.

Sada Speech SDK pro Javu nepodporuje Windows na ARM64.

Musíte nainstalovat sadu Java Development Kit, například Azul Zulu OpenJDK. Měl by fungovat také microsoft build OpenJDK nebo upřednostňovaná sada JDK.

Instalace sady Speech SDK pro Javu

Některé pokyny používají konkrétní verzi sady SDK, například 1.24.2. Nejnovější verzi můžete zkontrolovat vyhledáním našeho úložiště GitHub.

Volba cílového prostředí

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Javu v modulu Runtime Java.

Podporované operační systémy

Balíček Speech SDK pro Javu je k dispozici pro tyto operační systémy:

Pokud chcete nainstalovat sadu Speech SDK pro Javu pomocí Apache Mavenu, postupujte takto:

  1. Nainstalujte Apache Maven.
  2. Otevřete příkazový řádek, na kterém chcete nový projekt vytvořit, a vytvořte nový pom.xml soubor.
  3. Zkopírujte následující obsah XML do 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.26.0</version>
        </dependency>
    </dependencies>
</project>
  4. Spuštěním následujícího příkazu Maven nainstalujte sadu Speech SDK a závislosti. 
    mvn clean dependency:copy-dependencies

Referenční dokumentace | Balíček (npm) | Další ukázky na GitHubu | Zdrojový kód knihovny

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro JavaScript.

Sada Speech SDK pro JavaScript je k dispozici jako balíček npm. Viz microsoft-cognitiveservices-speech-sdk a její doprovodné úložiště GitHub cognitive-services-speech-sdk-js.

Požadavky platformy

Nezapomeňte zvážit různé architektonické důsledky mezi Node.js a klientskými webovými prohlížeči. Například model DOM (Document Object Model) není k dispozici pro aplikace na straně serveru, stejně jako Node.js systém souborů není dostupný pro aplikace na straně klienta.

Instalace sady Speech SDK pro JavaScript

V závislosti na cílovém prostředí použijte jeden z následujících průvodců:

Volba cílového prostředí

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro JavaScript pro použití s Node.js. Pokud chcete, aby název balíčku začínal sám, spusťte npm install microsoft-cognitiveservices-speech-sdk ho z existujícího projektu.

Požadavky

Tento rychlý start vyžaduje Node.js.

Vytvoření projektu npm

Vytvořte nový adresář, spusťte npm initpříkaz a projděte si výzvy.

Přidání balíčku sady Speech SDK

Spusťte npm install microsoft-cognitiveservices-speech-sdk.

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro JavaScript pro použití s Node.js.

  1. Nainstalujte Node.js.

  2. Vytvořte nový adresář, spusťte npm initpříkaz a projděte si výzvy.

  3. Pokud chcete nainstalovat sadu Speech SDK pro JavaScript, spusťte následující npm install příkaz:

    npm install microsoft-cognitiveservices-speech-sdk

Další informace najdete v ukázkáchNode.js.

Použití sady Speech SDK

Přidejte následující příkaz importu pro použití sady Speech SDK v projektu JavaScriptu:

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

Další informace o najdete v importtématu Export a import na webu JavaScriptu.

Případně můžete použít příkaz require:

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

Referenční dokumentace | Balíček (stáhnout) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Objective-C.

Tip

Podrobnosti o používání sady Speech SDK pro Swift najdete v tématu Import objective-C do Swiftu.

Instalace sady Speech SDK pro Objective-C

Sada Speech SDK pro Objective-C je k dispozici nativně jako balíček CocoaPod pro mac x64 a procesory založené na arm.

Požadavky na systém pro Mac:

  • MacOS verze 10.14 nebo novější

Balíček CocoaPod pro macOS je k dispozici ke stažení a použití s integrovaným vývojovým prostředím (IDE) Xcode 9.4.1 (nebo novějším).

  1. Přejděte do adresáře Xcode, ve kterém .xcodeproj se nachází soubor projektu.

  2. Spuštěním příkazu pod init vytvořte soubor podu s názvem Podfile.

  3. Podfile Obsah nahraďte následujícím kódem. target Aktualizujte název z "AppName" na název vaší aplikace. Podle potřeby aktualizujte platformu nebo verzi podu.

    platform :osx, 10.14
use_frameworks!

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

  4. Spuštěním příkazu pod install nainstalujte sadu Speech SDK.

Případně si můžete stáhnout binární CocoaPod a rozbalit extrahovat jeho obsah. V projektu Xcode přidejte odkaz na extrahované složky MicrosoftCognitiveServicesSpeech.xcframework a její obsah.

Poznámka

Vývojáři .NET můžou vytvářet nativní aplikace pro macOS pomocí aplikační architektury Xamarin.Mac. Další informace najdete v tématu Xamarin.Mac.

Referenční dokumentace | Balíček (stáhnout) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Swift.

Tip

Podrobnosti o používání sady Speech SDK pro Swift najdete v tématu Import objective-C do Swiftu.

Instalace sady Speech SDK pro Swift

Sada Speech SDK pro Swift je k dispozici nativně jako balíček CocoaPod pro Mac x64 a procesory založené na ARM.

Požadavky na systém pro Mac:

  • MacOS verze 10.14 nebo novější

Balíček CocoaPod pro macOS je k dispozici ke stažení a použití s integrovaným vývojovým prostředím (IDE) Xcode 9.4.1 (nebo novějším).

  1. Přejděte do adresáře Xcode, ve kterém .xcodeproj se nachází soubor projektu.

  2. Spuštěním příkazu pod init vytvořte soubor podu s názvem Podfile.

  3. Podfile Obsah nahraďte následujícím kódem. target Aktualizujte název z "AppName" na název vaší aplikace. Podle potřeby aktualizujte platformu nebo verzi podu.

    platform :osx, 10.14
use_frameworks!

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

  4. Spuštěním příkazu pod install nainstalujte sadu Speech SDK.

Případně si můžete stáhnout binární CocoaPod a rozbalit extrahovat jeho obsah. V projektu Xcode přidejte odkaz na extrahované složky MicrosoftCognitiveServicesSpeech.xcframework a její obsah.

Poznámka

Vývojáři .NET můžou vytvářet nativní aplikace pro macOS pomocí aplikační architektury Xamarin.Mac. Další informace najdete v tématu Xamarin.Mac.

Referenční dokumentace | Balíček (PyPi) | Další ukázky na GitHubu

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro Python.

Požadavky platformy

Sada Speech SDK pro Python je kompatibilní s Windows, Linuxem a macOS.

Ve Windows musíte použít 64bitovou cílovou architekturu. Windows 10 nebo novější.

Musíte nainstalovat Microsoft Visual C++ Redistributable pro Visual Studio 2015, 2017, 2019 a 2022 pro vaši platformu. První instalace tohoto balíčku může vyžadovat restartování.

Důležité

Ujistěte se, že jsou nainstalované balíčky stejné cílové architektury. Pokud například nainstalujete distribuovatelný balíček x64, musíte nainstalovat balíček Python x64.

Nainstalujte verzi Pythonu od 3.7 do 3.10.

Pokud chcete zkontrolovat instalaci, otevřete terminál a spusťte příkaz python --version. Pokud je správně nainstalovaný, zobrazí se odpověď typu Python 3.8.10. Pokud používáte macOS nebo Linux, možná budete muset spustit příkaz python3 --version . Pokud chcete místo povolit použití pythonpython3, nastavte alias spuštěním příkazu alias python='python3' . Ukázky rychlého zprovoznění sady Speech SDK určují python využití.

Instalace sady Speech SDK pro Python

Před instalací sady Speech SDK pro Python se ujistěte, že splňujete požadavky na platformu.

Volba nástroje nebo integrovaného vývojového prostředí (IDE)

Instalace z PyPI

Pokud chcete nainstalovat sadu Speech SDK pro Python, spusťte tento příkaz v terminálu.

pip install azure-cognitiveservices-speech

Upgrade na nejnovější sadu Speech SDK

Pokud chcete upgradovat na nejnovější sadu Speech SDK, spusťte v terminálu tento příkaz:

pip install --upgrade azure-cognitiveservices-speech

Pokud chcete zjistit, která verze sady Speech SDK pro Python je aktuálně nainstalovaná, zkontrolujte proměnnou azure.cognitiveservices.speech.__version__ . Například v terminálu spusťte tento příkaz:

pip list

Použití sady Speech SDK

Přidejte následující příkaz importu pro použití sady Speech SDK v projektu Pythonu:

import azure.cognitiveservices.speech as speechsdk

Další kroky