Rychlý start: Instalace sady Speech SDK

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro jazyk C#.

Požadavky platformy

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

Windows

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

Nainstalujte Microsoft Redistribuovatelné součásti Visual C++ pro Visual Studio 2015, 2017, 2019 a 2022, pro vaši platformu. První instalace tohoto balíčku může vyžadovat restartování.

Linux

Sada Speech SDK pro C# podporuje pouze následující distribuce v architekturách x64, ARM32 a ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Důležité

Použijte nejnovější verzi LTS distribuce Linuxu. 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 GNU C, včetně knihovny pro programování POSIX Threads, libpthreads.
• Knihovna OpenSSL verze 1.x (libssl1) nebo 3.x (libssl3) a certifikáty (ca-certificates).
• Sdílená knihovna pro aplikace ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Spusťte tyto příkazy:

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

Debian 11/12

Spusťte tyto příkazy:

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

Amazon Linux 2023

Spusťte tyto příkazy:

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

Azure Linux 3.0

Spusťte tyto příkazy:

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

macOS

Vyžaduje se macOS verze 10.14 nebo novější.

Instalace sady Speech SDK pro jazyk C#

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

Terminál

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

PowerShell

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

Install-Package Microsoft.CognitiveServices.Speech

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro C++.

Požadavky platformy

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

Windows

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

Nainstalujte Microsoft Redistribuovatelné knihovny Visual C++ pro Visual Studio 2015, 2017, 2019 a 2022 pro vaši verzi systému. První instalace tohoto balíčku může vyžadovat restartování.

Linux

Sada Speech SDK pro C++ podporuje pouze následující distribuce v architekturách x64, ARM32 a ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Důležité

Použijte nejnovější verzi LTS distribuce Linuxu. 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 GNU C, včetně knihovny pro programování vláken POSIX, libpthreads.
• Knihovna OpenSSL verze 1.x (libssl1) nebo 3.x (libssl3) a certifikáty (ca-certificates).
• Sdílená knihovna pro aplikace ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Spusťte tyto příkazy:

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

Debian 11/12

Spusťte tyto příkazy:

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

Amazon Linux 2023

Spusťte tyto příkazy:

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

Azure Linux 3.0

Spusťte tyto příkazy:

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

macOS

Vyžaduje se macOS verze 10.14 nebo novější.

Instalace sady Speech SDK pro C++

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

Terminál

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

PowerShell

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 těchto průvodcích.

Linux

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

Pomocí následujícího postupu stáhněte a nainstalujte sadu SDK. Tento postup zahrnuje stažení požadovaných knihoven a hlavičkových souborů jako .tar souboru.

1. Zvolte adresář pro soubory sady Speech SDK. Nastavte proměnnou SPEECHSDK_ROOT prostředí tak, aby odkazovala na daný adresář. Tato proměnná umožňuje snadno odkazovat na adresář v budoucích příkazech.

   Chcete-li použít adresář speechsdk ve vašem domovském adresáři, spusťte následující příkaz:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Pokud adresář neexistuje, vytvořte ho:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Stáhněte a extrahujte archiv .tar.gz , 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 oznámení o partnerovi a soubory licencí. Výpis by měl obsahovat adresář include, který drží soubory hlaviček (.h), a adresář lib, který obsahuje knihovny pro arm32, arm64, x64 a x86.

   Cesta	Popis
   license.md	Licence
   ThirdPartyNotices.md	Oznámení o partnerech
   REDIST.txt	Oznámení o redistribuci
   include	Požadované soubory hlaviček pro C++
   lib/arm32	Nativní knihovna pro ARM32 potřebná k propojení aplikace
   lib/arm64	Nativní knihovna pro ARM64 požadovaná k propojení 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

macOS

Tento průvodce ukazuje, jak nainstalovat sadu Speech SDK pro C++ v systému macOS 10.14 nebo novějším. Tento postup zahrnuje stažení požadovaných knihoven a souborů hlaviček jako .zip souboru.

