Démarrage rapide : Installer le SDK Speech

Documentation de référence | Package (NuGet) | Exemples supplémentaires sur GitHub

Dans ce guide de démarrage rapide, vous installerez le SDK Speech pour C#.

Plateforme requise

Le Kit de développement logiciel (SDK) Speech pour C# est compatible avec Windows, Linux et macOS.

Windows

Sur Windows, vous devez utiliser l’architecture cible 64 bits. Vous avez besoin de Windows 10 ou une version ultérieure.

Installez le Redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017, 2019 et 2022 pour votre plateforme. La toute première installation de ce package peut nécessiter un redémarrage.

Linux

Le kit de développement logiciel (SDK) Speech pour C# ne prend en charge que les distributions suivantes sur les architectures x64, ARM32 et ARM64 :

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Important

Utilisez la version LTS la plus récente de la distribution Linux. Par exemple, si vous utilisez Ubuntu 20.04 LTS, utilisez la dernière version d’Ubuntu 20.04.X.

Le SDK Speech dépend des bibliothèques système Linux suivantes :

• Les bibliothèques partagées de la bibliothèque C de GNU (notamment la bibliothèque de programmation POSIX Threads, libpthreads)
• Bibliothèque OpenSSL, version 1.x (libssl1) ou 3.x (libssl3) et certificats (ca-certificates).
• La bibliothèque partagée pour les applications ALSA (libasound2)

Ubuntu 20.04/22.04/24.04

Exécutez ces commandes :

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

Debian 11/12

Exécutez ces commandes :

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

Amazon Linux 2023

Exécutez ces commandes :

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Exécutez ces commandes :

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

La version macOS 10.14 ou ultérieure est requise.

Installer le Kit SDK Speech pour C#

Le kit de développement logiciel (SDK) Speech pour C# est disponible en tant que package NuGet et implémente .NET Standard 2.0. Pour plus d’informations, consultez Microsoft.CognitiveServices.Speech.

Terminal

Le kit de développement logiciel (SDK) Speech pour C# peut être installé à partir de l’interface CLI .NET avec la commande dotnet add suivante :

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

Le kit de développement logiciel (SDK) Speech pour C# peut être installé à partir de la commande Install-Package suivante :

Install-Package Microsoft.CognitiveServices.Speech

Documentation de référence | Package (NuGet) | Exemples supplémentaires sur GitHub

Dans ce guide de démarrage rapide, vous installerez le SDK Speech pour C++.

Plateforme requise

Le Kit de développement logiciel (SDK) Speech pour C++ est compatible avec Windows, Linux et macOS.

Windows

Sur Windows, vous devez utiliser l’architecture cible 64 bits. Vous avez besoin de Windows 10 ou une version ultérieure.

Installez le Redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017, 2019 et 2022 pour votre plateforme. La toute première installation de ce package peut nécessiter un redémarrage.

Linux

Le kit de développement logiciel (SDK) Speech pour C++ ne prend en charge que les distributions suivantes sur les architectures x64, ARM32 et ARM64 :

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Important

Utilisez la version LTS la plus récente de la distribution Linux. Par exemple, si vous utilisez Ubuntu 20.04 LTS, utilisez la dernière version d’Ubuntu 20.04.X.

Le SDK Speech dépend des bibliothèques système Linux suivantes :

• Les bibliothèques partagées de la bibliothèque C de GNU (notamment la bibliothèque de programmation POSIX Threads, libpthreads)
• Bibliothèque OpenSSL, version 1.x (libssl1) ou 3.x (libssl3) et certificats (ca-certificates).
• La bibliothèque partagée pour les applications ALSA (libasound2)

Ubuntu 20.04/22.04/24.04

Exécutez ces commandes :

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

Debian 11/12

Exécutez ces commandes :

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

Amazon Linux 2023

Exécutez ces commandes :

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Exécutez ces commandes :

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

La version macOS 10.14 ou ultérieure est requise.

Installer le Kit SDK Speech pour C++

Le kit de développement logiciel (SDK) Speech pour C++ est disponible en tant que package NuGet. Pour plus d’informations, consultez Microsoft.CognitiveServices.Speech.

Terminal

Le SDK Speech pour C++ peut être installé à partir de l’interface CLI .NET avec la commande dotnet add suivante :

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

Le SDK Speech pour C++ peut être installé à partir de la commande Install-Package suivante :

Install-Package Microsoft.CognitiveServices.Speech

Vous pouvez suivre ces guides pour plus d’options.

Linux

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour Linux.

