Guida introduttiva: Installare Speech SDK

Pacchetto della documentazione di riferimento | (NuGet) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per C#.

Gli esempi di codice nella documentazione sono scritti in C# 8 ed eseguiti in .NET Standard 2.0.

Requisiti di piattaforma

Speech SDK per C# è compatibile con Windows, Linux e macOS.

Attenzione

Questo articolo fa riferimento a CentOS, una distribuzione Linux vicina allo stato end of life (EOL). Prendere in considerazione l'uso e la pianificazione di conseguenza. Per altre informazioni, vedere le linee guida per la fine della vita di CentOS.

In Windows è necessario usare l'architettura di destinazione a 64 bit. È necessario Windows 10 o versione successiva.

Installare Microsoft Visual C++ Redistributable per Visual Studio 2015, 2017, 2019 e 2022 per la piattaforma. L'installazione di questo pacchetto per la prima volta potrebbe richiedere un riavvio.

Installare Speech SDK per C#

Speech SDK per C# è disponibile come pacchetto NuGet e implementa .NET Standard 2.0. Per altre informazioni, vedere Microsoft.CognitiveServices.Speech.

Speech SDK per C# può essere installato dall'interfaccia della riga di comando di .NET usando il comando seguente dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

È possibile seguire queste guide per altre opzioni.

Questa guida illustra come installare Speech SDK per un'app console .NET Framework (Windows).

Questa guida richiede:

Creare un progetto di Visual Studio e installare Speech SDK

È necessario installare il pacchetto NuGet speech SDK per farvi riferimento nel codice. A tale scopo, potrebbe essere prima necessario creare un progetto helloworld . Se si dispone già di un progetto con il carico di lavoro .NET desktop development disponibile, è possibile usare quel progetto e passare a Usare NuGet Package Manager per installare Speech SDK.

Creare un progetto helloworld

  1. Aprire Visual Studio.

  2. In Attività iniziali selezionare Crea un nuovo progetto.

  3. In Crea un nuovo progetto, scegliere App console (.NET Framework), quindi selezionare Avanti.

  4. In Configura il nuovo progetto, per Nome progetto immettere helloworld, scegliere o creare il percorso della directory in Percorso e quindi selezionare Crea.

  5. Nella barra dei menu di Visual Studio selezionare Strumenti Recupera strumenti>e funzionalità. Questo passaggio apre Programma di installazione di Visual Studio e visualizza la finestra di dialogo Modifica.

  6. Assicurarsi che il carico di lavoro di Sviluppo per desktop .NET sia disponibile. Se il carico di lavoro non è installato, selezionarlo e quindi selezionare Modifica per avviare l'installazione. Il download e l'installazione potrebbero richiedere alcuni minuti.

    Se lo sviluppo di desktop .NET è già selezionato, selezionare Chiudi per chiudere la finestra di dialogo.

    Screenshot che mostra l'abilitazione dello sviluppo di applicazioni desktop .NET.

  7. Chiudere il Programma di installazione di Visual Studio.

Usare NuGet Package Manager per installare Speech SDK

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto helloworld e quindi scegliere Gestisci pacchetti NuGet per visualizzare i Gestione pacchetti NuGet.

  2. Nell'angolo in alto a destra individuare la casella di riepilogo a discesa Origine pacchetto e assicurarsi che nuget.org sia selezionato.

    Screenshot che mostra Gestione pacchetti NuGet.

  3. Nell'angolo in alto a sinistra fare clic su Sfoglia.

  4. Nella casella di ricerca immettere Microsoft.CognitiveServices.Speech e selezionare Invio.

  5. Nei risultati della ricerca selezionare il pacchetto Microsoft.CognitiveServices.Speech e quindi selezionare Installa per installare la versione stabile più recente.

    Screenshot che mostra l'installazione del pacchetto NuGet Microsoft.CognitiveServices.Speech.

  6. Accettare tutti i contratti e le licenze per avviare l'installazione.

    Dopo aver installato il pacchetto, viene visualizzato un messaggio di conferma nella finestra della Console di Gestione pacchetti.