1. Zvolte adresář pro soubory sady Speech SDK. Nastavte proměnnou prostředí SPEECHSDK_ROOT tak, aby odkazovala na tento adresář. Tato proměnná umožňuje snadno odkazovat na adresář v budoucích příkazech.

   Pokud chcete použít speechsdk adresáře ve vašem domovském adresáři, spusťte následující příkaz:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Pokud adresář neexistuje, vytvořte ho:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Stáhněte a extrahujte archiv .zip , který obsahuje sadu Speech SDK XCFramework:

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

4. Ověřte obsah adresáře nejvyšší úrovně extrahovaného balíčku:

   ls -l "$SPEECHSDK_ROOT"
   

   Seznam adresářů by měl obsahovat oznámení partnera, soubory licencí a adresář MicrosoftCognitiveServicesSpeech.xcframework .

Windows

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro C++ v desktopových operačních systémech Windows.

Tento průvodce nastavením vyžaduje:

• Microsoft přeinstalovatelné balíčky Visual C++ pro Visual Studio pro platformu Windows. První instalace může vyžadovat restartování.
• Visual Studio.

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

Pokud chcete vytvořit projekt sady Visual Studio pro vývoj desktopových aplikací C++, musíte:

• Nastavte možnosti vývoje sady Visual Studio.
• Vytvořte projekt.
• Vyberte cílovou architekturu.
• Nainstalujte sadu Speech SDK.

Nastavení možností vývoje sady Visual Studio

Pokud chcete začít, ujistěte se, že jste v sadě Visual Studio pro vývoj desktopových aplikací C++ správně nastaveni:

1. Otevřete Visual Studio 2019 a zobrazte tak úvodní okno.

2. Výběrem možnosti Pokračovat bez kódu přejděte do integrovaného vývojového prostředí sady Visual Studio.

   

3. V řádku nabídek sady Visual Studio vyberte Nástroje>Získat nástroje a funkce k otevření Instalačního programu pro Visual Studio a zobrazení dialogového okna Úpravy.

4. Na kartě Úlohy v části Windows vyhledejte vývoj desktopových aplikací pomocí úlohy C++. Pokud tato úloha ještě není vybraná, vyberte ji.

   

5. Na kartě Jednotlivé komponenty vyhledejte správce balíčků NuGet. Pokud ještě není vybraný, vyberte ho.

6. Vyberte Možnost Zavřít nebo Upravit. Název tlačítka se liší v závislosti na tom, jestli jste pro instalaci vybrali nějaké funkce.

   Pokud vyberete Možnost Upravit, spustí se instalace. Proces může chvíli trvat.

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

Vytvoření projektu

Dále vytvořte projekt a vyberte cílovou architekturu:

1. V nabídce sady Visual Studio vyberte Soubor>nový>projekt a zobrazte okno Vytvořit nový projekt.

2. Vyhledejte a vyberte Konzolová aplikace. Ujistěte se, že jste vybrali verzi jazyka C++ tohoto typu projektu místo jazyka C# nebo Visual Basic.

3. Vyberte Další.

   

4. V dialogovém okně Konfigurovat nový projekt zadejte do názvu projektu helloworld.

5. V umístění přejděte do složky a vyberte nebo vytvořte složku, do které chcete projekt uložit, a pak vyberte Vytvořit.

   

6. Vyberte cílovou architekturu platformy. Na panelu nástrojů sady Visual Studio vyhledejte rozevírací seznam platformy řešení. Pokud ho nevidíte, vyberte Zobrazit>Panely nástrojů>Standard, aby se zobrazil panel nástrojů, který obsahuje Platformy řešení.

   Pokud používáte 64bitovou verzi Windows, vyberte v rozevíracím seznamu x64 . 64bitová verze Windows může také spouštět 32bitové aplikace, takže pokud chcete, můžete zvolit x86 .

