Delen via

Quickstart: De Speech SDK installeren

  • Artikel

Referentiedocumentatiepakket (NuGet) |

In deze quickstart installeert u de Speech SDK voor C#.

Platformvereisten

De Speech SDK voor C# is compatibel met Windows, Linux en macOS.

In Windows moet u de 64-bits doelarchitectuur gebruiken. Windows 10 of hoger is vereist.

Installeer Microsoft Visual C++ Redistributable voor Visual Studio 2015, 2017, 2019 en 2022 voor uw platform. Als u dit pakket voor de eerste keer installeert, moet u mogelijk opnieuw opstarten.

De Speech SDK voor C installeren#

De Speech SDK voor C# is beschikbaar als een NuGet-pakket en implementeert .NET Standard 2.0. Zie Microsoft.CognitiveServices.Speech voor meer informatie.

De Speech SDK voor C# kan worden geïnstalleerd vanuit de .NET CLI met behulp van de volgende dotnet add opdracht:

dotnet add package Microsoft.CognitiveServices.Speech

Referentiedocumentatiepakket (NuGet) |

In deze quickstart installeert u de Speech SDK voor C++.

Platformvereisten

De Speech SDK voor C++ is compatibel met Windows, Linux en macOS.

In Windows moet u de 64-bits doelarchitectuur gebruiken. Windows 10 of hoger is vereist.

Installeer Microsoft Visual C++ Redistributable voor Visual Studio 2015, 2017, 2019 en 2022 voor uw platform. Als u dit pakket voor de eerste keer installeert, moet u mogelijk opnieuw opstarten.

De Speech SDK voor C++ installeren

De Speech SDK voor C++ is beschikbaar als een NuGet-pakket. Zie Microsoft.CognitiveServices.Speech voor meer informatie.

De Speech SDK voor C++ kan worden geïnstalleerd vanuit de .NET CLI met behulp van de volgende dotnet add opdracht:

dotnet add package Microsoft.CognitiveServices.Speech

U kunt deze handleidingen volgen voor meer opties.

Deze handleiding laat zien hoe u de Speech SDK voor Linux installeert.

Gebruik de volgende procedure om de SDK te downloaden en te installeren. De stappen omvatten het downloaden van de vereiste bibliotheken en headerbestanden als een .tar-bestand .

  1. Kies een map voor de Speech SDK-bestanden. Stel de SPEECHSDK_ROOT omgevingsvariabele in om naar die map te verwijzen. Met deze variabele kunt u in toekomstige opdrachten eenvoudig naar de map verwijzen.

    Voer de volgende opdracht uit om de directory speechsdk in uw basismap te gebruiken:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Maak de directory aan als deze niet bestaat.

    mkdir -p "$SPEECHSDK_ROOT"

  3. Download en pak het .tar.gz archief uit dat de binaire bestanden van de Speech SDK bevat:

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

  4. Valideer de inhoud van de map op het hoogste niveau van het uitgepakte pakket:

    ls -l "$SPEECHSDK_ROOT"

    De directoryvermelding moet de kennisgevingen en licentiebestanden van de partner bevatten. De vermelding moet ook een insluitingsmap bevatten die headerbestanden (.h) bevat en een lib-map met bibliotheken voor arm32, arm64, x64 en x86.

    Pad Beschrijving
    license.md Licentie
    ThirdPartyNotices.md Kennisgevingen van partners
    REDIST.txt Kennisgeving over herdistributie
    includeren Vereiste headerbestanden voor C++
    lib/arm32 Native-bibliotheek voor ARM32 vereist voor het koppelen van uw toepassing
    lib/arm64 Native-bibliotheek voor ARM64 vereist voor het koppelen van uw toepassing
    lib/x64 Native-bibliotheek voor x64 vereist voor het koppelen van uw toepassing
    lib/x86 Native-bibliotheek voor x86 vereist voor het koppelen van uw toepassing

Referentiedocumentatiepakket (Go) |

In deze quickstart installeert u de Speech SDK voor Go.

Platformvereisten

De Speech SDK voor Go ondersteunt de volgende distributies op de x64-architectuur:

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

