Guida introduttiva: Riconoscimento vocale con Speech SDK per PythonQuickstart: Recognize speech with the Speech SDK for Python

Sono disponibili guide di avvio rapido anche per la sintesi vocale.Quickstarts are also available for speech-synthesis

Questo articolo illustra come usare i servizi Voce tramite Speech SDK per Python.This article shows how to use the Speech Services through the Speech SDK for Python. e spiega come riconoscere contenuti vocali dall'input del microfono.It illustrates how to recognize speech from microphone input.

PrerequisitiPrerequisites

  • Una chiave di sottoscrizione di Azure per i servizi Voce.An Azure subscription key for the Speech Services. È possibile ottenerne una gratuitamente.Get one for free.

  • Python 3.5 o versione successiva.Python 3.5 or later.

  • Il pacchetto Speech SDK per Python è disponibile per i sistemi operativi seguenti:The Python Speech SDK package is available for these operating systems:

    • Windows: x64 e x86.Windows: x64 and x86.
    • Mac: macOS X versione 10.12 o successiva.Mac: macOS X version 10.12 or later.
    • Linux: Ubuntu 16.04, Ubuntu 18.04, Debian 9 su architetture x64.Linux: Ubuntu 16.04, Ubuntu 18.04, Debian 9 on x64.
  • In Linux eseguire i comandi seguenti per installare i pacchetti richiesti:On Linux, run these commands to install the required packages:

    • In Ubuntu:On Ubuntu:

      sudo apt-get update
      sudo apt-get install build-essential libssl1.0.0 libasound2
      
    • In Debian 9:On Debian 9:

      sudo apt-get update
      sudo apt-get install build-essential libssl1.0.2 libasound2
      
  • In Windows è necessaria la versione di Microsoft Visual C++ Redistributable per Visual Studio 2019 per la piattaforma in uso.On Windows, you need the Microsoft Visual C++ Redistributable for Visual Studio 2019 for your platform.

Installare Speech SDKInstall the Speech SDK

Importante

Scaricando i componenti Speech SDK di Servizi cognitivi in questa pagina, si accetta la relativa licenza.By downloading any of the Speech SDK for Azure Cognitive Services components on this page, you acknowledge its license. Vedere le Condizioni di licenza software Microsoft per Speech SDK.See the Microsoft Software License Terms for the Speech SDK.

Questo comando installa il pacchetto di Python da PyPI per Speech SDK:This command installs the Python package from PyPI for the Speech SDK:

pip install azure-cognitiveservices-speech

Supporto e aggiornamentiSupport and updates

Gli aggiornamenti del pacchetto Speech SDK per Python sono distribuiti tramite PyPI e annunciati nelle Note sulla versione.Updates to the Speech SDK Python package are distributed via PyPI and announced in the Release notes. Se è disponibile una nuova versione, è possibile eseguire l'aggiornamento ad essa con il comando pip install --upgrade azure-cognitiveservices-speech.If a new version is available, you can update to it with the command pip install --upgrade azure-cognitiveservices-speech. Controllare la versione attualmente installata esaminando la variabile azure.cognitiveservices.speech.__version__.Check which version is currently installed by inspecting the azure.cognitiveservices.speech.__version__ variable.

Se si verifica un problema o manca una funzionalità, vedere le opzioni di supporto e assistenza.If you have a problem, or you're missing a feature, see Support and help options.

Creare un'applicazione Python che usi Speech SDKCreate a Python application that uses the Speech SDK

Eseguire l'esempioRun the sample

È possibile copiare il codice di esempio da questa guida introduttiva in un file di origine quickstart.py ed eseguirlo nell'ambiente di sviluppo integrato o nella console:You can copy the sample code from this quickstart to a source file quickstart.py and run it in your IDE or in the console:

python quickstart.py

In alternativa è possibile scaricare questa esercitazione della guida introduttiva come notebook Jupyter dal repository degli esempi di Speech SDK ed eseguirla come notebook.Or you can download this quickstart tutorial as a Jupyter notebook from the Speech SDK sample repository and run it as a notebook.

Codice di esempioSample code

import azure.cognitiveservices.speech as speechsdk

# Creates an instance of a speech config with specified subscription key and service region.
# Replace with your own subscription key and service region (e.g., "westus").
speech_key, service_region = "YourSubscriptionKey", "YourServiceRegion"
speech_config = speechsdk.SpeechConfig(subscription=speech_key, region=service_region)

# Creates a recognizer with the given settings
speech_recognizer = speechsdk.SpeechRecognizer(speech_config=speech_config)

print("Say something...")