Utilisez la procédure suivante pour télécharger et installer le SDK. Les étapes incluent le téléchargement des bibliothèques et fichiers d’en-tête requis sous la forme d’un fichier .tar.

1. Choisissez un répertoire pour les fichiers du SDK Speech. Définissez la variable d’environnement SPEECHSDK_ROOT afin quelle pointe vers ce répertoire. Cette variable facilite ensuite la référence au répertoire dans les futures commandes.

   Pour utiliser le répertoire speechsdk dans votre répertoire de base, utilisez la commande suivante :

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Créez le répertoire s’il n’existe pas.

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Téléchargez et extrayez l’archive tar.gz contenant les fichiers binaires du kit SDK Speech :

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

4. Validez le contenu du répertoire de niveau supérieur du package extrait :

   ls -l "$SPEECHSDK_ROOT"
   

   La liste des répertoires doit comprendre les avis de partenaires et les fichiers de licences. La liste doit également comprendre un répertoire inclure qui contient les fichiers (.h) d’en-tête et un répertoire lib qui comporte les bibliothèques pour arm32, arm64, x64 et x86.

   Chemin	Descriptif
   license.md	Licence
   ThirdPartyNotices.md	Avis de partenaire
   REDIST.txt	Avis de redistribution
   inclure	Fichiers d’en-tête nécessaires pour C++
   lib/arm32	Bibliothèque native ARM32 nécessaire pour lier votre application
   lib/arm64	Bibliothèque native ARM64 nécessaire pour lier votre application
   \lib\x64	Bibliothèque native pour x64 requise pour lier votre application
   lib/x86	Bibliothèque native pour x86 requise pour lier votre application

macOS

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour C++ sur macOS 10.14 ou versions ultérieures. Les étapes incluent le téléchargement des bibliothèques et fichiers d’en-tête requis sous la forme d’un fichier .zip.

1. Choisissez un répertoire pour les fichiers du SDK Speech. Définissez la variable d’environnement SPEECHSDK_ROOT afin quelle pointe vers ce répertoire. Cette variable facilite ensuite la référence au répertoire dans les futures commandes.

   Pour utiliser le répertoire speechsdk dans votre répertoire de base, utilisez la commande suivante :

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Créez le répertoire s’il n’existe pas.

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Téléchargez et extrayez l’archive .zip contenant le XCFramework du kit SDK Speech :

   wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
   unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
   

4. Validez le contenu du répertoire de niveau supérieur du package extrait :

   ls -l "$SPEECHSDK_ROOT"
   

   La liste des répertoires doit contenir les avis de partenaires et les fichiers de licences, ainsi qu’un répertoire MicrosoftCognitiveServicesSpeech.xcframework.

Windows

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour C++ sur les systèmes d’exploitation Windows.

Ce guide d’installation nécessite les éléments suivants :

• Redistributable Microsoft Visual C++ pour Microsoft Visual Studio pour la plateforme Windows. Son installation pour la première fois peut nécessiter un redémarrage.
• Visual Studio.

Créer un projet dans Visual Studio et installer le Kit de développement logiciel (SDK) Speech

Pour créer un projet Visual Studio pour le développement Desktop en C++, vous devez :

• Configurer les options de développement de Visual Studio.
• Créez le projet.
• Sélectionner l’architecture cible.
• Installer le kit SDK Speech.

Configurer les options de développement de Visual Studio

Pour commencer, vérifiez que Visual Studio est configuré correctement pour le développement Desktop en C++ :

1. Ouvrez Visual Studio 2019 pour afficher la fenêtre de démarrage.

2. Sélectionnez Continuer sans code pour accéder à l’IDE Visual Studio.

   

3. Dans la barre de menus de Visual Studio, sélectionnez Outils>Obtenir les outils et fonctionnalités pour ouvrir Visual Studio Installer et afficher la boîte de dialogue Modification.

4. Sous l’onglet Charges de travail, sous Windows, recherchez la charge de travail Développement Desktop avec C++. Si la charge de travail n’est pas déjà sélectionnée, faites-le.

   

5. Dans l’onglet Composants individuels, recherchez Gestionnaire de package NuGet. Si l’option n’est pas déjà sélectionnée, faites-le.

6. Sélectionnez Fermer ou Modifier. Le nom du bouton varie selon que vous avez sélectionné ou non des fonctionnalités pour l’installation.

   Si vous sélectionnez Modifier, l’installation commence. Le processus peut prendre un certain temps.

7. Fermez Visual Studio Installer.

Créer le projet

Ensuite, créez votre projet et sélectionnez l’architecture cible :