Belangrijk

Gebruik de meest recente LTS-versie van de Linux-distributie. Als u bijvoorbeeld Ubuntu 20.04 LTS gebruikt, gebruikt u de nieuwste versie van Ubuntu 20.04.X.

De Speech SDK is afhankelijk van de volgende Linux-systeembibliotheken:

  • De gedeelde bibliotheken van de GNU C-bibliotheek, waaronder de POSIX Threads Programming-bibliotheek, libpthreads.
  • De OpenSSL-bibliotheek, versie 1.x (libssl1) of 3.x (libssl3) en certificaten (ca-certificates).
  • De gedeelde bibliotheek voor ALSA-toepassingen (libasound2).

Voer deze opdrachten uit:

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

Installeer de binaire Go-versie 1.13 of hoger.

De Speech SDK voor Go installeren

Gebruik de volgende procedure om de SDK te downloaden en te installeren. De stappen omvatten het downloaden van de vereiste bibliotheken en headerbestanden als een .tar-bestand .

  1. Kies een map voor de Speech SDK-bestanden. Stel de SPEECHSDK_ROOT omgevingsvariabele in om naar die map te verwijzen. Met deze variabele kunt u in toekomstige opdrachten eenvoudig naar de map verwijzen.

    Voer de volgende opdracht uit om de directory speechsdk in uw basismap te gebruiken:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Maak de map als deze niet bestaat:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Download en pak het .tar.gz archief uit dat de binaire bestanden van de Speech SDK bevat:

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

  4. Valideer de inhoud van de map op het hoogste niveau van het uitgepakte pakket:

    ls -l "$SPEECHSDK_ROOT"

    De directoryvermelding moet de kennisgevingen en licentiebestanden van de partner bevatten. De vermelding moet ook een insluitingsmap bevatten die headerbestanden (.h) bevat en een lib-map met bibliotheken voor arm32, arm64, x64 en x86.

    Pad Beschrijving
    license.md Licentie
    ThirdPartyNotices.md Kennisgevingen van partners
    REDIST.txt Kennisgeving over herdistributie
    bevatten Vereiste headerbestanden voor C++
    lib/arm32 Native-bibliotheek voor ARM32 vereist voor het koppelen van uw toepassing
    lib/arm64 Native-bibliotheek voor ARM64 vereist voor het koppelen van uw toepassing
    lib/x64 Native-bibliotheek voor x64 vereist voor het koppelen van uw toepassing
    lib/x86 Native-bibliotheek voor x86 vereist voor het koppelen van uw toepassing

De Go-omgeving configureren

Met de volgende stappen kan uw Go-omgeving de Speech SDK vinden.

  1. Omdat de bindingen afhankelijk cgozijn van, moet u de omgevingsvariabelen instellen, zodat Go de SDK kan vinden.

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

    Belangrijk

    Vervang door <architecture> de processorarchitectuur van uw CPU: x64, arm32of arm64.

  2. Als u toepassingen en de SDK wilt uitvoeren, moet u het besturingssysteem laten weten waar de bibliotheken moeten worden gevonden.

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

    Belangrijk

    Vervang door <architecture> de processorarchitectuur van uw CPU: x64, arm32of arm64.

Referentiedocumentatie | Aanvullende voorbeelden op GitHub

In deze quickstart installeert u de Speech SDK voor Java.

Platformvereisten

Kies uw doelomgeving:

De Speech SDK voor Java is compatibel met Windows, Linux en macOS.

In Windows moet u de 64-bits doelarchitectuur gebruiken. Windows 10 of hoger is vereist.

Installeer Microsoft Visual C++ Redistributable voor Visual Studio 2015, 2017, 2019 en 2022 voor uw platform. Als u dit pakket voor de eerste keer installeert, moet u mogelijk opnieuw opstarten.

De Speech SDK voor Java biedt geen ondersteuning voor Windows in ARM64.

Installeer een Java Development Kit zoals Azul Zulu OpenJDK. De Microsoft Build van OpenJDK of uw favoriete JDK moet ook werken.

De Speech SDK voor Java installeren