Scegliere l'architettura di destinazione

Per compilare ed eseguire l'applicazione console, creare una configurazione della piattaforma corrispondente all'architettura del computer.

  1. Scegliere Compila>Configuration Manager dal menu. Verrà visualizzata finestra di dialogo Gestione configurazione.

  2. Nell'elenco a discesa Piattaforma soluzione attiva selezionare Nuovo. Verrà visualizzata la finestra di dialogo Nuova piattaforma soluzione.

    Screenshot che mostra la finestra di dialogo Configuration Manager.

  3. Nella casella a discesa Digitare o selezionare la nuova piattaforma:

    • Se è in esecuzione Windows a 64 bit, selezionare x64.
    • Se è in esecuzione Windows a 32 bit, selezionare x86.
  4. Fare clic su OK e quindi su Chiudi.

Pacchetto della documentazione di riferimento | (NuGet) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per C++.

Requisiti di piattaforma

Speech SDK per C++ è compatibile con Windows, Linux e macOS.

In Windows è necessario usare l'architettura di destinazione a 64 bit. È necessario Windows 10 o versione successiva.

Installare Microsoft Visual C++ Redistributable per Visual Studio 2015, 2017, 2019 e 2022 per la piattaforma. L'installazione di questo pacchetto per la prima volta potrebbe richiedere un riavvio.

Installare Speech SDK per C++

Speech SDK per C++ è disponibile come pacchetto NuGet. Per altre informazioni, vedere Microsoft.CognitiveServices.Speech.

Speech SDK per C++ può essere installato dall'interfaccia della riga di comando di .NET usando il comando seguente dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

È possibile seguire queste guide per altre opzioni.

Questa guida illustra come installare Speech SDK per Linux.

Usare la procedura seguente per scaricare e installare l'SDK. I passaggi includono il download delle librerie e dei file di intestazione necessari come file di .tar .

  1. Scegliere una directory per i file speech SDK. Impostare la SPEECHSDK_ROOT variabile di ambiente in modo che punti a tale directory. La variabile semplifica il riferimento alla directory nei comandi futuri.

    Per usare la directory speechsdk nella home directory, eseguire il comando seguente:

    export SPEECHSDK_ROOT="$HOME/speechsdk"
    
  2. Creare la directory se non esiste:

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. Scaricare ed estrarre l'archivio .tar.gz che contiene i file binari di 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. Convalidare il contenuto della directory di primo livello del pacchetto estratto:

    ls -l "$SPEECHSDK_ROOT"
    

    L'elenco di directory deve contenere le notifiche dei partner e i file di licenza. L'elenco deve contenere anche una directory di inclusione che contiene file di intestazione (h) e una directory lib che contiene librerie per arm32, arm64, x64 e x86.

    Percorso Descrizione
    license.md Licenza
    ThirdPartyNotices.md Comunicazioni dei partner
    Redist Avviso di ridistribuzione
    include File di intestazione obbligatori per C++
    lib/arm32 Libreria nativa per ARM32 necessaria per collegare l'applicazione
    lib/arm64 Libreria nativa per ARM64 necessaria per collegare l'applicazione
    lib/x64 Libreria nativa per x64 necessaria per collegare l'applicazione
    lib/x86 Libreria nativa per x86 necessaria per collegare l'applicazione

Pacchetto della documentazione di riferimento | (Go) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per Go.

Requisiti di piattaforma

Attenzione

Questo articolo fa riferimento a CentOS, una distribuzione Linux vicina allo stato end of life (EOL). Prendere in considerazione l'uso e la pianificazione di conseguenza. Per altre informazioni, vedere le linee guida per la fine della vita di CentOS.

Speech SDK per Go supporta le distribuzioni seguenti nell'architettura x64:

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

Importante