Instalace sady Speech SDK pomocí sady Visual Studio

Nakonec nainstalujte NuGet balíček Speech SDK a přidejte odkaz na Speech SDK ve svém projektu:

1. V Průzkumníku řešení klikněte pravým tlačítkem na své řešení a poté vyberte Spravovat balíčky NuGet pro řešení, abyste přešli do okna NuGet – Řešení.

2. Vyberte Procházet.

3. Ve zdroji balíčku vyberte nuget.org.

   

4. Do vyhledávacíhopole zadejte Microsoft.CognitiveServices.Speech. Vyberte tento balíček, jakmile se zobrazí ve výsledcích hledání.

5. V podokně stavu balíčku vedle výsledků hledání vyberte projekt helloworld .

6. Vyberte volbu Instalovat.

   

7. V dialogovém okně Náhled změn vyberte OK.

8. V dialogovém okně Přijetí licence zobrazte licenci a pak vyberte Přijmout. Spustí se instalace balíčku. Po dokončení instalace se v podokně Výstup zobrazí zpráva podobná následujícímu textu: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro Go.

Požadavky platformy

Sada Speech SDK pro Go podporuje následující distribuce v architektuře x64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12

Důležité

Použijte nejnovější verzi LTS distribuce Linuxu. 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 GNU C, včetně POSIX Threads Programming library, libpthreads.
• Knihovna OpenSSL verze 1.x (libssl1) nebo 3.x (libssl3) a certifikáty (ca-certificates).
• Sdílená knihovna pro aplikace ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Spusťte tyto příkazy:

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

Debian 11/12

Spusťte tyto příkazy:

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

Amazon Linux 2023

Spusťte tyto příkazy:

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

Azure Linux 3.0

Spusťte tyto příkazy:

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

Nainstalujte binární verzi Go 1.13 nebo novější.

Instalace sady Speech SDK pro Go

Pomocí následujícího postupu stáhněte a nainstalujte sadu SDK. Tento postup zahrnuje stažení požadovaných knihoven a hlavičkových souborů jako .tar soubor.

1. Zvolte adresář pro soubory sady Speech SDK. Nastavte proměnnou SPEECHSDK_ROOT prostředí, aby odkazovala na tento adresář. Tato proměnná umožňuje snadno odkazovat na adresář v budoucích příkazech.

   Pokud chcete použít adresář speechsdk ve vašem domovském adresáři, spusťte následující příkaz:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Pokud adresář neexistuje, vytvořte ho:

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Stáhněte a extrahujte archiv .tar.gz , 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 oznámení o partnerovi a soubory licencí. Výpis by měl obsahovat adresář include, který obsahuje soubory hlaviček (.h), a adresář lib, který obsahuje knihovny pro arm32, arm64, x64 a x86.

   Cesta	Popis
   license.md	Licence
   ThirdPartyNotices.md	Oznámení o partnerech
   REDIST.txt	Oznámení o redistribuci
   include	Požadované soubory hlaviček pro C++
   lib/arm32	Nativní knihovna pro ARM32 potřebná k propojení aplikace
   lib/arm64	Nativní knihovna pro ARM64 požadovaná k propojení 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žňují vašemu prostředí jazyka Go najít Speech SDK.

1. Vzhledem k tomu, že vazby závisejí 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"
   

   Důležité

   Nahraďte <architecture> architekturou procesoru procesoru: x64, arm32nebo arm64.

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

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

   Důležité

   Nahraďte <architecture> architekturou procesoru procesoru: x64, arm32nebo arm64.

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro Javu.

Požadavky platformy

Zvolte cílové prostředí:

Java Runtime

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

Windows

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

Nainstalujte Microsoft Redistribuovatelný balíček Visual C++ 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 v ARM64.

Linux

Sada Speech SDK pro Javu podporuje následující distribuce v architekturách x64, ARM32 a ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Důležité

