Guida introduttiva: Configurare l'ambiente di sviluppo

Scegliere l'ambiente di destinazione

Questa guida spiega come installare Speech SDK per .NET Framework (Windows). Se si vuole solo il nome del pacchetto per iniziare autonomamente, eseguire Install-Package Microsoft.CognitiveServices.Speech nella console NuGet.

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Prerequisiti

Questa guida introduttiva richiede:

Creare un progetto di Visual Studio e installare Speech SDK

Sarà necessario procedere all'installazione del pacchetto NuGet Speech SDK per potervi fare riferimento nel proprio codice. A tale scopo, è prima di tutto 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.

Creazione di un progetto HelloWorld

  1. Aprire Visual Studio 2019.

  2. Nella finestra iniziale selezionare Crea un nuovo progetto.

  3. Nella finestra Crea un nuovo progetto scegliere App console (.NET Framework) e quindi fare clic su Avanti.

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

  5. Dalla barra dei menu di Visual Studio scegliere strumenti > Ottieni strumenti e funzionalità, che consente di aprire programma di installazione di Visual Studio e visualizzare 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 è stato installato, selezionare la casella di controllo accanto ad esso e quindi fare clic su Modifica per avviare l'installazione. Il download e l'installazione può richiedere alcuni minuti.

    Se la casella di controllo accanto a Sviluppo per desktop .NET è già selezionata, fare clic su Chiudi per chiudere la finestra di dialogo.

    Abilitare lo sviluppo per 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 Gestione pacchetti NuGet.

    Gestione pacchetti NuGet

  2. Nell'angolo in alto a destra individuare la casella a discesa Origine dei pacchetti e assicurarsi che sia selezionata l'opzione nuget.org .

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

  4. Nella casella di ricerca digitare Microsoft.CognitiveServices.Speech e premere INVIO.

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

    Installare il 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 di piattaforma corrispondente all'architettura del computer.

  1. Dalla barra dei menu selezionare Compila > Configuration Manager. Verrà visualizzata finestra di dialogo Gestione configurazione.

    Finestra di dialogo Gestione configurazione

  2. Nella casella a discesa Piattaforma soluzione attiva selezionare Nuova. Verrà visualizzata la finestra di dialogo Nuova piattaforma soluzione.

  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.

Passaggi successivi

Scegliere l'ambiente di destinazione

Questa guida spiega come installare Speech SDK per Linux

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Requisiti di sistema

Linux: vedere l'elenco di distribuzioni Linux e architetture di destinazione supportate.

Prerequisiti

Vedere i requisiti di sistema e le istruzioni di configurazione in Linux.

Installare Speech SDK

Speech SDK per Linux è utilizzabile per compilare applicazioni sia a 64 bit che a 32 bit. Le librerie necessarie e i file di intestazione possono essere scaricati come file tar da https://aka.ms/csspeech/linuxbinary.

Scaricare e installare SDK come indicato di seguito:

  1. Scegliere una directory in cui estrarre i file di Speech SDK e impostare la SPEECHSDK_ROOT variabile di ambiente in modo che punti a tale directory. La variabile semplifica il riferimento alla directory nei comandi futuri. Ad esempio, se si desidera usare la directory speechsdk nella home directory, usare un comando simile al seguente:

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

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. Scaricare ed estrarre l'.tar.gzarchivio con 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 la notifica di terzi e i file di licenza, nonché una include directory contenente i file (.h) di intestazione e una lib directory contenente le librerie.

    Path Descrizione
    license.md Licenza
    ThirdPartyNotices.md Comunicazioni di terze parti
    REDIST.txt Avviso sulla ridistribuzione.
    include File di intestazione necessari per C e 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

Passaggi successivi

Scegliere l'ambiente di destinazione

Questa guida spiega come installare Speech SDK per Java 8 JRE a 64 bit. Se si vuole solo il nome del pacchetto per iniziare autonomamente, Java SDK non è disponibile nel repository centrale di Maven. Se si usa Gradle o un file di dipendenza pom.xml, è necessario aggiungere un repository personalizzato che punta a https://csspeechstorage.blob.core.windows.net/maven/ (vedere di seguito per il nome del pacchetto).

Nota

Per Speech Device SDK e il dispositivo Roobo, vedere Speech Devices SDK.

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Sistemi operativi supportati

Prerequisiti

Configurazione di Gradle

