Snabbstart: Installera Speech SDK

Referensdokumentation | Paket (NuGet)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för C#.

Plattformskrav

Speech SDK för C# är kompatibelt med Windows, Linux och macOS.

I Windows måste du använda 64-bitars målarkitekturen. Windows 11 eller senare krävs.

Installera Microsoft Visual C++ Redistributable för Visual Studio 2015, 2017, 2019 och 2022 för din plattform. Att installera det här paketet för första gången kan kräva en omstart.

Installera Speech SDK för C#

Speech SDK för C# är tillgängligt som ett NuGet-paket och implementerar .NET Standard 2.0. Mer information finns i Microsoft.CognitiveServices.Speech.

Speech SDK för C# kan installeras från .NET CLI med hjälp av följande dotnet add kommando:

dotnet add package Microsoft.CognitiveServices.Speech

Referensdokumentation | Paket (NuGet)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för C++.

Plattformskrav

Speech SDK för C++ är kompatibelt med Windows, Linux och macOS.

I Windows måste du använda 64-bitars målarkitekturen. Windows 11 eller senare krävs.

Installera Microsoft Visual C++ Redistributable för Visual Studio 2015, 2017, 2019 och 2022 för din plattform. Att installera det här paketet för första gången kan kräva en omstart.

Installera Speech SDK för C++

Speech SDK för C++ är tillgängligt som ett NuGet-paket. Mer information finns i Microsoft.CognitiveServices.Speech.

Speech SDK för C++ kan installeras från .NET CLI med hjälp av följande dotnet add kommando:

dotnet add package Microsoft.CognitiveServices.Speech

Du kan följa dessa guider för fler alternativ.

Den här guiden visar hur du installerar Speech SDK för Linux.

Använd följande procedur för att ladda ned och installera SDK:t. Stegen omfattar nedladdning av nödvändiga bibliotek och headerfiler som en .tar-fil.

  1. Välj en katalog för Speech SDK-filerna. Ange miljövariabeln SPEECHSDK_ROOT så att den pekar på den katalogen. Den här variabeln gör det enkelt att referera till katalogen i framtida kommandon.

    Kör följande kommando för att använda katalogen speechsdk i din hemkatalog:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Skapa katalogen om den inte finns:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Ladda ned och extrahera det .tar.gz arkiv som innehåller Speech SDK-binärfilerna:

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

  4. Validera innehållet i toppnivåkatalogen i det extraherade paketet:

    ls -l "$SPEECHSDK_ROOT"

    Kataloglistan bör innehålla partnermeddelanden och licensfiler. Listan bör också innehålla en inkluderingskatalog som innehåller huvudfiler (.h) och en lib-katalog som innehåller bibliotek för arm32, arm64 och x64.

    Path Description
    license.md License
    ThirdPartyNotices.md Partnermeddelanden
    REDIST.txt Omdistributionsmeddelande
    include Nödvändiga huvudfiler för C++
    lib/arm32 Nativt bibliotek för ARM32 som krävs för att länka ditt program
    lib/arm64 Nativt bibliotek för ARM64 som krävs för att länka ditt program
    lib/x64 Nativt bibliotek för x64 krävs för att länka ditt program

Referensdokumentation | Paket (Go)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för Go.

Plattformskrav

Speech SDK för Go stöder följande distributioner i x64-arkitekturen:

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

Important

Använd den senaste LTS-versionen av Linux-distributionen. Om du till exempel använder Ubuntu 20.04 LTS använder du den senaste versionen av Ubuntu 20.04.X.

Speech SDK beror på följande Linux-systembibliotek:

  • De delade biblioteken för GNU C-biblioteket, inklusive POSIX Threads Programming-biblioteket, libpthreads.
  • OpenSSL-biblioteket, version 1.x (libssl1) eller 3.x (libssl3), samt certifikat (ca-certificates).
  • Det delade biblioteket för ALSA-program (libasound2).

Kör dessa kommandon:

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

Installera Go-binären version 1.13 eller senare.

Installera Speech SDK för Go