Použijte nejnovější verzi LTS distribuce Linuxu. 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 GNU C, včetně knihovny pro programování s vlákny POSIX, libpthreads.
• Knihovna OpenSSL verze 1.x (libssl1) nebo 3.x (libssl3) a certifikáty (ca-certificates).
• Sdílená knihovna pro aplikace ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Spusťte tyto příkazy:

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

Debian 11/12

Spusťte tyto příkazy:

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

Amazon Linux 2023

Spusťte tyto příkazy:

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

Azure Linux 3.0

Spusťte tyto příkazy:

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

macOS

Vyžaduje se macOS verze 10.14 nebo novější.

Android

Sada Speech SDK je kompatibilní se zařízeními s Androidem, která mají 32/64bitový procesor ARM a procesory kompatibilní s Procesory Intel x86/x64.

Nainstalujte sadu pro vývoj v Javě, například Azul Zulu OpenJDK. Měla by fungovat také Microsoft Build OpenJDK nebo upřednostňovaná verze JDK.

Instalace sady Speech SDK pro Javu

Některé pokyny používají konkrétní verzi sady SDK, například 1.43.0. Pokud chcete zkontrolovat nejnovější verzi, vyhledejte úložiště GitHub.

Zvolte cílové prostředí:

Java Runtime

Tento průvodce ukazuje, jak nainstalovat sadu Speech SDK pro Javu v prostředí Java Runtime.

Podporované operační systémy

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

• Windows: pouze 64bitová verze.
• Mac: macOS X verze 10.14 nebo novější.
• Linux: Podívejte se na podporované distribuce Linuxu a cílové architektury.

Maven

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, a vytvořte nový soubor pom.xml .

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.43.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. Spusťte následující příkaz Maven pro instalaci sady Speech SDK a jejích závislostí.

   mvn clean dependency:copy-dependencies
   

Eclipse

Vytvoření projektu Eclipse a instalace sady Speech SDK

1. Nainstalujte integrované vývojové prostředí (IDE) Eclipse Java. Toto integrované vývojové prostředí (IDE) vyžaduje, aby už byla nainstalovaná Java.

2. Spusťte Eclipse.

3. Ve spouštěči Eclipse zadejte do pole Pracovní prostor název nového adresáře pracovního prostoru. Potom vyberte Launch (Spustit).

   

4. Za chvíli se zobrazí hlavní okno prostředí Eclipse IDE. Zavřete Welcome obrazovku, pokud je přítomna.

5. V nabídce Eclipse vyberte Soubor>>projekt.

6. Zobrazí se dialogové okno Nový projekt. Vyberte Projekt Java a pak vyberte Další.

   

7. Spustí se průvodce novým projektem Java. Do pole Název projektu zadejte rychlý start. Jako spouštěcí prostředí zvolte JavaSE-1.8 . Vyberte Dokončit.

   

8. Pokud se zobrazí okno Open Associated Perspective? (Otevřít související perspektivu?), vyberte Open Perspective (Otevřít perspektivu).

9. V Package Explorer klikněte pravým tlačítkem na projekt quickstart. V místní nabídce vyberte Konfigurovat>Převést na projekt Maven.

   

10. Zobrazí se okno Create new POM (Vytvořit nový POM). Do pole ID skupiny zadejte com.microsoft.cognitiveservices.speech.samples. Do pole ID artefaktu zadejte rychlý start. Pak vyberte Dokončit.

    

11. Otevřete soubor pom.xml a upravte ho:

    1. Před koncovou dependencies značku </project>přidejte prvek na konec souboru se sadou Speech SDK jako závislostí:

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

    1. Uložte změny.

Gradle

Konfigurace Gradle

Konfigurace Gradle vyžadují explicitní odkaz na rozšíření závislostí .jar :

// build.gradle

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

Android

Tento průvodce ukazuje, jak nainstalovat sadu Speech SDK pro Javu v Androidu.