Usare la versione LTS più recente della distribuzione linux. Ad esempio, se si usa Ubuntu 20.04 LTS, usare la versione più recente di Ubuntu 20.04.X.

Speech SDK dipende dalle librerie di sistema Linux seguenti:

  • Le librerie condivise della libreria GNU C, inclusa la libreria di programmazione thread POSIX, libpthreads.
  • Libreria OpenSSL (libssl) versione 1.x e certificati (ca-certificates).
  • Libreria condivisa per le applicazioni ALSA (libasound).

È anche necessario installare ca-certificates per stabilire un websocket sicuro ed evitare l'errore WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED .

Importante

Speech SDK non supporta ancora OpenSSL 3.0, che è l'impostazione predefinita in Ubuntu 22.04 e Debian 12.

Eseguire i comandi seguenti:

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

Installare il file binario Go versione 1.13 o successiva.

Installare Speech SDK per Go

Usare la procedura seguente per scaricare e installare l'SDK. I passaggi includono il download delle librerie e dei file di intestazione necessari come file di .tar .

  1. Scegliere una directory per i file speech SDK. Impostare la SPEECHSDK_ROOT variabile di ambiente in modo che punti a tale directory. La variabile semplifica il riferimento alla directory nei comandi futuri.

    Per usare la directory speechsdk nella home directory, eseguire il comando seguente:

    export SPEECHSDK_ROOT="$HOME/speechsdk"
    
  2. Creare la directory se non esiste:

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. Scaricare ed estrarre l'archivio .tar.gz che contiene i file binari di 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. Convalidare il contenuto della directory di primo livello del pacchetto estratto:

    ls -l "$SPEECHSDK_ROOT"
    

    L'elenco di directory deve contenere le notifiche dei partner e i file di licenza. L'elenco deve contenere anche una directory di inclusione che contiene file di intestazione (h) e una directory lib che contiene librerie per arm32, arm64, x64 e x86.

    Percorso Descrizione
    license.md Licenza
    ThirdPartyNotices.md Comunicazioni dei partner
    Redist Avviso di ridistribuzione
    include File di intestazione obbligatori per C++
    lib/arm32 Libreria nativa per ARM32 necessaria per collegare l'applicazione
    lib/arm64 Libreria nativa per ARM64 necessaria per collegare l'applicazione
    lib/x64 Libreria nativa per x64 necessaria per collegare l'applicazione
    lib/x86 Libreria nativa per x86 necessaria per collegare l'applicazione

Configurare l'ambiente Go

I passaggi seguenti consentono all'ambiente Go di trovare Speech SDK.

  1. Poiché le associazioni si basano su cgo, è necessario impostare le variabili di ambiente in modo che Go possa trovare l'SDK.

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

    Importante

    Sostituire <architecture> con l'architettura del processore della CPU: x86, x64, arm32o arm64.

  2. Per eseguire applicazioni e SDK, è necessario indicare al sistema operativo dove trovare le librerie.

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

    Importante

    Sostituire <architecture> con l'architettura del processore della CPU: x86, x64, arm32o arm64.

Documentazione di riferimento | Esempi aggiuntivi su GitHub

In questa guida introduttiva si installa Speech SDK per Java.

Requisiti di piattaforma

Scegliere l'ambiente di destinazione:

Speech SDK per Java è compatibile con Windows, Linux e macOS.

In Windows è necessario usare l'architettura di destinazione a 64 bit. È necessario Windows 10 o versione successiva.

Installare Microsoft Visual C++ Redistributable per Visual Studio 2015, 2017, 2019 e 2022 per la piattaforma. L'installazione di questo pacchetto per la prima volta potrebbe richiedere un riavvio.

Speech SDK per Java non supporta Windows in ARM64.

Installare un Java Development Kit, ad esempio Azul Zulu OpenJDK. Dovrebbe funzionare anche Microsoft Build di OpenJDK o il JDK preferito.

Installare Speech SDK per Java