1. Dans le menu Visual Studio, sélectionnez Fichier>Nouveau>Projet pour afficher la fenêtre Créer un projet.

2. Recherchez et sélectionnez Application console. Veillez à sélectionner la version C++ de ce type de projet, et non pas la version C# ou Visual Basic.

3. Cliquez sur Suivant.

   

4. Dans la boîte de dialogue Configurer votre nouveau projet, dans Nom du projet, entrez helloworld.

5. Dans Emplacement, accédez au dossier où vous voulez enregistrer votre projet et sélectionnez-le (ou bien créez un dossier), puis sélectionnez Créer.

   

6. Sélectionnez l’architecture de votre plateforme cible. Dans la barre d’outils Visual Studio, recherchez la zone de liste déroulante Plateformes de solutions. Si vous ne la voyez pas, sélectionnezAfficher>Barres d’outils>Standard pour afficher la barre d’outils qui contient Plateformes Solution.

   Si vous exécutez Windows 64 bits, sélectionnez x64 dans la zone de liste déroulante. Windows 64 bits peut aussi exécuter les applications 32 bits : vous pouvez donc choisir x86 si vous préférez.

Installer le Kit de développement logiciel (SDK) Speech avec Visual Studio

Enfin, installez le package NuGet du SDK Speech et référencez le SDK Speech dans votre projet :

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur la solution, puis sélectionnez Gérer les packages NuGet pour la solution pour accéder à la fenêtre NuGet – Solution.

2. Sélectionnez Parcourir.

3. Dans Source du package, sélectionnez nuget.org.

   

4. Dans la zone de recherche, entrez Microsoft.CognitiveServices.Speech. Choisissez ensuite ce package une fois qu’il apparaît dans les résultats de la recherche.

5. Dans le volet d’état du package en regard des résultats de la recherche, sélectionnez votre projet helloworld.

6. Sélectionnez Installer.

   

7. Dans la boîte de dialogue Aperçu des modifications, sélectionnez OK.

8. Dans la boîte de dialogue Acceptation de la licence, affichez la licence, puis sélectionnez J’accepte. L’installation du package commence. Une fois l’installation terminée, le volet Sortie affiche un message similaire au texte suivant : Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.

Documentation de référence | Package (Go) | Exemples supplémentaires sur GitHub

Dans ce guide de démarrage rapide, vous installerez le SDK Speech pour Go.

Plateforme requise

Le SDK Speech pour Go ne prend en charge que les distributions suivantes sur l’architecture x64 :

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

Important

Utilisez la version LTS la plus récente de la distribution Linux. Par exemple, si vous utilisez Ubuntu 20.04 LTS, utilisez la dernière version d’Ubuntu 20.04.X.

Le SDK Speech dépend des bibliothèques système Linux suivantes :

• Les bibliothèques partagées de la bibliothèque C de GNU (notamment la bibliothèque de programmation POSIX Threads, libpthreads)
• Bibliothèque OpenSSL, version 1.x (libssl1) ou 3.x (libssl3) et certificats (ca-certificates).
• La bibliothèque partagée pour les applications ALSA (libasound2)

Ubuntu 20.04/22.04/24.04

Exécutez ces commandes :

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

Debian 11/12

Exécutez ces commandes :

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

Amazon Linux 2023

Exécutez ces commandes :

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Exécutez ces commandes :

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

Installez la version binaire Go 1.13 ou ultérieure.

Installer le Kit SDK Speech pour Go

Utilisez la procédure suivante pour télécharger et installer le SDK. Les étapes incluent le téléchargement des bibliothèques et fichiers d’en-tête requis sous la forme d’un fichier .tar.

1. Choisissez un répertoire pour les fichiers du SDK Speech. Définissez la variable d’environnement SPEECHSDK_ROOT afin quelle pointe vers ce répertoire. Cette variable facilite ensuite la référence au répertoire dans les futures commandes.

   Pour utiliser le répertoire speechsdk dans votre répertoire de base, utilisez la commande suivante :

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. Créez le répertoire s’il n’existe pas.

   mkdir -p "$SPEECHSDK_ROOT"
   

3. Téléchargez et extrayez l’archive tar.gz contenant les fichiers binaires du kit SDK Speech :

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