Sada Speech SDK pro Android je zabalená jako soubor AAR (Android Archive), který obsahuje potřebné knihovny a požadovaná oprávnění Androidu.

Instalace sady Speech SDK pomocí Android Studia

V Android Studiu vytvořte nový projekt a přidejte sadu Speech SDK pro Javu jako knihovní závislost. Nastavení je založené na balíčku Maven sady Speech SDK a na Android Studio Chipmunk 2021.2.1.

Vytvoření prázdného projektu

1. Otevřete Android Studio a vyberte Nový projekt.

   

2. V okně Nový projekt, které se zobrazí, vyberte Telefon a tablet>Prázdná aktivita a pak vyberte Další.

   

3. Do textového pole Název zadejte SpeechQuickstart.

   

4. Do textového pole Název balíčku zadejte samples.speech.cognitiveservices.microsoft.com.

5. V poli Umístění pro uložení vyberte adresář projektu.

6. V poli Pro výběr jazyka vyberte Javu.

7. V poli Minimální úroveň rozhraní API vyberte rozhraní API 23: Android 6.0 (Marshmallow).

8. Vyberte Dokončit.

Příprava nového projektu v android Studiu nějakou dobu trvá. První použití Android Studia může trvat několik minut, než nastavíte předvolby, přijmete licence a dokončíte průvodce.

Instalace sady Speech SDK pro Javu v Androidu

Přidejte Speech SDK jako závislost do svého projektu.

1. Vyberte Soubor>Strukturu projektu>Závislosti>aplikace.

2. Výběrem symbolu plus (+) přidejte závislost v části Deklarované závislosti. Potom v rozevírací nabídce vyberte Závislost knihovny.

   

3. V okně Přidat závislost knihovny, které se zobrazí, zadejte název a verzi sady Speech SDK pro Javu: com.microsoft.cognitiveservices.speech:client-sdk:1.43.0. Poté vyberte Hledat.

4. Ujistěte se, že je vybrané ID skupinycom.microsoft.cognitiveservices.speech, a pak vyberte OK.

5. Výběrem OK zavřete okno Projektová struktura projektu a použijete změny projektu.

Referenční dokumentace | Balíček (npm) | Další ukázky ve zdrojovém kódu knihovny GitHub |

V tomto rychlém startu nainstalujete sadu Speech SDK pro JavaScript.

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

Požadavky platformy

Seznamte se s důsledky architektury mezi Node.js a klientskými webovými prohlížeči. Například objektový model dokumentu (DOM) není k dispozici pro aplikace na straně serveru. Systém souborů Node.js není k dispozici pro aplikace na straně klienta.

Instalace sady Speech SDK pro JavaScript

V závislosti na cílovém prostředí použijte jednu z následujících příruček:

Node.js

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 init, a projděte si instrukce.

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ách Node.js.

Na základě prohlížeče

Tato příručka ukazuje, jak nainstalovat sadu Speech SDK pro JavaScript pro použití s webovou stránkou.

Rozbalte do složky

1. Vytvořte novou prázdnou složku. Pokud chcete ukázku hostovat na webovém serveru, ujistěte se, že má webový server přístup ke složce.

2. Stáhněte si sadu Speech SDK jako balíček .zip a rozbalte ho do nově vytvořené složky. Tyto soubory jsou rozbalené:

   • microsoft.cognitiveservices.speech.sdk.bundle.js: Uživatelsky čitelná verze sady Speech SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.js.map: Soubor mapy, který se použije k ladění kódu sady SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.d.ts: Definice objektů pro použití s TypeScriptem
   • microsoft.cognitiveservices.speech.sdk.bundle-min.js: Minifikovaná verze sady Speech SDK.
   • speech-processor.js: Kód pro zlepšení výkonu v některých prohlížečích.

3. Ve složce vytvořte nový soubor s názvem index.html a otevřete ho v textovém editoru.

Značka skriptu HTML