Alcune delle istruzioni usano una versione specifica dell'SDK, 1.24.2ad esempio . Per controllare la versione più recente, cercare il repository GitHub.

Scegliere l'ambiente di destinazione:

Questa guida illustra come installare Speech SDK per Java in Java Runtime.

Sistemi operativi supportati

Il pacchetto Speech SDK per Java è disponibile per questi sistemi operativi:

  • Windows: solo a 64 bit.
  • Mac: macOS X versione 10.14 o successiva.
  • Linux: vedere le distribuzioni e le architetture di destinazione linux supportate.

Seguire questa procedura per installare Speech SDK per Java usando Apache Maven:

  1. Installare Apache Maven.

  2. Aprire un prompt dei comandi in cui si vuole il nuovo progetto e creare un nuovo file pom.xml .

  3. Copiare il contenuto XML seguente in 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.36.0</version>
            </dependency>
        </dependencies>
    </project>
    
  4. Eseguire il comando Maven seguente per installare Speech SDK e le dipendenze.

    mvn clean dependency:copy-dependencies
    

Pacchetto della documentazione di riferimento | (npm) | Esempi aggiuntivi nel codice sorgente della libreria GitHub |

In questa guida introduttiva si installa Speech SDK per JavaScript.

Speech SDK per JavaScript è disponibile come pacchetto npm. Vedere microsoft-cognitiveservices-speech-sdk e il repository GitHub complementare cognitive-services-speech-sdk-js.

Requisiti di piattaforma

Comprendere le implicazioni dell'architettura tra Node.js e web browser client. Ad esempio, il modello DOM (Document Object Model) non è disponibile per le applicazioni lato server. Il file system Node.js non è disponibile per le applicazioni lato client.

Installare Speech SDK per JavaScript

A seconda dell'ambiente di destinazione, usare una delle guide seguenti:

Questa guida illustra come installare Speech SDK per JavaScript per l'uso con Node.js.

  1. Installare Node.js.

  2. Creare una nuova directory, eseguire npm inite esaminare le istruzioni.

  3. Per installare Speech SDK per JavaScript, eseguire il comando seguente npm install :

    npm install microsoft-cognitiveservices-speech-sdk
    

Per altre informazioni, vedere gli esempi di Node.js.

Usare Speech SDK

  • Aggiungere l'istruzione import seguente per usare Speech SDK nel progetto JavaScript:

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

Per altre informazioni su import, vedere Esportare e importare nel sito Web JavaScript.

In alternativa, è possibile usare un'istruzione require:

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

Pacchetto della documentazione di riferimento | (download) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per Objective-C.

Suggerimento

Per altre informazioni sull'uso di Speech SDK per Swift, vedere Importazione di Objective-C in Swift.

Installare Speech SDK per Objective-C

Speech SDK per Objective-C è disponibile in modo nativo come pacchetto CocoaPod per sistemi mac x64 e basati su ARM.

Requisiti di sistema per Mac:

  • MacOS versione 10.14 o successiva

Il pacchetto macOS CocoaPod è disponibile per il download e l'uso con l'ambiente di sviluppo integrato (IDE) Xcode 9.4.1 o versione successiva.

  1. Passare alla directory Xcode in cui si trova il file di progetto con estensione xcodeproj .

  2. Eseguire pod init per creare un file pod denominato Podfile.

  3. Sostituire il contenuto di Podfile con il contenuto seguente. Aggiornare il target nome da AppName al nome dell'app. Aggiornare la versione della piattaforma o del pod in base alle esigenze.

    platform :osx, 10.14
    use_frameworks!
    
    target 'AppName' do
      pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.36.0'
    end
    
  4. Eseguire pod install per installare Speech SDK.

In alternativa, scaricare il file binario CocoaPod ed estrarre il relativo contenuto. Nel progetto Xcode aggiungere un riferimento alla cartella MicrosoftCognitiveServicesSpeech.xcframework estratta e al relativo contenuto.

Nota