4. Validez le contenu du répertoire de niveau supérieur du package extrait :

   ls -l "$SPEECHSDK_ROOT"
   

   La liste des répertoires doit comprendre les avis de partenaires et les fichiers de licences. La liste doit également comprendre un répertoire inclure qui contient les fichiers (.h) d’en-tête et un répertoire lib qui comporte les bibliothèques pour arm32, arm64, x64 et x86.

   Chemin	Descriptif
   license.md	Licence
   ThirdPartyNotices.md	Avis de partenaire
   REDIST.txt	Avis de redistribution
   inclure	Fichiers d’en-tête nécessaires pour C++
   lib/arm32	Bibliothèque native ARM32 nécessaire pour lier votre application
   lib/arm64	Bibliothèque native ARM64 nécessaire pour lier votre application
   \lib\x64	Bibliothèque native pour x64 requise pour lier votre application
   lib/x86	Bibliothèque native pour x86 requise pour lier votre application

Configurer l’environnement Go

Les étapes suivantes permettent à votre environnement Go de trouver le SDK Speech.

1. Étant donné que les liaisons s’appuient sur cgo, vous devez définir les variables d’environnement pour que Go puisse trouver le SDK.

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

   Important

   Remplacez <architecture> par l’architecture de votre processeur : x64, arm32 ou arm64.

2. Pour exécuter des applications et le SDK, vous devez indiquer au système d’exploitation où trouver les bibliothèques.

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

   Important

   Remplacez <architecture> par l’architecture de votre processeur : x64, arm32 ou arm64.

Documentation de référence | Exemples supplémentaires sur GitHub

Dans ce guide de démarrage rapide, vous installez le SDK Speech pour Java.

Plateforme requise

Choisissez votre environnement cible :

Java Runtime

Le Kit de développement logiciel (SDK) Speech pour Java est compatible avec Windows, Linux et macOS.

Windows

Sur Windows, vous devez utiliser l’architecture cible 64 bits. Vous avez besoin de Windows 10 ou une version ultérieure.

Installez le Redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017, 2019 et 2022 pour votre plateforme. La toute première installation de ce package peut nécessiter un redémarrage.

Le SDK Speech pour Java ne prend pas en charge Windows sur ARM64.

Linux

Le kit de développement logiciel (SDK) Speech pour Java prend en charge les distributions suivantes sur les architectures x64, ARM32 et ARM64 :

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Important

Utilisez la version LTS la plus récente de la distribution Linux. Par exemple, si vous utilisez Ubuntu 20.04 LTS, utilisez la dernière version d’Ubuntu 20.04.X.

Le SDK Speech dépend des bibliothèques système Linux suivantes :

• Les bibliothèques partagées de la bibliothèque C de GNU (notamment la bibliothèque de programmation POSIX Threads, libpthreads)
• Bibliothèque OpenSSL, version 1.x (libssl1) ou 3.x (libssl3) et certificats (ca-certificates).
• La bibliothèque partagée pour les applications ALSA (libasound2)

Ubuntu 20.04/22.04/24.04

Exécutez ces commandes :

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

Debian 11/12

Exécutez ces commandes :

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

Amazon Linux 2023

Exécutez ces commandes :

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Exécutez ces commandes :

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

La version macOS 10.14 ou ultérieure est requise.

Android

Le kit SDK Speech est compatible avec les appareils Android équipés de processeurs ARM 32/64 bits et Intel x86/x64 compatibles.

Installez un kit de développement Java tel que Azul Zulu OpenJDK. La build Microsoft d’OpenJDK ou le JDK de votre choix doivent également fonctionner.

Installer le Kit de développement logiciel (SDK) Speech pour Java

Certaines instructions utilisent une version spécifique du Kit de développement logiciel (SDK) comme 1.43.0. Pour vérifier la dernière version, recherchez dans notre dépôt GitHub.

Choisissez votre environnement cible :

Java Runtime

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour Java sur le runtime Java.

Systèmes d’exploitation pris en charge

Le Kit de développement logiciel (SDK) Speech pour le package Java est disponible pour les systèmes d’exploitation suivants :

• Windows : 64 bits uniquement.
• Mac : macOS X version 10.14 ou ultérieure.
• Linux : consultez les architectures cibles et distributions Linux prises en charge.

Maven

Procédez comme suit pour installer le Kit de développement logiciel (SDK) Speech pour Java à l’aide d’Apache Maven :

1. Installez Apache Maven.

2. Ouvrez une invite de commandes à l’emplacement où vous souhaitez placer le nouveau projet, puis créez un fichier pom.xml.

3. Copiez le contenu XML suivant dans 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. Exécutez la commande Maven suivante pour installer le kit de développement logiciel (SDK) Speech et les dépendances.

   mvn clean dependency:copy-dependencies
   

Éclipse

Créer un projet Eclipse et installer le Kit de développement logiciel (SDK) Speech