Le configle Gradle richiedono sia un repository personalizzato che un riferimento esplicito all'estensione della dipendenza .jar .

// build.gradle

repositories {
    maven {
        url "https://csspeechstorage.blob.core.windows.net/maven/"
    }
}

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

Creare un progetto di Eclipse e installare Speech SDK

  1. Avviare Eclipse.

  2. Nell’utilità di avvio di Eclipse, nel campo Area di lavoro, inserire il nome di una nuova directory dell’area di lavoro. Selezionare quindi Avvio.

    Screenshot dell'utilità di avvio di Eclipse

  3. Dopo qualche istante verrà visualizzata la finestra principale dell'IDE di Eclipse. Se è presente, chiudere la schermata iniziale.

  4. Dalla barra dei menu di Eclipse, creare un nuovo progetto selezionando File > Nuovo > Progetto.

  5. Verrà visualizzata la finestra di dialogo Nuovo progetto . Selezionare Progetto Java e selezionare Avanti.

    Screenshot della finestra di dialogo Nuovo progetto, con il progetto Java evidenziato

  6. Viene avviata la procedura guidata Nuovo progetto Java. Nel campo Nome progetto, inserire quickstart e selezionare JavaSE-1.8 come ambiente di esecuzione. Selezionare Fine.

    Screenshot della procedura guidata Nuovo progetto Java

  7. Se viene visualizzata la finestra Aprire prospettiva associata? , selezionare Apri prospettiva.

  8. In Esplora pacchetti, fare doppio clic sul progetto quickstart. Selezionare Configura > Converti in progetto Maven dal menu di scelta rapida.

    Screenshot di Esplora pacchetti

  9. Viene visualizzata la finestra Crea nuovo POM. Nel campo ID gruppo immettere com.microsoft.cognitiveservices.speech.samples e nel campo ID artefatto specificare quickstart. Quindi selezionare Fine.

    Screenshot di Crea nuova finestra POM

  10. Aprire il file pom.xml e modificarlo.

    • Alla fine del file, prima del tag di chiusura </project>, creare un elemento repositories con un riferimento al repository Maven per Speech SDK, come mostrato di seguito:

      <repositories>
        <repository>
          <id>maven-cognitiveservices-speech</id>
          <name>Microsoft Cognitive Services Speech Maven Repository</name>
          <url>https://csspeechstorage.blob.core.windows.net/maven/</url>
        </repository>
      </repositories>
      
    • Aggiungere anche un dependencies elemento, con la versione 1.15.0 dell'SDK vocale come dipendenza:

      <dependencies>
        <dependency>
          <groupId>com.microsoft.cognitiveservices.speech</groupId>
          <artifactId>client-sdk</artifactId>
          <version>1.12.1</version>
        </dependency>
      </dependencies>
      
    • Salvare le modifiche.

Passaggi successivi

Questa guida spiega come installare Speech SDK per Python. Se si vuole solo il nome del pacchetto per iniziare autonomamente, eseguire pip install azure-cognitiveservices-speech.

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Sistemi operativi supportati

Prerequisiti

Installare Speech SDK da PyPI

Se si usano un ambiente o strumenti di compilazione personalizzati, eseguire il comando seguente per installare Speech SDK da PyPI. Gli utenti di Visual Studio Code possono procedere con la sottosezione successiva per l'installazione guidata.

pip install azure-cognitiveservices-speech

Se si usa macOS, può essere necessario eseguire il comando seguente per il corretto funzionamento del comando pip precedente:

python3 -m pip install --upgrade pip

Dopo aver usato correttamente pip per installare azure-cognitiveservices-speech, è possibile usare Speech SDK importando lo spazio dei nomi nei progetti Python.

import azure.cognitiveservices.speech as speechsdk

Installare Speech SDK usando Visual Studio Code

  1. Scaricare e installare la versione più recente supportata di Python per la piattaforma, da 3.6 a 3.9.

    • Gli utenti di Windows dovranno assicurarsi di selezionare l'opzione per aggiungere Python a PATH durante il processo di installazione.
  2. Scaricare e installare Visual Studio Code.

  3. Aprire Visual Studio Code e installare l'estensione Python. Selezionare File > Preferenze > Estensioni dal menu. Cercare Python e fare clic su Installa.

    Installare l'estensione Python

  4. Sempre in Visual Studio Code, installare il pacchetto Speech SDK per Python dalla riga di comando integrata:

    1. Aprire un terminale scegliendo Terminale > Nuovo terminale dai menu a discesa.
    2. Nel terminale visualizzato immettere il comando python -m pip install azure-cognitiveservices-speech