Sommige instructies gebruiken een specifieke SDK-versie, zoals 1.43.0. Als u de nieuwste versie wilt controleren, zoekt u in onze GitHub-opslagplaats.

Kies uw doelomgeving:

Deze handleiding laat zien hoe u de Speech SDK voor Java installeert in de Java Runtime.

Ondersteunde besturingssystemen

Het Speech SDK-pakket voor Java is beschikbaar voor deze besturingssystemen:

Volg deze stappen om de Speech SDK voor Java te installeren met behulp van Apache Maven:

  1. Installeer Apache Maven.

  2. Open een opdrachtprompt waarin u het nieuwe project wilt opnemen en maak een nieuw pom.xml bestand.

  3. Kopieer de volgende XML-inhoud naar 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. Voer de volgende Maven-opdracht uit om de Speech SDK en afhankelijkheden te installeren.

    mvn clean dependency:copy-dependencies

Referentiedocumentatie | Pakket (npm) | Aanvullende voorbeelden op GitHub | Library broncode

In deze quickstart installeert u de Speech SDK voor JavaScript.

De Speech SDK voor JavaScript is beschikbaar als npm-pakket. Zie microsoft-cognitiveservices-speech-sdk en de bijbehorende GitHub-opslagplaats cognitive-services-speech-sdk-js.

Platformvereisten

Inzicht in de gevolgen voor de architectuur tussen Node.js en client-webbrowsers. Het documentobjectmodel (DOM) is bijvoorbeeld niet beschikbaar voor toepassingen aan de serverzijde. Het Node.js bestandssysteem is niet beschikbaar voor toepassingen aan de clientzijde.

De Speech SDK voor JavaScript installeren

Gebruik een van de volgende handleidingen, afhankelijk van de doelomgeving:

In deze handleiding ziet u hoe u de Speech SDK voor JavaScript installeert voor gebruik met Node.js.

  1. Installeer Node.js.

  2. Maak een nieuwe map, voer npm init uit en doorloop de prompts.

  3. Voer de volgende npm install opdracht uit om de Speech SDK voor JavaScript te installeren:

    npm install microsoft-cognitiveservices-speech-sdk

Zie de Node.js voorbeelden voor meer informatie.

De Speech-SDK gebruiken

  • Voeg de volgende importinstructie toe om de Speech SDK in uw JavaScript-project te gebruiken:

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

Zie import op de JavaScript-website voor meer informatie.

U kunt ook een require-opdracht gebruiken:

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

Referentiedocumentatiepakket (download) |

In deze quickstart installeert u de Speech SDK voor Objective-C.

Tip

Zie Objective-C importeren in Swift voor meer informatie over het gebruik van de Speech SDK voor Swift.

De Speech SDK voor Objective-C installeren

De Speech SDK voor Objective-C is systeemeigen beschikbaar als een CocoaPod-pakket voor Mac x64- en ARM-systemen.

Systeemvereisten voor Mac:

  • Een macOS-versie 10.14 of hoger

Het macOS CocoaPod-pakket is beschikbaar voor download en gebruik met de Xcode 9.4.1 of hoger geïntegreerde ontwikkelomgeving (IDE).

  1. Ga naar de Xcode-map waar het .xcodeproj-projectbestand zich bevindt.

  2. Voer pod init deze opdracht uit om een podbestand met de naam Podfile te maken.

  3. Vervang de inhoud van Podfile door de volgende inhoud. Werk de target naam bij van AppName naar de naam van uw app. Werk indien nodig de platform- of podversie bij.

    platform :osx, 10.14
use_frameworks!

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

  4. Voer deze opdracht uit pod install om de Speech SDK te installeren.

U kunt ook de binaire CocoaPod downloaden en de inhoud ervan extraheren. Voeg in uw Xcode-project een verwijzing toe naar de geëxtraheerde map MicrosoftCognitiveServicesSpeech.xcframework en de inhoud ervan.

Referentiedocumentatiepakket (download) |

In deze quickstart installeert u de Speech SDK voor Swift.

Tip

Zie Objective-C importeren in Swift voor meer informatie over het gebruik van de Speech SDK voor Swift.