1. Installez l’IDE Java Eclipse. Cet IDE nécessite que Java soit déjà installé.

2. Démarrez Eclipse.

3. Dans la zone Espace de travail de l’utilitaire Eclipse Launcher, entrez le nom d’un nouveau répertoire d’espace de travail. Sélectionnez ensuite Launch (Lancer).

   

4. La fenêtre principale de l’IDE Eclipse apparaît au bout d’un instant. Fermez l’écran d’accueil s’il en existe un.

5. Dans le menu Eclipse, sélectionnez Fichier>Nouveau>Projet.

6. La boîte de dialogue Nouveau projet apparaît. Sélectionnez Projet Java, puis Suivant.

   

7. L’Assistant New Java Project (Nouveau projet Java) démarre. Dans le champ Nom du projet, entrez Démarrage rapide. Choisissez JavaSE-1.8 comme environnement d’exécution. Sélectionnez Terminer.

   

8. Si une fenêtre Open Associated Perspective? (Ouvrir la perspective associée ?) s’affiche, sélectionnez Open Perspective (Ouvrir la perspective).

9. Dans Package explorer, cliquez avec le bouton droit sur le projet Démarrage rapide. Sélectionnez Configurer>Convertir en projet Maven dans le menu contextuel.

   

10. La fenêtre Create new POM (Créer un POM) s’affiche. Dans le champ ID de groupe, entrez com.microsoft.cognitiveservices.speech.samples. Dans le champ ID d’artefact, entrez Démarrage rapide. Sélectionnez Terminer.

    

11. Ouvrez le fichier pom.xml et modifiez-le :

    1. Ajoutez un élément dependencies à la fin du fichier, avant la balise </project> fermante, avec le SDK Speech comme dépendance :

    <dependencies>
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.43.0</version>
      </dependency>
    </dependencies>
    

    1. Enregistrez les modifications.

Gradle

Configurations Gradle

Les configurations Gradle nécessitent une référence explicite à l’extension de dépendance .jar :

// build.gradle

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

Android

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour Java sur Android.

Le kit SDK Speech pour Android est empaqueté sous forme de fichier d’archive Android (AAR) qui inclut les bibliothèques et autorisations Android nécessaires.

Installer le Kit de développement logiciel (SDK) Speech avec Android Studio

Créez un projet dans Android Studio et ajoutez le Kit de développement logiciel (SDK) Speech pour Java en tant que dépendance de bibliothèque. La configuration se base sur le package Maven du SDK Speech et sur Android Studio Chipmunk 2021.2.1.

Créer un projet vide

1. Ouvrez Android Studio et sélectionnez Nouveau projet.

   

2. Dans la fenêtre Nouveau projet qui s’affiche, sélectionnez Téléphone et tablette>Activité vide, puis cliquez sur Suivant.

   

3. Entrez SpeechQuickstart dans la zone de texte Nom.

   

4. Saisissez samples.speech.cognitiveservices.microsoft.com dans la zone de texte Nom du package.

5. Sélectionnez un répertoire de projet dans la zone de sélection Enregistrer l’emplacement.

6. Sélectionnez Java dans la zone de sélection du Langage.

7. Sélectionnez l’API 26 : Android 8.0 (Oreo) dans la zone de sélection au niveau de l’API minimale .

8. Sélectionnez Terminer.

La préparation de votre nouveau projet par Android Studio peut prendre quelques minutes. Pour votre première utilisation d’Android Studio, la définition des préférences, l’acceptation des licences et l’exécution de l’Assistant peuvent prendre quelques minutes.

Installer le Kit de développement logiciel (SDK) Speech pour Java sur Android

Ajoutez le Kit de développement logiciel (SDK) Speech en tant que dépendance dans votre projet.

1. Cliquez sur Fichier>Structure du projet>Dépendances>app.

2. Sélectionnez le symbole plus (+) pour ajouter une dépendance sous Dépendances déclarées. Sélectionnez ensuite Dépendance de la bibliothèque dans le menu déroulant.

   

3. Dans la fenêtre Ajouter une dépendance de bibliothèque qui s’affiche, entrez le nom et la version du Kit de développement logiciel (SDK) Speech pour Java : com.microsoft.cognitiveservices.speech :client-sdk :1.43.0. Ensuite, sélectionner Rechercher.

4. Vérifiez que l’ID de groupe sélectionné est com.microsoft.cognitiveservices.speech, puis sélectionnez OK.

5. Sélectionnez OK pour fermer la fenêtre Structure du projet et appliquer vos modifications au projet.

Documentation de référence | Package (npm) | Exemples supplémentaires sur GitHub | Code source de la bibliothèque