Stáhněte a extrahujte soubor microsoft.cognitiveservices.speech.sdk.bundle.js ze sady Speech SDK pro JavaScript. Umístěte ho do složky, ke které má soubor HTML přístup.

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

Tip

Pokud cílíte na webový prohlížeč a používáte <script> značku, předpona sdk není nutná. Předpona sdk je alias, který se používá k pojmenování require modulu.

Alternativně můžete do elementu HTML přímo zahrnout <script> značku, která se spoléhá na <head>.

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

Další informace najdete v ukázkách založených na prohlížeči.

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 importexportu a importu na webu JavaScript.

Alternativně 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

V tomto rychlém startu nainstalujete sadu Speech SDK pro Objective-C.

Tip

Další informace o používání sady Speech SDK pro Swift najdete v tématu Importu Objective-C do Swiftu.

Instalace sady Speech SDK pro Objective-C

Mac

Sada Speech SDK pro Objective-C je nativně dostupná jako balíček CocoaPod pro systémy Mac x64 a ARM.

Požadavky na systém pro Mac:

• MacOS verze 10.14 nebo novější

Balíček macOS CocoaPod 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, kde se nachází váš soubor projektu .xcodeproj .

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

3. Obsah souboru Podfile nahraďte následujícím obsahem. Aktualizujte název target na název vaší aplikace místo AppName. Podle potřeby aktualizujte verzi platformy nebo podu.

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

4. Spusťte pod install k instalaci sady Speech SDK.

Případně si stáhněte binární CocoaPod a extrahujte jeho obsah. V projektu Xcode přidejte odkaz na extrahovaný soubor MicrosoftCognitiveServicesSpeech.xcframework a jeho obsah.

iOS

Sada Speech SDK pro Objective-C je nativně dostupná jako balíček CocoaPod.

Požadavky na systém pro iOS:

• MacOS verze 10.14 nebo novější
• Cílení na iOS 9.3 nebo novější

Balíček macOS CocoaPod 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, kde se nachází váš soubor projektu .xcodeproj .

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

3. Obsah souboru Podfile nahraďte následujícím obsahem. Aktualizujte název target z AppName na název vaší aplikace. Podle potřeby aktualizujte verzi platformy nebo podu.

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

4. Spusťte pod install instalaci sady Speech SDK.

Případně si stáhněte binární CocoaPod a extrahujte jeho obsah. V projektu Xcode přidejte odkaz na extrahovaný soubor MicrosoftCognitiveServicesSpeech.xcframework a jeho obsah.

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro Swift.

Tip

Další informace o používání sady Speech SDK pro Swift najdete v tématu Importu Objective-C do Swiftu.

Instalace sady Speech SDK pro Swift

Mac

Sada Speech SDK pro Swift je nativně dostupná jako balíček CocoaPod pro systémy Mac x64 a ARM.

Požadavky na systém pro Mac:

• MacOS verze 10.14 nebo novější

Balíček macOS CocoaPod 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, kde se nachází váš soubor projektu .xcodeproj .

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

3. Obsah souboru Podfile nahraďte následujícím obsahem. Aktualizujte target z názvu AppName na název vaší aplikace. Podle potřeby aktualizujte verzi platformy nebo podu.

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

4. Spusťte pod install ke spuštění instalace sady Speech SDK.

Případně si stáhněte binární CocoaPod a extrahujte jeho obsah. V projektu Xcode přidejte odkaz na extrahovaný soubor MicrosoftCognitiveServicesSpeech.xcframework a jeho obsah.

iOS

Sada Speech SDK pro Swift je nativně dostupná jako balíček CocoaPod.

Požadavky na systém pro iOS:

• MacOS verze 10.14 nebo novější
• Cílení na iOS 9.3 nebo novější

Balíček macOS CocoaPod 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, kde se nachází váš soubor projektu .xcodeproj .

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

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

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