Gli sviluppatori .NET possono compilare applicazioni macOS native usando il framework dell'applicazione Xamarin.Mac. Per altre informazioni, vedere Xamarin.Mac.

Pacchetto della documentazione di riferimento | (download) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per Swift.

Suggerimento

Per altre informazioni sull'uso di Speech SDK per Swift, vedere Importazione di Objective-C in Swift.

Installare Speech SDK per Swift

Speech SDK per Swift è disponibile in modo nativo come pacchetto CocoaPod per sistemi mac x64 e basati su ARM.

Requisiti di sistema per Mac:

  • MacOS versione 10.14 o successiva

Il pacchetto macOS CocoaPod è disponibile per il download e l'uso con l'ambiente di sviluppo integrato (IDE) Xcode 9.4.1 o versione successiva.

  1. Passare alla directory Xcode in cui si trova il file di progetto con estensione xcodeproj .

  2. Eseguire pod init per creare un file pod denominato Podfile.

  3. Sostituire il contenuto di Podfile con il contenuto seguente. Aggiornare il target nome da AppName al nome dell'app. Aggiornare la versione della piattaforma o del pod in base alle esigenze.

    platform :osx, 10.14
    use_frameworks!
    
    target 'AppName' do
      pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.36.0'
    end
    
  4. Eseguire pod install per installare Speech SDK.

In alternativa, scaricare il file binario CocoaPod ed estrarre il relativo contenuto. Nel progetto Xcode aggiungere un riferimento alla cartella MicrosoftCognitiveServicesSpeech.xcframework estratta e al relativo contenuto.

Nota

Gli sviluppatori .NET possono compilare applicazioni macOS native usando il framework dell'applicazione Xamarin.Mac. Per altre informazioni, vedere Xamarin.Mac.

Pacchetto della documentazione di riferimento | (PyPi) | Esempi aggiuntivi in GitHub

In questa guida introduttiva si installa Speech SDK per Python.

Requisiti di piattaforma

Speech SDK per Python è compatibile con Windows, Linux e macOS.

In Windows è necessario usare l'architettura di destinazione a 64 bit. È necessario Windows 10 o versione successiva.

Installare Microsoft Visual C++ Redistributable per Visual Studio 2015, 2017, 2019 e 2022 per la piattaforma. L'installazione di questo pacchetto per la prima volta potrebbe richiedere un riavvio.

Importante

Assicurarsi che i pacchetti della stessa architettura di destinazione siano installati. Ad esempio, se si installa il pacchetto ridistribuibile x64, installare il pacchetto Python x64.

Installare una versione di Python dalla versione 3.7 o successiva.

  • Per controllare l'installazione, aprire un terminale ed eseguire il comando python --version. Se Python è installato correttamente, si ottiene una risposta come Python 3.8.10.

  • Se si usa macOS o Linux, potrebbe essere necessario eseguire il comando python3 --version .

    Per abilitare l'uso di invece di pythonpython3, eseguire alias python='python3' per configurare un alias. Gli esempi di avvio rapido di Speech SDK specificano python l'utilizzo.

Installare Speech SDK per Python

Prima di installare Speech SDK per Python, assicurarsi di soddisfare i requisiti della piattaforma.

Eseguire l'installazione da PyPI

Per installare Speech SDK per Python, eseguire questo comando in una finestra della console:

pip install azure-cognitiveservices-speech

Eseguire l'aggiornamento alla versione più recente di Speech SDK

Per eseguire l'aggiornamento alla versione più recente di Speech SDK, eseguire questo comando nella finestra della console:

pip install --upgrade azure-cognitiveservices-speech

È possibile verificare quale versione di Speech SDK per Python è attualmente installata controllando la azure.cognitiveservices.speech.__version__ variabile. Ad esempio, eseguire questo comando in una finestra della console:

pip list

Usare Speech SDK

Aggiungere l'istruzione import seguente per usare Speech SDK nel progetto Python:

import azure.cognitiveservices.speech as speechsdk