Använd följande procedur för att ladda ned och installera SDK:t. Stegen omfattar nedladdning av nödvändiga bibliotek och headerfiler som en .tar-fil.

  1. Välj en katalog för Speech SDK-filerna. Ange miljövariabeln SPEECHSDK_ROOT så att den pekar på den katalogen. Den här variabeln gör det enkelt att referera till katalogen i framtida kommandon.

    Kör följande kommando för att använda katalogen speechsdk i din hemkatalog:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Skapa katalogen om den inte finns:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Ladda ned och extrahera det .tar.gz arkiv som innehåller Speech SDK-binärfilerna:

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

  4. Validera innehållet i toppnivåkatalogen i det extraherade paketet:

    ls -l "$SPEECHSDK_ROOT"

    Kataloglistan bör innehålla partnermeddelanden och licensfiler. Listan bör också innehålla en inkluderingskatalog som innehåller huvudfiler (.h) och en lib-katalog som innehåller bibliotek för arm32, arm64 och x64.

    Path Description
    license.md License
    ThirdPartyNotices.md Partnermeddelanden
    REDIST.txt Omdistributionsmeddelande
    include Nödvändiga huvudfiler för C++
    lib/arm32 Nativt bibliotek för ARM32 som krävs för att länka ditt program
    lib/arm64 Nativt bibliotek för ARM64 som krävs för att länka ditt program
    lib/x64 Nativt bibliotek för x64 krävs för att länka ditt program

Konfigurera Go-miljön

Följande steg gör det möjligt för Go-miljön att hitta Speech SDK.

  1. Eftersom bindningarna förlitar sig på cgomåste du ange miljövariablerna så att Go kan hitta SDK:et.

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

    Important

    Ersätt <architecture> med processorarkitekturen för din CPU: x64, arm32 eller arm64.

  2. Om du vill köra program och SDK måste du tala om för operativsystemet var biblioteken finns.

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

    Important

    Ersätt <architecture> med processorarkitekturen för din CPU: x64, arm32 eller arm64.

Referensdokumentation | Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för Java.

Plattformskrav

Välj din målmiljö:

Speech SDK för Java är kompatibelt med Windows, Linux och macOS.

I Windows måste du använda 64-bitars målarkitekturen. Windows 11 eller senare krävs.

Installera Microsoft Visual C++ Redistributable för Visual Studio 2015, 2017, 2019 och 2022 för din plattform. Att installera det här paketet för första gången kan kräva en omstart.

Speech SDK för Java stöder inte Windows på ARM64.

Installera ett Java Development Kit, till exempel Azul Zulu OpenJDK. Microsoft Build för OpenJDK eller din önskade JDK bör också fungera.

Installera Speech SDK för Java

Vissa av instruktionerna använder en specifik SDK-version, till exempel 1.43.0. Om du vill kontrollera den senaste versionen, sök i vårt GitHub-repositorium.

Välj målmiljö:

Den här guiden visar hur du installerar Speech SDK för Java i Java Runtime-miljön.

Operativsystem som stöds

Speech SDK för Java-paketet är tillgängligt för dessa operativsystem:

Följ de här stegen för att installera Speech SDK för Java med Apache Maven:

  1. Installera Apache Maven.

  2. Öppna en kommandotolk där du vill ha det nya projektet och skapa en ny pom.xml fil.

  3. Kopiera följande XML-innehåll till 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. Kör följande Maven-kommando för att installera Speech SDK och beroenden.

    mvn clean dependency:copy-dependencies

ReferensdokumentationPaket (npm)Ytterligare exempel på GitHubBibliotekets källkod

I den här snabbstarten installerar du Speech SDK för JavaScript.

Speech SDK för JavaScript är tillgängligt som ett npm-paket. Se microsoft-cognitiveservices-speech-sdk och dess tillhörande GitHub-lagringsplats cognitive-services-speech-sdk-js.

Plattformskrav

Förstå de arkitektoniska konsekvenserna mellan Node.js och klientwebbläsare. Till exempel är dokumentobjektmodellen (DOM) inte tillgänglig för program på serversidan. Det Node.js-filsystemet är inte tillgängligt för program på klientsidan.

Installera Speech SDK för JavaScript

Beroende på målmiljön använder du någon av följande guider:

Den här guiden visar hur du installerar Speech SDK för JavaScript för användning med Node.js.

  1. Installera Node.js.

  2. Skapa en ny katalog, kör npm initoch gå igenom anvisningarna.

  3. Kör följande npm install kommando för att installera Speech SDK för JavaScript:

    npm install microsoft-cognitiveservices-speech-sdk

Mer information finns i Node.js-exempel.

Använd Speech SDK

  • Lägg till följande import-instruktion för att använda Speech SDK i ditt JavaScript-projekt:

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

Mer information om importfinns i Exportera och importera på JavaScript-webbplatsen.

Du kan också använda en require-sats:

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

ReferensdokumentationPaket (nedladdning)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för Objective-C.