4. Spusťte pod install k instalaci sady Speech SDK.

Případně si stáhněte binární CocoaPod a extrahujte jeho obsah. V projektu Xcode přidejte odkaz na extrahovaný soubor MicrosoftCognitiveServicesSpeech.xcframework a jeho obsah.

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

V tomto rychlém startu nainstalujete sadu Speech SDK pro Python.

Požadavky platformy

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

Windows

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

Nainstalujte Microsoft Visual C++ Redistribuovatelný balíček 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, nainstalujte balíček x64 Python.

Linux

Sada Speech SDK pro Python podporuje následující distribuce v architekturách x64 a ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Důležité

Použijte nejnovější verzi LTS distribuce Linuxu. 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 GNU C, včetně knihovny pro programování vláken POSIX, libpthreads.
• Knihovna OpenSSL verze 1.x (libssl1) nebo 3.x (libssl3) a certifikáty (ca-certificates).
• Sdílená knihovna pro aplikace ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Spusťte tyto příkazy:

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

Debian 11/12

Spusťte tyto příkazy:

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

Amazon Linux 2023

Spusťte tyto příkazy:

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

Azure Linux 3.0

Spusťte tyto příkazy:

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

macOS

Vyžaduje se macOS verze 10.14 nebo novější.

Nainstalujte verzi Pythonu z verze 3.8 nebo novější.

• Pokud chcete zkontrolovat instalaci, otevřete terminál a spusťte příkaz python --version. Pokud je Python správně nainstalovaný, získáte odpověď, například Python 3.8.10.

• Pokud používáte macOS nebo Linux, možná budete muset příkaz python3 --version spustit.

  Pokud chcete povolit použití python místo python3, spusťte alias python='python3' pro nastavení aliasu. Ukázky rychlého startu 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ňuje požadavky na platformu.

PyPI

Instalace z PyPI

Pokud chcete nainstalovat sadu Speech SDK pro Python, spusťte tento příkaz v okně konzoly:

pip install azure-cognitiveservices-speech

Upgradovat na nejnovější sadu Speech SDK

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

pip install --upgrade azure-cognitiveservices-speech

Kontrolu toho, která verze sady Speech SDK pro Python je aktuálně nainstalovaná, můžete zkontrolovat kontrolou azure.cognitiveservices.speech.__version__ proměnné. Spusťte například tento příkaz v okně konzoly:

pip list

VS Code

Instalace sady Speech SDK pomocí editoru Visual Studio Code

Instalace sady Speech SDK pro Python:

1. Stáhněte a nainstalujte si Visual Studio Code.

2. Spusťte Visual Studio Code a nainstalujte rozšíření Pythonu:

   1. Vyberte Soubory>Předvolby>Přípony.
   2. Vyhledejte Python, vyhledejte rozšíření Pythonu pro Visual Studio Code publikované Microsoftem a pak vyberte Nainstalovat.

   

3. Vyberte Terminál>Nový terminál a otevřete terminál v editoru Visual Studio Code.

4. Na příkazovém řádku terminálu spusťte následující příkaz, který nainstaluje balíček Speech SDK pro Python.

   python -m pip install azure-cognitiveservices-speech
   

Další informace o editoru Visual Studio Code a Pythonu najdete v tématu Visual Studio Code a Začínáme s Pythonem ve VS Code.

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

Ukázky kódu

Podrobné ukázky jsou k dispozici v úložišti Azure-Samples/cognitive-services-speech-sdk na GitHubu. Existují ukázky pro C# (včetně UPW a Unity), C++, Java, JavaScriptu (včetně prohlížeče a Node.js), Objective-C, Pythonu a Swiftu. Ukázky kódu pro Go jsou k dispozici v úložišti Microsoft/cognitive-services-speech-sdk-go na GitHubu.

Související obsah

• Rychlý start pro převod řeči na text
• Rychlý start pro převod textu na řeč
• Rychlý úvod do překladu řeči