Dans ce démarrage rapide, vous installerez le SDK Speech pour JavaScript.

Le kit de développement logiciel (SDK) Speech pour JavaScript est disponible en tant que package npm. Consultez microsoft-cognitiveservices-speech-sdk et le référentiel GitHub associé cognitive-services-speech-sdk-js.

Plateforme requise

Prenez soin de comprendre les implications architecturales entre Node.js et les navigateurs web clients. Par exemple, Document Object Model (DOM) n’est pas disponible pour les applications côté serveur. Le système de fichiers Node.js n’est pas disponible pour les applications côté client.

Installer le SDK Speech pour JavaScript

Selon l’environnement cible, utilisez l’un des guides suivants :

Node.JS

Ce guide explique comment installer le Kit de développement logiciel (SDK) Speech pour JavaScript pour une utilisation avec Node.js.

1. Installez Node.js.

2. Créez un répertoire, exécutez npm init et parcourez les invites.

3. Pour installer le kit SDK Speech pour JavaScript, exécutez la commande npm install suivante :

   npm install microsoft-cognitiveservices-speech-sdk
   

Pour plus d’informations, consultez Exemples Node.js.

Basé sur un navigateur

Ce guide explique comment installer le SDK Speech pour JavaScript pour une utilisation avec une page web.

Décompresser dans un dossier

1. Créez un dossier vide. Si vous voulez héberger l’exemple sur un serveur web, vérifiez que le serveur web peut accéder au dossier.

2. Téléchargez le SDK Speech en tant que package .zip, puis décompressez-le dans le dossier que vous venez de créer. Ces fichiers sont décompressés :

   • microsoft.cognitiveservices.speech.sdk.bundle.js : version explicite du SKD Speech.
   • microsoft.cognitiveservices.speech.sdk.bundle.js.map : un fichier de mappage utilisé pour déboguer le code du SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.d.ts : définitions d’objets à utiliser avec TypeScript.
   • microsoft.cognitiveservices.speech.sdk.bundle-min.js : version minimisée du SDK Speech.
   • speech-processor.js : code permettant d’améliorer les performances dans certains navigateurs.

3. Créez un fichier nommé index.html dans le dossier, puis ouvrez-le dans un éditeur de texte.

Balise de script HTML

Téléchargez et extrayez le fichier microsoft.cognitiveservices.speech.sdk.bundle.js du Kit de développement logiciel (SDK) Speech pour JavaScript. Placez-le dans un dossier auquel votre fichier HTML peut accéder.

<script src="microsoft.cognitiveservices.speech.sdk.bundle.js"></script>;

Conseil

Si vous ciblez un navigateur web et que vous utilisez l’étiquette <script>, le préfixe sdk n’est pas nécessaire. Le préfixe sdk est un alias utilisé pour nommer le module require.

Vous pouvez également inclure directement une balise <script> dans l’élément HTML <head>, en vous basant sur le JSDelivr.

<script src="https://cdn.jsdelivr.net/npm/microsoft-cognitiveservices-speech-sdk@latest/distrib/browser/microsoft.cognitiveservices.speech.sdk.bundle-min.js">
</script>

Pour plus d’informations, consultez les exemples basés sur le navigateur.

Utiliser le SDK Speech

• Ajoutez l’instruction d’importation suivante pour utiliser le Kit de développement logiciel (SDK) Speech dans votre projet JavaScript :

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

Pour plus d’informations sur import, consultez Exporter et importer sur le site web JavaScript.

Vous pouvez également utiliser une instruction require :

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

Documentation de référence | Package (téléchargement) | Exemples supplémentaires sur GitHub

Dans ce démarrage rapide, vous installerez le SDK Speech pour Objective-C.

Conseil

Pour plus d’informations sur l’utilisation du kit de développement logiciel (SDK) Speech pour Swift, consultez Importation d’Objective-C dans Swift.

Installer le Kit SDK Speech pour Objective-C

Mac

Le SDK Speech pour Objective-C est disponible en mode natif en tant que package CocoaPod pour les systèmes Mac x64 et ARM.

Configuration requise pour Mac :

• macOS version 10.14 ou ultérieure

Le package CocoaPod macOS est disponible pour téléchargement et peut être utilisé avec l’environnement de développement intégré (IDE) Xcode 9.4.1 (ou une version ultérieure).

1. Accédez au répertoire Xcode où se trouve votre fichier projet .xcodeproj.

2. Exécutez pod init pour créer un fichier pod nommé Podfile.

