Quickstart: De Speech SDK installeren

  • Artikel

Referentiedocumentatiepakket (NuGet) | Aanvullende voorbeelden op GitHub |

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

Codevoorbeelden in de documentatie zijn geschreven in C# 8 en worden uitgevoerd op .NET Standard 2.0.

Platformvereisten

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

Let op

In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. Overweeg uw gebruik en planning dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

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

U kunt deze handleidingen volgen voor meer opties.

Deze handleiding laat zien hoe u de Speech SDK installeert voor een .NET Framework-console-app (Windows).

Voor deze handleiding is het volgende vereist:

Een Visual Studio-project maken en de Speech-SDK installeren

U moet het NuGet-pakket van de Speech SDK installeren, zodat u ernaar kunt verwijzen in uw code. Hiervoor moet u mogelijk eerst een helloworld-project maken. Als u al een project hebt waarvoor de workload .NET-desktopontwikkeling beschikbaar is, kunt u dat project gebruiken en meteen verder gaan naar NuGet-pakketbeheer gebruiken om de Speech-SDK te installeren.

Een helloworld-project maken

  1. Open Visual Studio.

  2. Selecteer onder Aan de slag de optie Een nieuw project maken.

  3. Kies in Een nieuw project maken console-app (.NET Framework) en selecteer vervolgens Volgende.

  4. Voer in Uw nieuwe project configureren voor Projectnaam helloworld in, kies of maak het mappad in Locatie en selecteer Vervolgens Maken.

  5. Selecteer Tools Get Tools>and Features in de menubalk van Visual Studio. Met deze stap opent u het installatieprogramma van Visual Studio en wordt het dialoogvenster Wijzigen weergegeven.

  6. Controleer of de workload .NET-desktopontwikkeling beschikbaar is. Als de workload niet is geïnstalleerd, selecteert u deze en selecteert u Vervolgens Wijzigen om de installatie te starten. Het downloaden en installeren kan enkele minuten duren.

    Als .NET Desktop Development al is geselecteerd, selecteert u Sluiten om het dialoogvenster te sluiten.

    Schermopname van het inschakelen van .NET-desktopontwikkeling.

  7. Sluit Visual Studio Installer.

NuGet-pakketbeheer gebruiken om de Speech-SDK te installeren

  1. Klik in Solution Explorer met de rechtermuisknop op het helloworld-project en selecteer NuGet-pakketten beheren om NuGet-Pakketbeheer weer te geven.

  2. Zoek in de rechterbovenhoek de vervolgkeuzelijst Pakketbron en zorg ervoor dat nuget.org is geselecteerd.

    Schermopname van NuGet Pakketbeheer.

  3. Selecteer Bladeren in de linkerbovenhoek.

  4. Voer In het zoekvak Microsoft.CognitiveServices.Speech in en selecteer Enter.

  5. Bij de zoekresultaten selecteert u het Microsoft.CognitiveServices.Speech-pakket en selecteert u vervolgens Installeren om de meest recente stabiele versie te installeren.

    Schermopname van het installeren van het NuGet-pakket Microsoft.CognitiveServices.Speech.

  6. Accepteer alle overeenkomsten en licenties om de installatie te starten.

    Nadat het pakket is geïnstalleerd, wordt er een bevestiging weergegeven in het venster Package Manager-console.

De doelarchitectuur selecteren

Als u de consoletoepassing wilt bouwen en uitvoeren, maakt u een platformconfiguratie die overeenkomt met de architectuur van uw computer.

  1. Selecteer Build>Configuration Manager in het menu. Het dialoogvenster Configuration Manager wordt weergegeven.

  2. Selecteer Nieuw in de vervolgkeuzelijst Actief oplossingsplatform. Het dialoogvenster Platform nieuwe oplossing wordt weergegeven.

    Schermopname van het dialoogvenster Configuration Manager.

  3. Selecteer in het vak Type of selecteer de vervolgkeuzelijst voor het nieuwe platform :

    • Als u 64-bits Windows uitvoert, selecteert u x64.
    • Als u 32-bits Windows uitvoert, selecteert u x86.

  4. Selecteer OK en vervolgens Sluiten.

Referentiedocumentatiepakket (NuGet) | Aanvullende voorbeelden op GitHub |

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 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
    opnemen 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) | Aanvullende voorbeelden op GitHub |

In deze quickstart installeert u de Speech SDK voor Go.

Platformvereisten

Let op

In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. Overweeg uw gebruik en planning dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

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

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

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 (libssl) versie 1.x en certificaten (ca-certificates).
  • De gedeelde bibliotheek voor ALSA-toepassingen (libasound).

U moet ook installeren ca-certificates om een beveiligde websocket tot stand te brengen en de WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED fout te voorkomen.

Belangrijk

De Speech SDK biedt nog geen ondersteuning voor OpenSSL 3.0. Dit is de standaardinstelling in Ubuntu 22.04 en Debian 12.

Voer deze opdrachten uit:

sudo apt-get update
sudo apt-get install build-essential libssl-dev ca-certificates libasound2 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
    opnemen 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 <architecture> door de processorarchitectuur van uw CPU: x86, 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 <architecture> door de processorarchitectuur van uw CPU: x86, 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.24.2. 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.37.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

Referentiedocumentatiepakket (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 webbrowsers van clients. 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 deze uit npm initen 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 Exporteren en importeren op de JavaScript-website voor meer informatieimport.

U kunt ook een vereiste instructie gebruiken:

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

Referentiedocumentatiepakket (downloaden) | Aanvullende voorbeelden op GitHub |

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 integrated development environment (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.37.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.

Notitie

.NET-ontwikkelaars kunnen systeemeigen macOS-toepassingen bouwen met behulp van het Xamarin.Mac-toepassingsframework. Zie Xamarin.Mac voor meer informatie.

Referentiedocumentatiepakket (downloaden) | Aanvullende voorbeelden op GitHub |

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 download en gebruik met de Xcode 9.4.1 of hoger integrated development environment (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.37.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.

Notitie

.NET-ontwikkelaars kunnen systeemeigen macOS-toepassingen bouwen met behulp van het Xamarin.Mac-toepassingsframework. Zie Xamarin.Mac voor meer informatie.

Referentiedocumentatiepakket (PyPi) | Aanvullende voorbeelden op GitHub |

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.7 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 gebruik opgegeven 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

Gerelateerde inhoud