Início rápido: instalar o SDK de Speech

Documentação de referência | Pacote (NuGet) | Exemplos adicionais no GitHub

Neste início rápido, você vai instalar o Speech SDK para C#.

Requisitos de plataforma

O SDK de Fala para C# é compatível com Windows, Linux e macOS.

No Windows, você precisa usar a arquitetura de destino de 64 bits. O Windows 11 ou posterior é necessário.

Instale os Pacotes Redistribuíveis do Visual C++ para Visual Studio 2015, 2017, 2019 e 2022 na sua plataforma. Quando você instalar esse pacote pela primeira vez, poderá ser necessária uma reinicialização.

Instalar o SDK de Fala para C#

O SDK de Fala para C# está disponível como um pacote NuGet e implementa o .NET Standard 2.0. Para obter mais informações, confira Microsoft.CognitiveServices.Speech.

O SDK de Fala para C# pode ser instalado a partir da CLI do .NET usando o seguinte comando dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

Documentação de referência | Pacote (NuGet) | Exemplos adicionais no GitHub

Neste início rápido, você vai instalar o Speech SDK para C++.

Requisitos de plataforma

O SDK de Fala para C++ é compatível com Windows, Linux e macOS.

No Windows, você precisa usar a arquitetura de destino de 64 bits. O Windows 11 ou posterior é necessário.

Instale os Pacotes Redistribuíveis do Visual C++ para Visual Studio 2015, 2017, 2019 e 2022 para a sua plataforma. Quando você instalar esse pacote pela primeira vez, poderá ser necessária uma reinicialização.

Instalar o SDK de Fala para C++

O SDK de Fala para C++ está disponível como um pacote NuGet. Para obter mais informações, confira Microsoft.CognitiveServices.Speech.

O SDK de Fala para C++ pode ser instalado a partir da CLI do .NET usando o seguinte comando dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

Você pode consultar estes guias para obter mais opções.

Este guia mostra como instalar o Speech SDK para Linux.

Use o procedimento a seguir para baixar e instalar o SDK. As etapas incluem o download das bibliotecas e dos arquivos de cabeçalho necessários em um arquivo .tar.

  1. Escolha um diretório para os arquivos do SDK de Fala. Defina a variável de ambiente SPEECHSDK_ROOT para apontar para esse local. Essa variável facilita fazer referência a esse diretório em futuros comandos.

    Para usar o diretório speechsdk no seu diretório base, execute o seguinte comando:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Crie o diretório se ele não existir:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Baixe e extraia o arquivo compactado .tar.gz que contém os binários do SDK de Fala:

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

  4. Valide o conteúdo do diretório de nível superior do pacote extraído:

    ls -l "$SPEECHSDK_ROOT"

    A listagem do diretório deve conter avisos de parceiros e arquivos de licença. A listagem também deve conter um diretório de inclusão que contém arquivos de cabeçalho (.h) e um diretório lib que contém bibliotecas para arm32, arm64 e x64.

    Path Description
    license.md License
    ThirdPartyNotices.md Avisos do parceiro
    REDIST.txt Aviso de redistribuição
    include Arquivos de cabeçalho necessários para C++
    lib/arm32 A biblioteca nativa para ARM32 necessária para vincular o aplicativo
    lib/arm64 Biblioteca nativa para ARM64 necessária para vincular seu aplicativo
    lib/x64 Biblioteca nativa para x64 necessária para vincular o aplicativo

Documentação de referência | Pacote (Go) | Exemplos adicionais no GitHub

Neste início rápido, instale o Speech SDK para Go.

Requisitos de plataforma

O SDK de Fala para Go dá suporte às seguintes distribuições na arquitetura x64:

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

Important

Use a versão LTS mais recente da distribuição do Linux. Por exemplo, se você estiver usando o Ubuntu 20.04 LTS, use a versão mais recente do Ubuntu 20.04.X.

O SDK de Fala depende das seguintes bibliotecas do sistema Linux:

  • As bibliotecas compartilhadas da biblioteca GNU C, incluindo a biblioteca de programação de threads POSIX, libpthreads.
  • A biblioteca OpenSSL, a versão 1.x (libssl1) ou 3.x (libssl3) e certificados (ca-certificates).
  • A biblioteca compartilhada para aplicativos ALSA (libasound2).

Execute os comandos a seguir:

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

Instale a versão 1.13 ou posterior do binário Go.

Instalar o SDK de Fala para Go