3. Remplacez le contenu de votre fichier Podfile par le contenu ci-dessous. Mettez à jour le nom target de AppName avec le nom de votre application. Mettez à jour la version de la plateforme ou du pod en fonction des besoins.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0'
   end
   

4. Exécutez pod install pour installer le SDK Speech.

Alternativement, vous pouvez télécharger le CocoaPod binaire et en extraire le contenu. Dans votre projet Xcode, ajoutez une référence au dossier MicrosoftCognitiveServicesSpeech.xcframework extrait et à son contenu.

Ios

Le SDK Speech pour Objective-C est disponible en natif sous forme de package CocoaPod.

Configuration requise pour iOS :

• macOS version 10.14 ou ultérieure
• cibler iOS 9.3 ou version ultérieure

Le package CocoaPod macOS est disponible pour téléchargement et peut être utilisé avec l’environnement de développement intégré (IDE) Xcode 9.4.1 (ou une version ultérieure).

1. Accédez au répertoire Xcode où se trouve votre fichier projet .xcodeproj.

2. Exécutez pod init pour créer un fichier pod nommé Podfile.

3. Remplacez le contenu de votre fichier Podfile par le contenu ci-dessous. Mettez à jour le nom target de AppName avec le nom de votre application. Mettez à jour la version de la plateforme ou du pod en fonction des besoins.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.0'
   end
   

4. Exécutez pod install pour installer le SDK Speech.

Alternativement, vous pouvez télécharger le CocoaPod binaire et en extraire le contenu. Dans votre projet Xcode, ajoutez une référence au dossier MicrosoftCognitiveServicesSpeech.xcframework extrait et à son contenu.

Documentation de référence | Package (téléchargement) | Exemples supplémentaires sur GitHub

Dans ce démarrage rapide, vous installerez le SDK Speech pour Swift.

Conseil

Pour plus d’informations sur l’utilisation du kit de développement logiciel (SDK) Speech pour Swift, consultez Importation d’Objective-C dans Swift.

Installer le Kit SDK Speech pour Swift

Mac

Le kit de développement logiciel (SDK) pour Swift est disponible en mode natif en tant que package CocoaPod pour les systèmes Mac x64 et ARM.

Configuration requise pour Mac :

• macOS version 10.14 ou ultérieure

Le package CocoaPod macOS est disponible pour téléchargement et peut être utilisé avec l’environnement de développement intégré (IDE) Xcode 9.4.1 (ou une version ultérieure).

1. Accédez au répertoire Xcode où se trouve votre fichier projet .xcodeproj.

2. Exécutez pod init pour créer un fichier pod nommé Podfile.

3. Remplacez le contenu de votre fichier Podfile par le contenu ci-dessous. Mettez à jour le nom target de AppName avec le nom de votre application. Mettez à jour la version de la plateforme ou du pod en fonction des besoins.

   platform :osx, 10.14
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0'
   end
   

4. Exécutez pod install pour installer le SDK Speech.

Alternativement, vous pouvez télécharger le CocoaPod binaire et en extraire le contenu. Dans votre projet Xcode, ajoutez une référence au dossier MicrosoftCognitiveServicesSpeech.xcframework extrait et à son contenu.

Ios

Le SDK Speech pour Swift est disponible en natif sous forme de package CocoaPod.

Configuration requise pour iOS :

• macOS version 10.14 ou ultérieure
• cibler iOS 9.3 ou version ultérieure

Le package CocoaPod macOS est disponible pour téléchargement et peut être utilisé avec l’environnement de développement intégré (IDE) Xcode 9.4.1 (ou une version ultérieure).

1. Accédez au répertoire Xcode où se trouve votre fichier projet .xcodeproj.

2. Exécutez pod init pour créer un fichier pod nommé Podfile.

3. Remplacez le contenu de votre fichier Podfile par l’élément suivant : Mettez à jour le nom target de AppName avec le nom de votre application. Mettez à jour la version de la plateforme ou du pod en fonction des besoins.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.0'
   end
   

4. Exécutez pod install pour installer le SDK Speech.

Alternativement, vous pouvez télécharger le CocoaPod binaire et en extraire le contenu. Dans votre projet Xcode, ajoutez une référence au dossier MicrosoftCognitiveServicesSpeech.xcframework extrait et à son contenu.

Documentation de référence | Package (PyPi) | Exemples supplémentaires sur GitHub

Dans ce démarrage rapide, vous installerez le SDK Speech pour Python.

Plateforme requise

Le Kit de développement logiciel (SDK) Speech pour Python est compatible avec Windows, Linux et macOS.

Windows