Tip

Mer information om hur du använder Speech SDK för Swift finns i Importera Objective-C till Swift.

Installera Speech SDK för Objective-C

Installera Speech SDK för Objective-C på Mac med Swift Správca balíkov.

Systemkrav för Mac-appen:

  • Kräver macOS 10.14 eller senare

Använd Xcode 12 eller senare för att lägga till Swift-paketet.

  1. Öppna ditt .xcodeproj-projekt i Xcode.
  2. Välj Arkiv>Lägg till paketberoenden.
  3. Ange https://github.com/microsoft/speech-sdk-spm och välj en version som börjar på 1.51.0.
  4. Lägg till produkten MicrosoftCognitiveServicesSpeech-macOS i appmålet.

Du kan också ladda ned SDK-binärfilen och extrahera dess innehåll. I Xcode-projektet lägger du till en referens till den extraherade mappen MicrosoftCognitiveServicesSpeech.xcframework och dess innehåll.

ReferensdokumentationPaket (nedladdning)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för Swift.

Tip

Mer information om hur du använder Speech SDK för Swift finns i Importera Objective-C till Swift.

Installera Speech SDK för Swift

Installera Speech SDK för Swift på Mac med Swift Správca balíkov.

Systemkrav för Mac-appen:

  • macOS 10.14 eller senare

Använd Xcode 12 eller senare för att lägga till Swift-paketet.

  1. Öppna ditt .xcodeproj-projekt i Xcode.
  2. Välj Arkiv>Lägg till paketberoenden.
  3. Ange https://github.com/microsoft/speech-sdk-spm och välj en version som börjar på 1.51.0.
  4. Lägg till produkten i MicrosoftCognitiveServicesSpeech-macOS appmål.

Du kan också ladda ned SDK-binärfilen och extrahera dess innehåll. I Xcode-projektet lägger du till en referens till den extraherade mappen MicrosoftCognitiveServicesSpeech.xcframework och dess innehåll.

Referensdokumentation | Paket (PyPi)Ytterligare exempel på GitHub

I den här snabbstarten installerar du Speech SDK för Python.

Plattformskrav

Speech SDK för Python är kompatibelt med Windows, Linux och macOS.

I Windows måste du använda 64-bitars målarkitekturen. Windows 11 eller senare krävs.

Installera Microsoft Visual C++ Redistributable för Visual Studio 2015, 2017, 2019 och 2022 för din plattform. Att installera det här paketet för första gången kan kräva en omstart.

Important

Kontrollera att paket med samma målarkitektur är installerade. Om du till exempel installerar paketet x64 redistributable installerar du x64 Python-paketet.

Installera en version av Python från 3.8 eller senare.

  • Om du vill kontrollera installationen öppnar du en terminal och kör kommandot python --version. Om Python är korrekt installerat får du ett svar som Python 3.8.10.

  • Om du använder macOS eller Linux kan du behöva köra kommandot python3 --version i stället.

    Om du vill aktivera användning av python i stället för python3kör du alias python='python3' för att konfigurera ett alias. Snabbstartsexemplen för Speech SDK anger hur python används.

Installera Speech SDK för Python

Innan du installerar Speech SDK för Python måste du uppfylla plattformskraven.

Installera från PyPI

Om du vill installera Speech SDK för Python kör du det här kommandot i ett konsolfönster:

pip install azure-cognitiveservices-speech

Uppgradera till den senaste Speech SDK

Om du vill uppgradera till den senaste Speech SDK:en kör du det här kommandot i konsolfönstret:

pip install --upgrade azure-cognitiveservices-speech

Du kan kontrollera vilken version av Speech SDK för Python som för närvarande är installerad genom att inspektera variabeln azure.cognitiveservices.speech.__version__. Kör till exempel det här kommandot i ett konsolfönster:

pip list

Använd Speech SDK

Lägg till följande import-instruktion för att använda Speech SDK i python-projektet:

import azure.cognitiveservices.speech as speechsdk

Kodexempel

Kodexempel är tillgängliga på lagringsplatsen Azure-Samples/cognitive-services-speech-sdk på GitHub. Det finns exempel för C# (inklusive Universal Windows Platform (UWP)), C++, Java, JavaScript (inklusive Browser och Node.js), Objective-C, Python och Swift. Kodexempel för Go är tillgängliga på microsoft/cognitive-services-speech-sdk-go-lagringsplatsen på GitHub.

Relaterat innehåll

  • Uppdaterades senast