Use o procedimento a seguir para baixar e instalar o SDK. As etapas incluem o download das bibliotecas e dos arquivos de cabeçalho necessários em um arquivo .tar.

  1. Escolha um diretório para os arquivos do SDK de Fala. Defina a variável de ambiente SPEECHSDK_ROOT para apontar para esse local. Essa variável facilita fazer referência a esse diretório em futuros comandos.

    Para usar o diretório speechsdk no seu diretório base, execute o seguinte comando:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Crie o diretório se ele não existir:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Baixe e extraia o arquivo .tar.gz que contém os binários do SDK de Fala:

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

  4. Valide o conteúdo do diretório de nível superior do pacote extraído:

    ls -l "$SPEECHSDK_ROOT"

    A listagem do diretório deve conter avisos de parceiros e arquivos de licença. A listagem também deve conter um diretório de inclusão que contém arquivos de cabeçalho (.h) e um diretório lib que contém bibliotecas para arm32, arm64 e x64.

    Path Description
    license.md License
    ThirdPartyNotices.md Avisos do parceiro
    REDIST.txt Aviso de redistribuição
    include Arquivos de cabeçalho necessários para C++
    lib/arm32 Biblioteca nativa para ARM32 necessária para vincular seu aplicativo
    lib/arm64 Biblioteca nativa para ARM64 necessária para vincular seu aplicativo
    lib/x64 Biblioteca nativa para x64 necessária para vincular o aplicativo

Configurar o ambiente Go

As etapas a seguir permitem que o ambiente Go encontre o SDK de Fala.

  1. Como os bindings dependem de cgo, você precisa definir as variáveis de ambiente para que o Go possa encontrar o SDK.

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

    Important

    Substitua <architecture> pela arquitetura do processador de sua CPU: x64, arm32 ou arm64.

  2. Para executar aplicativos e o SDK, você precisa informar ao sistema operacional onde encontrar as bibliotecas.

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

    Important

    Substitua <architecture> pela arquitetura do processador de sua CPU: x64, arm32 ou arm64.

Documentação de referência | Exemplos adicionais no GitHub

Neste início rápido, você instalará o Speech SDK para Java.

Requisitos de plataforma

Escolha o ambiente de destino:

O SDK de Fala para Java é compatível com Windows, Linux e macOS.

No Windows, você precisa usar a arquitetura de destino de 64 bits. O Windows 11 ou posterior é necessário.

Instale os Pacotes Redistribuíveis do Visual C++ para Visual Studio 2015, 2017, 2019 e 2022 na sua plataforma. Quando você instalar esse pacote pela primeira vez, poderá ser necessária uma reinicialização.

O SDK de Fala para Java não dá suporte ao Windows no ARM64.

Instalar um Kit de Desenvolvimento do Java, como o Azul Zulu OpenJDK. O Build da Microsoft do OpenJDK ou seu JDK preferencial também deve funcionar.

Instalar o SDK de Fala para Java

Algumas das instruções usam uma versão específica do SDK, como 1.43.0. Para verificar a versão mais recente, pesquise nosso repositório do GitHub.

Escolha o ambiente de destino:

Este guia mostra como instalar o Speech SDK para Java no Java Runtime.

Sistemas operacionais suportados

O pacote do SDK de Fala para Java está disponível para estes sistemas operacionais:

Siga estas etapas para instalar o SDK de Fala para Java usando o Apache Maven:

  1. Instale o Apache Maven.

  2. Abra um prompt de comando onde você deseja o novo projeto e crie um novo arquivo pom.xml.

  3. Copie o conteúdo XML a seguir em 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. Execute o comando Maven a seguir para instalar o Speech SDK e as dependências.

    mvn clean dependency:copy-dependencies

Documentação de referência | Pacote (npm) | Exemplos adicionais no GitHub | Código-fonte da biblioteca

Neste início rápido, você instalará o Speech SDK para JavaScript.

O SDK de Fala para JavaScript está disponível como um pacote npm. Confira microsoft-cognitiveservices-speech-sdk e o respectivo repositório complementar do GitHub, cognitive-services-speech-sdk-js.

Requisitos de plataforma

Compreender as implicações arquitetônicas entre o Node.js e os navegadores da Web do cliente. Por exemplo, o Document Object Model (DOM) não está disponível para aplicativos no lado do servidor. O sistema de arquivos Node.js não está disponível para aplicativos do lado do cliente.

Instale o Speech SDK para JavaScript

Dependendo do ambiente de destino, use um dos seguintes guias:

Este guia mostra como instalar o Speech SDK para JavaScript para uso com o Node.js.

  1. Instale o Node.js.

  2. Crie um diretório, execute npm init e acompanhe os prompts.

  3. Para instalar o SDK de Fala para JavaScript, execute o comando npm install:

    npm install microsoft-cognitiveservices-speech-sdk

Para obter mais informações, confira os Exemplos do Node.js.

Usar o SDK de Voz

  • Adicione a seguinte instrução de importação para usar o SDK de Fala em seu projeto JavaScript:

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

Para obter mais informações sobre import, consulte Exportar e Importar no site do JavaScript.