# Starts speech recognition, and returns after a single utterance is recognized. The end of a
# single utterance is determined by listening for silence at the end or until a maximum of 15
# seconds of audio is processed.  The task returns the recognition text as result. 
# Note: Since recognize_once() returns only a single utterance, it is suitable only for single
# shot recognition like command or query. 
# For long-running multi-utterance recognition, use start_continuous_recognition() instead.
result = speech_recognizer.recognize_once()

# Checks result.
if result.reason == speechsdk.ResultReason.RecognizedSpeech:
    print("Recognized: {}".format(result.text))
elif result.reason == speechsdk.ResultReason.NoMatch:
    print("No speech could be recognized: {}".format(result.no_match_details))
elif result.reason == speechsdk.ResultReason.Canceled:
    cancellation_details = result.cancellation_details
    print("Speech Recognition canceled: {}".format(cancellation_details.reason))
    if cancellation_details.reason == speechsdk.CancellationReason.Error:
        print("Error details: {}".format(cancellation_details.error_details))

Installare e usare Speech SDK con Visual Studio CodeInstall and use the Speech SDK with Visual Studio Code

  1. Scaricare e installare una versione a 64 bit di Python, 3.5 o versione successiva, nel proprio computer.Download and install a 64-bit version of Python, 3.5 or later, on your computer.

  2. Scaricare e installare Visual Studio Code.Download and install Visual Studio Code.

  3. Aprire Visual Studio Code e installare l'estensione Python.Open Visual Studio Code and install the Python extension. Selezionare File > Preferenze > Estensioni dal menu.Select File > Preferences > Extensions from the menu. Cercare Python.Search for Python.

    Installare l'estensione Python

  4. Creare una cartella in cui archiviare il progetto.Create a folder to store the project in. Un esempio consiste nell'usare Esplora risorse.An example is by using Windows Explorer.

  5. In Visual Studio Code selezionare l'icona File.In Visual Studio Code, select the File icon. Quindi, aprire la cartella creata.Then open the folder you created.

    Aprire una cartella

  6. Creare un nuovo file di origine Python speechsdk.py, selezionando l'icona Nuovo file.Create a new Python source file, speechsdk.py, by selecting the new file icon.

    Creare un file

  7. Copiare, incollare e salvare il codice Python nel file appena creato.Copy, paste, and save the Python code to the newly created file.

  8. Inserire le informazioni sulla sottoscrizione dei servizi Voce.Insert your Speech Services subscription information.

  9. Se selezionato, un interprete Python verrà visualizzato sul lato sinistro della barra di stato nella parte inferiore della finestra.If selected, a Python interpreter displays on the left side of the status bar at the bottom of the window. In caso contrario, visualizzare un elenco di interpreti Python disponibili.Otherwise, bring up a list of available Python interpreters. Usare il riquadro comandi (CTRL+MAIUSC+P) e immettere Python: Select Interpreter (Python: Seleziona interprete).Open the command palette (Ctrl+Shift+P) and enter Python: Select Interpreter. Sceglierne uno appropriato.Choose an appropriate one.

  10. È possibile installare il pacchetto Speech SDK per Python da Visual Studio Code.You can install the Speech SDK Python package from within Visual Studio Code. È possibile farlo se non è stato ancora installato per l'interprete Python selezionato.Do that if it's not installed yet for the Python interpreter you selected. Per installare il pacchetto Speech SDK, aprire un terminale.To install the Speech SDK package, open a terminal. Visualizzare di nuovo il riquadro comandi (CTRL+MAIUSC+P) e immettere Terminal: Create New Integrated Terminal (Crea nuovo terminale integrato).Bring up the command palette again (Ctrl+Shift+P) and enter Terminal: Create New Integrated Terminal. Nel terminale visualizzato immettere il comando python -m pip install azure-cognitiveservices-speech oppure il comando appropriato per il sistema.In the terminal that opens, enter the command python -m pip install azure-cognitiveservices-speech or the appropriate command for your system.

  11. Per eseguire il codice di esempio, fare doppio clic su un punto qualsiasi all'interno dell'editor.To run the sample code, right-click somewhere inside the editor. Selezionare Run Python File in Terminal (Esegui file Python nel terminale).Select Run Python File in Terminal. Quando richiesto, pronunciare alcune parole.Speak a few words when you're prompted. Il testo trascritto viene visualizzato poco dopo.The transcribed text displays shortly afterward.

    Eseguire un esempio

In caso di problemi durante l'uso di queste istruzioni, consultare la più completa esercitazione su Python in Visual Studio Code.If you have issues following these instructions, refer to the more extensive Visual Studio Code Python tutorial.

Passaggi successiviNext steps