Sur Windows, vous devez utiliser l’architecture cible 64 bits. Vous avez besoin de Windows 10 ou une version ultérieure.

Installez le Redistribuable Microsoft Visual C++ pour Visual Studio 2015, 2017, 2019 et 2022 pour votre plateforme. La toute première installation de ce package peut nécessiter un redémarrage.

Important

Assurez-vous que les packages de la même architecture cible sont installés. Par exemple, si vous installez le package redistribuable x64, installez le package x64 Python.

Linux

Le kit SDK Speech pour Python prend en charge les distributions suivantes sur les architectures x64 et ARM64 :

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

Important

Utilisez la version LTS la plus récente de la distribution Linux. Par exemple, si vous utilisez Ubuntu 20.04 LTS, utilisez la dernière version d’Ubuntu 20.04.X.

Le SDK Speech dépend des bibliothèques système Linux suivantes :

• Les bibliothèques partagées de la bibliothèque C de GNU (notamment la bibliothèque de programmation POSIX Threads, libpthreads)
• Bibliothèque OpenSSL, version 1.x (libssl1) ou 3.x (libssl3) et certificats (ca-certificates).
• La bibliothèque partagée pour les applications ALSA (libasound2)

Ubuntu 20.04/22.04/24.04

Exécutez ces commandes :

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

Debian 11/12

Exécutez ces commandes :

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

Amazon Linux 2023

Exécutez ces commandes :

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Exécutez ces commandes :

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

La version macOS 10.14 ou ultérieure est requise.

Installez Python version 3.8 ou ultérieure.

• Pour vérifier votre installation, ouvrez un terminal et exécutez la commande python --version. Si Python est installé correctement, vous obtenez une réponse similaire à Python 3.8.10.

• Si vous utilisez macOS ou Linux, vous devrez peut-être exécuter la commande python3 --version à la place.

  Pour activer l’utilisation de python au lieu de python3, exécutez alias python='python3' pour configurer un alias. Les exemples de démarrage rapide du SDK Speech spécifient l’utilisation de python.

Installer le Kit SDK Speech pour Python

Avant d’installer le kit SDK Speech pour, assurez-vous de respecter les exigences de plateforme.

PyPI

Installer à partir de PyPI

Pour installer le kit SDK Speech pour Python, exécutez cette commande dans une fenêtre de la console.

pip install azure-cognitiveservices-speech

Passez à la dernière version du Kit de développement logiciel (SDK)

Pour effectuer une mise à niveau vers le kit SDK Speech le plus récent, exécutez cette commande dans une fenêtre de la console :

pip install --upgrade azure-cognitiveservices-speech

Vous pouvez vérifier la version du SDK Speech pour Python actuellement installée en inspectant la variable azure.cognitiveservices.speech.__version__. Par exemple, exécutez cette commande dans une fenêtre de la console :

pip list

Code Visual Studio

Installer le Kit de développement logiciel (SDK) Speech avec Visual Studio Code

Installez le Kit SDK Speech pour Python :

1. Téléchargez et installez Visual Studio Code.

2. Exécutez Visual Studio Code et installez l’extension Python :

   1. Sélectionnez Fichiers>Préférences>Extensions.
   2. Recherchez Python, recherchez l’extension python pour Visual Studio Code publiée par Microsoft, puis sélectionnez Installer.

   

3. Sélectionnez Terminal>Nouveau terminal pour ouvrir un terminal dans Visual Studio Code.

4. À l’invite du terminal, exécutez la commande suivante pour installer le kit de développement logiciel (SDK) Speech pour le package Python.

   python -m pip install azure-cognitiveservices-speech
   

Pour plus d’informations sur Visual Studio Code et Python, consultez Visual Studio Code et Prise en main avec Python dans VS Code.

Utiliser le SDK Speech

Ajoutez l’instruction d’importation suivante pour utiliser le Kit de développement logiciel (SDK) Speech dans votre projet Python :

import azure.cognitiveservices.speech as speechsdk

Exemples de code

Des échantillons détaillés sont disponibles dans le référentiel Azure-Samples/cognitive-services-speech-sdk sur GitHub. Il existe des exemples pour C# (y compris UWP et Unity), C++, Java, JavaScript (notamment Navigateur et Node.js), Objective-C, Python et Swift. Les exemples de code pour Go sont disponibles dans le référentiel Microsoft/cognitive-services-speech-sdk-go sur GitHub.

Contenu connexe

• Guide de démarrage rapide sur la reconnaissance vocale
• Démarrage rapide de la synthèse vocale
• Guide de démarrage rapide sur la traduction vocale