Como alternativa, você pode usar uma instrução require:

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

Documentação de referência | Pacote (download) | Exemplos adicionais no GitHub

Neste início rápido, você instalará o Speech SDK para Objective-C.

Tip

Para obter mais informações sobre como usar o SDK de Fala para Swift, confira Importação do Objective-C para Swift.

Instalar o SDK de Fala para Objective-C

Instale o SDK de Fala para Objective-C no Mac com o Swift Gerenciador de Pacotes.

Requisitos do sistema para o aplicativo Mac:

  • macOS 10.14 ou posterior

Use o Xcode 12 ou versão posterior para adicionar o pacote Swift.

  1. Abra seu projeto .xcodeproj no Xcode.
  2. Selecione Arquivo>.
  3. Insira https://github.com/microsoft/speech-sdk-spm e selecione uma versão começando em 1.51.0.
  4. Adicione o MicrosoftCognitiveServicesSpeech-macOS produto ao target do aplicativo.

Como alternativa, baixe o binário do SDK e extraia seu conteúdo. No projeto Xcode, adicione uma referência à pasta MicrosoftCognitiveServicesSpeech.xcframework extraída e ao conteúdo dela.

Documentação de referência | Pacote (download) | Exemplos adicionais no GitHub

Neste início rápido, você instalará o Speech SDK para Swift.

Tip

Para obter mais informações sobre como usar o SDK de Fala para Swift, confira Importação do Objective-C para Swift.

Instalar o SDK de Fala para Swift

Instale o SDK de Fala para Swift no Mac com o Swift Gerenciador de Pacotes.

Requisitos do sistema para o aplicativo Mac:

  • macOS 10.14 ou posterior

Use o Xcode 12 ou posterior para adicionar o pacote Swift.

  1. Abra seu projeto .xcodeproj no Xcode.
  2. Selecione Arquivo>.
  3. Insira https://github.com/microsoft/speech-sdk-spm e selecione uma versão começando em 1.51.0.
  4. Adicione o MicrosoftCognitiveServicesSpeech-macOS produto ao target do app.

Como alternativa, baixe o binário do SDK e extraia o conteúdo. No projeto Xcode, adicione uma referência à pasta MicrosoftCognitiveServicesSpeech.xcframework extraída e ao conteúdo dela.

Documentação de referência | Pacote (PyPi) | Exemplos adicionais no GitHub

Neste início rápido, você instalará o Speech SDK para Python.

Requisitos de plataforma

O SDK de Fala para Python é compatível com Windows, Linux e macOS.

No Windows, você precisa usar a arquitetura de destino de 64 bits. O Windows 11 ou posterior é necessário.

Instale o Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 e 2022 para a sua plataforma. Quando você instalar esse pacote pela primeira vez, poderá ser necessária uma reinicialização.

Important

Certifique-se de que os pacotes da mesma arquitetura de destino estejam instalados. Por exemplo, se você instalar o pacote redistribuível x64, instale o pacote Python x64.

Instale uma versão do Python 3.8 ou posterior.

  • Para verificar sua instalação, abra um terminal e execute o comando python --version. Se o Python estiver instalado corretamente, você obterá uma resposta como Python 3.8.10.

  • Se você estiver usando macOS ou Linux, talvez precise executar o comando python3 --version em vez disso.

    Para habilitar o uso de python em vez de python3, execute alias python='python3' para configurar um alias. Os exemplos de início rápido do SDK de Fala especificam o uso de python.

Instalar o SDK de Fala para Python

Antes de instalar o SDK de Fala para Python, certifique-se de satisfazer os requisitos da plataforma.

Instalar via PyPI

Para instalar o SDK de Fala para Python, execute este comando em uma janela de console:

pip install azure-cognitiveservices-speech

Atualize para o SDK de Fala mais recente

Para atualizar para o SDK de Fala mais recente, execute este comando na janela do console:

pip install --upgrade azure-cognitiveservices-speech

Você pode verificar qual versão do SDK de Fala para Python está instalada no momento inspecionando a variável azure.cognitiveservices.speech.__version__. Por exemplo, execute este comando em uma janela do console:

pip list

Use o SDK de Speech

Adicione a seguinte instrução de importação para usar o Speech SDK em seu projeto do Python:

import azure.cognitiveservices.speech as speechsdk

Exemplos de código

Exemplos de código estão disponíveis no repositório Azure-Samples/cognitive-services-speech-sdk no GitHub. Há exemplos para C# (incluindo UWP (Plataforma Universal do Windows), C++, Java, JavaScript (incluindo Navegador e Node.js), Objective-C, Python e Swift. Exemplos de código para Go estão disponíveis no repositório Microsoft/cognitive-services-speech-sdk-go no GitHub.

Conteúdo relacionado

  • Última atualização em