Se non si ha familiarità con Visual Studio Code, vedere la Documentazione di Visual Studio Code. Per altre informazioni su Visual Studio Code e Python, vedere l'esercitazione su Visual Studio Code e Python.

Supporto e aggiornamenti

Gli aggiornamenti del pacchetto Speech SDK per Python sono distribuiti tramite PyPI e annunciati nelle Note sulla versione. Se è disponibile una nuova versione, è possibile eseguire l'aggiornamento ad essa con il comando pip install --upgrade azure-cognitiveservices-speech. Controllare la versione attualmente installata esaminando la variabile azure.cognitiveservices.speech.__version__.

Se si verifica un problema o manca una funzionalità, vedere le opzioni di supporto e assistenza.

Passaggi successivi

Questa guida spiega come installare Speech SDK per Linux

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Requisiti di sistema

Linux: vedere l'elenco di distribuzioni Linux e architetture di destinazione supportate.

Prerequisiti

Per completare questo argomento di avvio rapido, sono necessari gli elementi seguenti:

Installare Speech SDK

Speech SDK per Linux è utilizzabile per compilare applicazioni sia a 64 bit che a 32 bit. Le librerie necessarie e i file di intestazione possono essere scaricati come file tar da https://aka.ms/csspeech/linuxbinary.

Scaricare e installare SDK come indicato di seguito:

  1. Scegliere una directory in cui estrarre i file di Speech SDK e impostare la SPEECHSDK_ROOT variabile di ambiente in modo che punti a tale directory. La variabile semplifica il riferimento alla directory nei comandi futuri. Ad esempio, se si desidera usare la directory speechsdk nella home directory, usare un comando simile al seguente:

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

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. Scaricare ed estrarre l'.tar.gzarchivio con 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 la notifica di terzi e i file di licenza, nonché una include directory contenente i file (.h) di intestazione e una lib directory contenente le librerie.

    Path Descrizione
    license.md Licenza
    ThirdPartyNotices.md Comunicazioni di terze parti
    REDIST.txt Avviso sulla ridistribuzione.
    include File di intestazione necessari per C e 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

Eseguire la procedura seguente per configurare l'ambiente Go e trovare Speech SDK. In entrambi i passaggi sostituire <architecture> con l'architettura di processore della propria CPU. Può essere x86, x64, arm32 o arm64.

  1. Poiché i binding si basano su cgo, è necessario impostare le variabili di ambiente in modo che Go trovi l'SDK:

    export CGO_CFLAGS="-I$SPEECHSDK_ROOT/include/c_api"
    export CGO_LDFLAGS="-L$SPEECHSDK_ROOT/lib/<architecture> -lMicrosoft.CognitiveServices.Speech.core"
    
  2. Per eseguire le applicazioni, incluso l'SDK, è necessario indicare al sistema operativo dove trovare le librerie:

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

Passaggi successivi


Scegliere l'ambiente di destinazione

Questa guida spiega come installare Speech SDK per JavaScript per l'uso con una pagina Web.

Importante

Scaricando uno dei componenti Speech SDK di Servizi cognitivi, si accetta la relativa licenza. Per altre informazioni, vedere:

Creare una nuova cartella per il sito Web

Creare una nuova cartella vuota. Se si vuole ospitare l'esempio in un server Web, assicurarsi che il server Web possa accedere alla cartella.

Decomprimere Speech SDK per JavaScript nella cartella

Scaricare Speech SDK come pacchetto con estensione zip e decomprimerlo nella nuova cartella. Il risultato è la decompressione di cinque file:

  • microsoft.cognitiveservices.speech.sdk.bundle.js - Una versione leggibile di Speech SDK.
  • microsoft.cognitiveservices.speech.sdk.bundle.js.map - Un file di mapping usato per il debug del codice dell'SDK.
  • microsoft.cognitiveservices.speech.sdk.bundle.d.ts - Definizioni degli oggetti da usare con TypeScript
  • microsoft.cognitiveservices.speech.sdk.bundle-min.js - Una versione minimizzata di Speech SDK.
  • speech-processor.js - Codice per migliorare le prestazioni in alcuni browser.

Creare una pagina index.html

Creare un nuovo file nella cartella denominato index.html e aprirlo con un editor di testo.

Passaggi successivi