De Speech SDK voor Swift installeren

De Speech SDK voor Swift is systeemeigen beschikbaar als een CocoaPod-pakket voor Mac x64- en ARM-systemen.

Systeemvereisten voor Mac:

  • Een macOS-versie 10.14 of hoger

Het macOS CocoaPod-pakket is beschikbaar voor downloaden en gebruiken met versie 9.4.1 of hoger van Xcode binnen de geïntegreerde ontwikkelomgeving (IDE).

  1. Ga naar de Xcode-map waar het .xcodeproj-projectbestand zich bevindt.

  2. Voer pod init deze opdracht uit om een podbestand met de naam Podfile te maken.

  3. Vervang de inhoud van Podfile door de volgende inhoud. Werk de target naam bij van AppName naar de naam van uw app. Werk indien nodig de platform- of podversie bij.

    platform :osx, 10.14
use_frameworks!

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

  4. Voer deze opdracht uit pod install om de Speech SDK te installeren.

U kunt ook de binaire CocoaPod downloaden en de inhoud ervan extraheren. Voeg in uw Xcode-project een verwijzing toe naar de geëxtraheerde map MicrosoftCognitiveServicesSpeech.xcframework en de inhoud ervan.

Referentiedocumentatiepakket (PyPi) |

In deze quickstart installeert u de Speech SDK voor Python.

Platformvereisten

De Speech SDK voor Python is compatibel met Windows, Linux en macOS.

In Windows moet u de 64-bits doelarchitectuur gebruiken. Windows 10 of hoger is vereist.

Installeer Microsoft Visual C++ Redistributable voor Visual Studio 2015, 2017, 2019 en 2022 voor uw platform. Als u dit pakket voor de eerste keer installeert, moet u mogelijk opnieuw opstarten.

Belangrijk

Zorg ervoor dat pakketten van dezelfde doelarchitectuur zijn geïnstalleerd. Als u bijvoorbeeld het x64-herdistribueerbare pakket installeert, installeert u het x64 Python-pakket.

Installeer een versie van Python vanaf 3.8 of hoger.

  • Als u de installatie wilt controleren, opent u een terminal en voert u de opdracht python --versionuit. Als Python correct is geïnstalleerd, krijgt u een antwoord zoals Python 3.8.10.

  • Als u macOS of Linux gebruikt, moet u mogelijk de opdracht python3 --version uitvoeren.

    Als u het gebruik van python in plaats van python3, wilt inschakelen, voert u de opdracht uit alias python='python3' om een alias in te stellen. In de quickstartvoorbeelden van de Speech SDK wordt het gebruik gespecificeerd python.

De Speech SDK voor Python installeren

Voordat u de Speech SDK voor Python installeert, moet u voldoen aan de platformvereisten.

Installeren vanuit PyPI

Als u de Speech SDK voor Python wilt installeren, voert u deze opdracht uit in een consolevenster:

pip install azure-cognitiveservices-speech

Upgrade uitvoeren naar de nieuwste Speech SDK

Als u een upgrade wilt uitvoeren naar de nieuwste Speech SDK, voert u deze opdracht uit in het consolevenster:

pip install --upgrade azure-cognitiveservices-speech

U kunt controleren welke Speech SDK voor Python-versie momenteel is geïnstalleerd door de azure.cognitiveservices.speech.__version__ variabele te controleren. Voer deze opdracht bijvoorbeeld uit in een consolevenster:

pip list

De Speech-SDK gebruiken

Voeg de volgende importinstructie toe om de Speech SDK in uw Python-project te gebruiken:

import azure.cognitiveservices.speech as speechsdk

Codevoorbeelden

Uitgebreide voorbeelden zijn beschikbaar in de opslagplaats Azure-Samples/cognitive-services-speech-sdk op GitHub. Er zijn voorbeelden voor C# (waaronder UWP en Unity), C++, Java, JavaScript (inclusief Browser en Node.js), Objective-C, Python en Swift. Codevoorbeelden voor Go zijn beschikbaar in de opslagplaats Microsoft/cognitive-services-speech-sdk-go op GitHub.

Gerelateerde inhoud