Das Speech-SDK für C# unterstützt nur die folgenden Distributionen für x64-, ARM32- und ARM64-Architekturen:
Ubuntu 20.04/22.04/24.04
Debian 11/12
Amazon Linux 2023
Azure Linux 3.0
Wichtig
Verwenden Sie das neueste LTS-Release der Linux-Distribution. Wenn Sie beispielsweise Ubuntu 20.04 LTS verwenden, verwenden Sie das neueste Release von Ubuntu 20.04.X.
Das Speech SDK hängt von den folgenden Linux-Systembibliotheken ab:
Freigegebene Bibliotheken der GNU C-Bibliothek, einschließlich der POSIX Threads Programming-Bibliothek, libpthreads.
Die OpenSSL-Bibliothek, Version 1.x (libssl1) oder 3.x (libssl3), und Zertifikate (ca-certificates).
Freigegebene Bibliothek für ALSA-Anwendungen (libasound2).
Es ist macOS-Version 10.14 oder höher erforderlich.
Installieren des Speech SDK für C#
Das Speech SDK für C# ist als NuGet-Paket verfügbar und implementiert .NET Standard 2.0. Weitere Informationen finden Sie unter Microsoft.CognitiveServices.Speech.
Erstellen eines Visual Studio-Projekts und Installieren des Speech SDK
Sie müssen das NuGet-Paket für das Speech SDK installieren, um in Ihrem Code darauf verweisen zu können. Hierzu muss ggf. zuerst ein Projekt vom Typ helloworld erstellt werden. Falls Sie bereits über ein Projekt mit der Workload .NET-Desktopentwicklung verfügen, können Sie dieses Projekt verwenden und direkt mit Installieren des Speech SDK mithilfe des NuGet-Paket-Managers fortfahren.
Erstellen eines helloworld-Projekts
Öffnen Sie Visual Studio.
Wählen Sie unter Erste Schritte die Option Neues Projekt erstellen aus.
Wählen Sie unter Neues Projekt erstellen die Option Konsolen-App (.NET Framework) und dann Weiter aus.
Geben Sie in Neues Projekt konfigurieren unter Projektname den Namen helloworld ein, und wählen Sie unter Speicherort den Verzeichnispfad aus, oder erstellen Sie ihn. Wählen Sie anschließend Erstellen aus.
Wählen Sie auf der Visual Studio-Menüleiste Extras>Tools und Features abrufen aus. Mit diesem Schritt wird der Visual Studio-Installer geöffnet und das Dialogfeld Änderung angezeigt.
Überprüfen Sie, ob die Workload .NET-Desktopentwicklung verfügbar ist. Wenn die Workload noch nicht installiert ist, aktivieren Sie das Kontrollkästchen, und wählen Sie dann Ändern aus, um die Installation zu starten. Das Herunterladen und Installieren kann einige Minuten dauern.
Ist .NET-Desktopentwicklung bereits aktiviert, wählen Sie Schließen aus, um das Dialogfeld zu schließen.
Schließen Sie den Visual Studio-Installer.
Installieren des Speech SDK mithilfe des NuGet-Paket-Managers
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt helloworld, und wählen Sie dann NuGet-Pakete verwalten aus, um den NuGet-Paket-Manager anzuzeigen.
Navigieren Sie oben rechts zum Dropdownfeld Paketquelle, und stellen Sie sicher, dass nuget.org ausgewählt ist.
Wählen Sie in der oberen linken Ecke Durchsuchen aus.
Geben Sie ins Suchfeld Microsoft.CognitiveServices.Speech ein, und drücken Sie die EINGABETASTE.
Wählen Sie in den Suchergebnissen das Paket Microsoft.CognitiveServices.Speech und anschließend Installieren aus, um die aktuelle stabile Version zu installieren.
Akzeptieren Sie alle Vereinbarungen und Lizenzen, um die Installation zu starten.
Nachdem das Paket installiert wurde, wird eine Bestätigung im Fenster Paket-Manager-Konsole angezeigt.
Auswählen der Zielarchitektur
Erstellen Sie eine Plattformkonfiguration, die der Architektur Ihres Computers entspricht, um die Konsolenanwendung zu erstellen und auszuführen.
Wählen Sie aus dem Menü Build>Konfigurations-Manager aus. Das Dialogfeld Konfigurations-Manager wird angezeigt.
Wählen Sie im Dropdownfeld Aktive Projektmappenplattform den Eintrag Neu aus. Das Dialogfeld Neue Projektmappenplattform wird angezeigt.
Gehen Sie im Feld Neue Plattform eingeben oder auswählen wie folgt vor:
Wenn Sie 64-Bit-Windows ausführen, wählen Sie x64 aus.
Wenn Sie 32-Bit-Windows ausführen, wählen Sie x86 aus.
Wählen Sie OK und dann Schließen aus.
In diesem Leitfaden erfahren Sie, wie Sie das Speech SDK für eine .NET Core-Konsolen-App installieren. .NET Core ist eine Open-Source- und plattformübergreifende .NET-Plattform, die die .NET Standard-Spezifikation implementiert.
Erstellen eines Visual Studio-Projekts und Installieren des Speech SDK
Starten Sie Visual Studio 2017.
Stellen Sie sicher, dass die Workload Plattformübergreifende .NET-Entwicklung verfügbar ist. Wählen Sie auf der Visual Studio-Menüleiste Extras>Tools und Features abrufen aus, um den Visual Studio-Installer zu öffnen. Wenn diese Workload bereits aktiviert ist, schließen Sie das Dialogfeld.
Wählen Sie andernfalls plattformübergreifende .NET Core-Entwicklung aus und wählen Sie Ändern aus. Die Installation des neuen Features nimmt etwas Zeit in Anspruch.
Erstellen Sie im Dialogfeld Neues Projekt eine neue Visual C# .NET Core-Konsolen-App. Erweitern Sie im linken Bereich Installiert>Visual C#>.NET Core. Wählen Sie dann Konsolen-App (.NET Core) aus. Geben Sie als Projektnamen helloworld ein.
Installieren Sie das Speech-SDK-NuGet-Paket. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und wählen Sie dann NuGet-Pakete für Projektmappe verwalten aus.
Wählen Sie Durchsuchen und dann in der rechten oberen Ecke nuget.org als Paketquelle aus.
Suchen Sie nach dem Paket Microsoft.CognitiveServices.Speech, und installieren Sie es im Projekt helloworld.
Akzeptieren Sie die angezeigten Lizenzbedingungen, um die Installation des NuGet-Pakets zu starten.
Nachdem das Paket installiert wurde, wird eine Bestätigung in der Paket-Manager-Konsole angezeigt.
In diesem Leitfaden erfahren Sie, wie Sie das Speech SDK für Unity installieren.
Für die Unity-Entwicklung unterstützt das Speech SDK Windows Desktop (x86 und x64) oder die universelle Windows-Plattform (x86, x64, ARM/ARM64) sowie Android (x86, ARM32/64), iOS (x64-Simulator und ARM64) und Mac (x64).
Unter Android ist ein für die Entwicklung aktiviertes ARM-basiertes Android-Gerät (API 23: ab Android 6.0 Marshmallow) mit einem funktionsfähigen Mikrofon erforderlich.
Unter iOS ist ein für die Entwicklung aktiviertes iOS-Gerät (ARM64) mit einem funktionsfähigen Mikrofon erforderlich.
Unter macOS ist ein Mac-Gerät (x64) und die neueste LTS-Version von Unity 2019 oder höher für die integrierte Unterstützung des Mikrofonzugriffs in den Unity Player-Einstellungen erforderlich.
Installieren des Speech SDK für Unity
Führen Sie die folgenden Schritte aus, um das Speech SDK für Unity zu installieren:
Laden Sie das Speech SDK für Unity herunter, und öffnen Sie es. Das SDK ist als Unity-Ressourcenpaket (.unitypackage) gepackt und sollte bereits mit Unity verknüpft sein. Nach dem Öffnen des Ressourcenpakets wird das Dialogfeld Import Unity Package (Unity-Paket importieren) angezeigt. Unter Umständen muss ein leeres Projekt erstellt und geöffnet werden, damit dieser Schritt funktioniert.
Vergewissern Sie sich, dass alle Dateien ausgewählt sind, und wählen Sie dann Import (Importieren) aus. Daraufhin wird das Unity-Ressourcenpaket in Ihr Projekt importiert.
Weitere Informationen zum Importieren von Ressourcenpaketen in Unity finden Sie in der Unity-Dokumentation.
In diesem Leitfaden erfahren Sie, wie Sie ein UWP-Projekt (Universelle Windows-Plattform) erstellen und das Speech SDK für C# installieren. Mithilfe der universellen Windows-Plattform können Sie Apps entwickeln, die auf einem beliebigen Gerät mit Unterstützung für Windows 10 (z.B. PCs, Xbox, Surface Hub und andere Geräte) ausgeführt werden.
Erstellen eines Visual Studio-Projekts und Installieren des Speech SDK
Die Erstellung eines Visual Studio-Projekts für die UWP-Entwicklung umfasst Folgendes:
Einrichten von Visual Studio-Entwicklungsoptionen
Erstellen des Projekts und Auswählen der Zielarchitektur
Einrichten der Audioaufnahme
Installieren des Speech SDK
Einrichten von Visual Studio-Entwicklungsoptionen
Stellen Sie sicher, dass Visual Studio ordnungsgemäß für die UWP-Desktopentwicklung eingerichtet ist:
Öffnen Sie Visual Studio, um das Startfenster anzuzeigen.
Wählen Sie Ohne Code fortfahren aus, um zur Visual Studio-IDE zu wechseln.
Wählen Sie auf der Visual Studio-Menüleiste Extras>Tools und Features abrufen aus, um den Visual Studio-Installer zu öffnen und das Dialogfeld Änderung anzuzeigen.
Suchen Sie auf der Registerkarte Workloads nach der Workload Entwicklung für die universelle Windows-Plattform. Wenn diese Workload bereits ausgewählt ist, schließen Sie das Dialogfeld Ändern, und schließen Sie Visual Studio-Installer. Überspringen Sie den Rest dieses Verfahrens.
Aktivieren Sie Entwicklung für die universelle Windows Plattform, und wählen Sie dann Ändern aus.
Wählen Sie im Dialogfeld Bevor wir loslegen die Option Weiter aus, um die Workload für die UWP-Entwicklung zu installieren. Die Installation des neuen Features kann etwas dauern.
Schließen Sie den Visual Studio-Installer.
Erstellen des Projekts
Erstellen Sie als Nächstes Ihr Projekt, und wählen Sie die Zielarchitektur aus:
Wählen Sie auf der Visual Studio-Menüleiste Datei>Neu>Projekt aus, um das Fenster Neues Projekt erstellen anzuzeigen.
Suchen und wählen Sie dann Leere App (universelles Windows) aus. Achten Sie darauf, dass Sie die C#-Version dieses Projekttyps auswählen, nicht Visual Basic.
Wählen Sie Weiter aus.
Geben Sie im Dialogfeld Neues Projekt konfigurieren unter Projektname die Zeichenfolge helloworld ein.
Navigieren Sie unter Speicherort zu dem Ordner, in dem Sie Ihr Projekt speichern möchten, und wählen Sie ihn aus, oder erstellen Sie einen entsprechenden Ordner.
Klicken Sie auf Erstellen.
Wählen Sie im Fenster Neues UWP-Projekt (Universelle Windows-Plattform) unter Mindestversion (zweites Dropdownfeld) die Option Windows 10 Fall Creators Update (10.0; Build 16299) aus. Dies ist die Mindestanforderung für das Speech SDK.
Wählen Sie unter Zielversion (das erste Dropdownfeld) einen Wert aus, der mit dem Wert in Mindestversion identisch oder höher ist.
Wählen Sie OK aus. Sie gehen zurück in die Visual Studio-IDE. Das neue Projekt ist erstellt und wird im Bereich Projektmappen-Explorer angezeigt.
Wählen Sie die Architektur Ihrer Zielplattform aus. Suchen Sie auf der Visual Studio-Symbolleiste das Dropdownfeld Projektmappenplattformen. (Sollte es nicht angezeigt werden, wählen Sie Ansicht>Symbolleisten>Standard aus, um die Symbolleiste mit Projektmappenplattformen anzuzeigen.)
Wählen Sie bei Verwendung der 64-Bit-Version von Windows x64 im Dropdownfeld aus. Mit 64-Bit-Windows können auch 32-Bit-Anwendungen ausgeführt werden, sodass Sie x86 wählen können, wenn Sie möchten.
Hinweis
Das Speech SDK unterstützt alle Intel-kompatiblen Prozessoren, jedoch nur x64-Versionen von ARM-Prozessoren.
Einrichten der Audioaufnahme
Lassen Sie zu, dass das Projekt Audioeingaben erfasst:
Wählen Sie im Projektmappen-Explorer auf Package.appxmanifest, um das Paketanwendungsmanifest zu öffnen.
Wählen Sie die Registerkarte Funktionen und dann die Funktion Mikrofon aus.
Wählen Sie auf der Menüleiste Datei>„Package.appxmanifest“ speichern aus, um Ihre Änderungen zu speichern.
Installieren des Speech SDK für UWP
Installieren Sie schließlich das Speech SDK-NuGet-Paket, und verweisen Sie in Ihrem Projekt auf das Speech SDK:
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, und wählen Sie NuGet-Pakete für Projektmappe verwalten aus, um zum Fenster NuGet – Projektmappe zu wechseln.
Wählen Sie Durchsuchen aus. Wählen Sie unter Paketquelle die Option nuget.org aus.
Geben Sie Microsoft.CognitiveServices.Speech in das Feld Suche ein. Wählen Sie das entsprechende Paket aus, wenn es in den Suchergebnissen angezeigt wird.
Wählen Sie im Statusbereich des Pakets neben den Suchergebnissen Ihr helloworld-Projekt aus.
Wählen Sie Installieren aus.
Wählen Sie im Dialogfeld Vorschau der Änderungen anzeigen die Option Anwenden aus.
Zeigen Sie im Dialogfeld Zustimmung zur Lizenz die Lizenz an, und wählen Sie dann Ich stimme zu. Die Paketinstallation beginnt.
Nach Abschluss der Installation wird im Bereich Ausgabe eine Meldung wie die folgende angezeigt: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.
In diesem Leitfaden erfahren Sie, wie Sie ein Xamarin-Formularprojekt erstellen und das Speech SDK installieren. Xamarin ist eine Open-Source-Plattform zur Entwicklung moderner und leistungsfähiger Anwendungen für iOS, Android und Windows mit .NET.
Für die Xamarin-Entwicklung unterstützt das Speech SDK Folgendes:
Erstellen eines Visual Studio-Projekts und Installieren des Speech SDK
Wenn Sie ein Visual Studio-Projekt für die plattformübergreifende Entwicklung mobiler Apps mit .NET und Xamarin erstellen möchten, sind folgende Schritte erforderlich:
Einrichten von Visual Studio-Entwicklungsoptionen
Erstellen des Projekts und Auswählen der Zielarchitektur
Installieren des Speech SDK
Einrichten von Visual Studio-Entwicklungsoptionen
Vergewissern Sie sich, dass Visual Studio ordnungsgemäß für die plattformübergreifende Entwicklung mobiler Apps mit .NET eingerichtet ist:
Öffnen Sie Visual Studio 2019. Wählen Sie dann Ohne Code fortfahren aus.
Wählen Sie im Visual Studio-Menü Extras>Tools und Features abrufen aus, um den Visual Studio-Installer zu öffnen und das Dialogfeld Änderung anzuzeigen.
Suchen Sie auf der Registerkarte Workloads nach der Workload Mobile-Entwicklung mit .NET. Wenn diese Workload bereits ausgewählt ist, schließen Sie das Dialogfeld Ändern, und schließen Sie Visual Studio-Installer. Überspringen Sie den Rest dieses Verfahrens.
Aktivieren Sie Mobile-Entwicklung mit .NET, und wählen Sie dann Ändern aus.
Wählen Sie im Dialogfeld Bevor wir loslegen die Option Weiter aus, um die Workload für die mobile Entwicklung mit .NET zu installieren. Die Installation des neuen Features kann etwas dauern.
Schließen Sie den Visual Studio-Installer.
Erstellen des Projekts
Erstellen Sie als Nächstes Ihr Projekt, und wählen Sie die Zielarchitektur aus:
Wählen Sie auf der Visual Studio-Menüleiste Datei>Neu>Projekt aus, um das Fenster Neues Projekt erstellen anzuzeigen.
Suchen Sie nach der Option Mobile App (Xamarin.Forms) , und wählen Sie sie aus.
Wählen Sie Weiter aus.
Geben Sie im Dialogfeld Neues Projekt konfigurieren unter Projektname die Zeichenfolge helloworld ein.
Navigieren Sie unter Speicherort zu dem Ordner, in dem Sie Ihr Projekt speichern möchten, und wählen Sie ihn aus, oder erstellen Sie einen entsprechenden Ordner.
Klicken Sie auf Erstellen.
Wählen Sie im Fenster Neue plattformübergreifende App die Vorlage Leer und dann Android, iOS und Windows (UWP) aus. Klicken Sie auf Erstellen.
Wählen Sie OK aus. Sie gehen zurück in die Visual Studio-IDE. Das neue Projekt ist erstellt und wird im Bereich Projektmappen-Explorer angezeigt.
Wählen Sie die Architektur Ihrer Zielplattform und das Startprojekt aus. Suchen Sie auf der Visual Studio-Symbolleiste das Dropdownfeld Projektmappenplattformen. (Sollte es nicht angezeigt werden, wählen Sie Ansicht>Symbolleisten>Standard aus, um die Symbolleiste mit Projektmappenplattformen anzuzeigen.)
Wählen Sie bei Verwendung der 64-Bit-Version von Windows x64 im Dropdownfeld aus. Falls gewünscht, können Sie auch x86 auswählen, da die 64-Bit-Version von Windows auch für 32-Bit-Anwendungen geeignet ist.
Wählen Sie im Dropdownfeld Startprojekte die Option helloworld.UWP (Universal Windows) aus.
Installieren des Speech SDK für Xamarin
Installieren Sie das Speech SDK-NuGet-Paket, und verweisen Sie in Ihrem Projekt auf das Speech SDK:
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihre Projektmappe. Wählen Sie NuGet-Pakete für Projektmappe verwalten aus, um zum Fenster NuGet – Projektmappe zu gelangen.
Wählen Sie Durchsuchen aus.
Wählen Sie unter Paketquelle die Option nuget.org aus.
Geben Sie Microsoft.CognitiveServices.Speech in das Feld Suche ein. Wählen Sie dann in den Suchergebnissen das entsprechende Paket aus.
Hinweis
Bitcode ist für die iOS-Bibliothek im NuGet-Paket Microsoft.CognitiveServices.Speech nicht aktiviert. Falls Sie die Bitcodebibliothek für Ihre Anwendung benötigen, verwenden Sie das NuGet-Paket Microsoft.CognitiveServices.Speech.Xamarin.iOS speziell für das iOS-Projekt.
Wählen Sie im Statusbereich des Pakets neben den Suchergebnissen alle Projekte aus.
Wählen Sie Installieren aus.
Wählen Sie im Dialogfeld Vorschau der Änderungen anzeigen die Option OK.
Zeigen Sie im Dialogfeld Zustimmung zur Lizenz die Lizenz an, und wählen Sie dann Ich stimme zu. Installieren Sie die Speech SDK-Paketreferenz für alle Projekte.
Nach erfolgreichem Abschluss der Installation wird für helloworld.iOS unter Umständen die folgende Warnung angezeigt. Diese Warnung ist ein bekanntes Problem, das sich nicht auf die Funktionalität Ihrer App auswirken sollte.
Could not resolve reference "C:\Users\Default\.nuget\packages\microsoft.cognitiveservices.speech\1.7.0\build\Xamarin.iOS\libMicrosoft.CognitiveServices.Speech.core.a". If this reference is required by your code, you may get compilation errors.
Das Speech SDK ist jetzt installiert. Das in den vorherigen Schritten erstellte Projekt helloworld kann nun gelöscht oder wiederverwendet werden.
Das Speech-SDK für C++ unterstützt nur die folgenden Distributionen für x64-, ARM32- und ARM64-Architekturen:
Ubuntu 20.04/22.04/24.04
Debian 11/12
Amazon Linux 2023
Azure Linux 3.0
Wichtig
Verwenden Sie das neueste LTS-Release der Linux-Distribution. Wenn Sie beispielsweise Ubuntu 20.04 LTS verwenden, verwenden Sie das neueste Release von Ubuntu 20.04.X.
Das Speech SDK hängt von den folgenden Linux-Systembibliotheken ab:
Freigegebene Bibliotheken der GNU C-Bibliothek, einschließlich der POSIX Threads Programming-Bibliothek, libpthreads.
Die OpenSSL-Bibliothek, Version 1.x (libssl1) oder 3.x (libssl3), und Zertifikate (ca-certificates).
Freigegebene Bibliothek für ALSA-Anwendungen (libasound2).
Wählen Sie ein Verzeichnis für die Dateien des Speech SDK aus. Legen Sie die Umgebungsvariable SPEECHSDK_ROOT so fest, dass sie auf dieses Verzeichnis verweist. Diese Variable erleichtert es, in zukünftigen Befehlen auf das Verzeichnis zu verweisen.
Um das Verzeichnis speechsdk in Ihrem Basisverzeichnis zu verwenden, führen Sie den folgenden Befehl aus:
export SPEECHSDK_ROOT="$HOME/speechsdk"
Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist:
mkdir -p "$SPEECHSDK_ROOT"
Laden Sie das .tar.gz-Archiv herunter, das die Speech SDK-Binärdateien enthält, und extrahieren Sie diese Dateien:
Überprüfen Sie den Inhalt des Verzeichnisses auf oberster Ebene des extrahierten Pakets:
ls -l "$SPEECHSDK_ROOT"
Die Verzeichnisauflistung sollte die Partnerhinweise und Lizenzdateien enthalten. Die Liste sollte auch ein Include-Verzeichnis mit Header-Dateien (.h) und ein Lib-Verzeichnis mit Bibliotheken für arm32, arm64, x64 und x86 enthalten.
Pfad
Beschreibung
license.md
Lizenz
ThirdPartyNotices.md
Partnerhinweise
REDIST.txt
Umverteilungshinweis
include
Erforderliche Headerdateien für C++
lib/arm32
Zum Linken Ihrer Anwendung ist die native Bibliothek für ARM32 erforderlich.
lib/arm64
Zum Linken Ihrer Anwendung ist die native Bibliothek für ARM64 erforderlich.
lib/x64
Zum Linken Ihrer Anwendung ist die native Bibliothek für x64 erforderlich.
lib/x86
Zum Linken Ihrer Anwendung ist die native Bibliothek für x86 erforderlich.
In diesem Leitfaden erfahren Sie, wie Sie das Speech SDK für C++ unter macOS 10.14 oder höher installieren. Die Schritte umfassen das Herunterladen der erforderlichen Bibliotheken und Headerdateien als .zip-Datei.
Wählen Sie ein Verzeichnis für die Dateien des Speech SDK aus. Legen Sie die Umgebungsvariable SPEECHSDK_ROOT so fest, dass sie auf dieses Verzeichnis verweist. Diese Variable erleichtert es, in zukünftigen Befehlen auf das Verzeichnis zu verweisen.
Um das Verzeichnis speechsdk in Ihrem Basisverzeichnis zu verwenden, führen Sie den folgenden Befehl aus:
export SPEECHSDK_ROOT="$HOME/speechsdk"
Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist:
mkdir -p "$SPEECHSDK_ROOT"
Laden Sie das .zip-Archiv mit Speech SDK XCFramework herunter, und extrahieren Sie es:
Erstellen eines Projekts in Visual Studio und Installieren des Speech SDK
Die Erstellung eines Visual Studio-Projekts für die C++-Desktopentwicklung umfasst Folgendes:
Einrichten von Visual Studio-Entwicklungsoptionen
Erstellen eines Projekts
Auswählen der Zielarchitektur
Installieren des Speech SDK
Einrichten von Visual Studio-Entwicklungsoptionen
Stellen Sie zunächst sicher, dass Visual Studio ordnungsgemäß für die C++-Desktopentwicklung eingerichtet ist:
Öffnen Sie Visual Studio 2019, um das Startfenster anzuzeigen.
Wählen Sie Ohne Code fortfahren aus, um zur Visual Studio-IDE zu wechseln.
Wählen Sie auf der Visual Studio-Menüleiste Extras>Tools und Features abrufen aus, um den Visual Studio-Installer zu öffnen und das Dialogfeld Änderung anzuzeigen.
Suchen Sie auf der Registerkarte Workloads unter Windows nach der Workload Desktopentwicklung mit C++. Wenn diese Workload nicht bereits aktiviert ist, aktivieren Sie sie.
Suchen Sie auf der Registerkarte Einzelne Komponenten nach NuGet-Paket-Manager. Wenn sie nicht bereits aktiviert ist, aktivieren Sie sie.
Wählen Sie Schließen oder Ändern aus. Der Name der Schaltfläche ist abhängig davon, ob Sie Features für die Installation ausgewählt haben.
Wenn Sie Ändern auswählen, beginnt die Installation. Der Prozess kann etwas dauern.
Schließen Sie den Visual Studio-Installer.
Erstellen des Projekts
Erstellen Sie als Nächstes Ihr Projekt, und wählen Sie die Zielarchitektur aus:
Wählen Sie aus dem Visual Studio-Menü Datei>Neu>Projekt aus, um das Fenster Neues Projekt erstellen anzuzeigen.
Suchen Sie die Option Konsolen-App, und wählen Sie sie aus. Achten Sie darauf, dass Sie die C++-Version dieses Projekttyps auswählen (nicht C# oder Visual Basic).
Wählen Sie Weiter aus.
Geben Sie im Dialogfeld Neues Projekt konfigurieren unter Projektname die Zeichenfolge helloworld ein.
Navigieren Sie unter Speicherort zu dem Ordner, in dem Sie Ihr Projekt speichern möchten, und wählen Sie ihn aus oder erstellen Sie ihn. Wählen Sie dann Erstellen aus.
Wählen Sie die Architektur Ihrer Zielplattform aus. Suchen Sie auf der Visual Studio-Symbolleiste das Dropdownfeld Projektmappenplattformen. (Sollte es nicht angezeigt werden, wählen Sie Ansicht>Symbolleisten>Standard aus, um die Symbolleiste mit Projektmappenplattformen anzuzeigen.)
Wählen Sie bei Verwendung der 64-Bit-Version von Windows x64 im Dropdownfeld aus. Mit 64-Bit-Windows können auch 32-Bit-Anwendungen ausgeführt werden, sodass Sie x86 wählen können, wenn Sie möchten.
Installieren des Speech SDK mithilfe von Visual Studio
Installieren Sie schließlich das Speech SDK-NuGet-Paket, und verweisen Sie in Ihrem Projekt auf das Speech SDK:
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihre Projektmappe, und wählen Sie anschließend NuGet-Pakete für Projektmappe verwalten aus, um zum Fenster NuGet – Projektmappe zu gelangen.
Wählen Sie Durchsuchen aus.
Wählen Sie unter Paketquelle die Option nuget.org aus.
Geben Sie Microsoft.CognitiveServices.Speech in das Feld Suche ein. Wählen Sie das entsprechende Paket aus, wenn es in den Suchergebnissen angezeigt wird.
Wählen Sie im Statusbereich des Pakets neben den Suchergebnissen Ihr helloworld-Projekt aus.
Wählen Sie Installieren aus.
Wählen Sie im Dialogfeld Vorschau der Änderungen anzeigen die Option OK.
Zeigen Sie im Dialogfeld Zustimmung zur Lizenz die Lizenz an, und wählen Sie dann Ich stimme zu. Die Paketinstallation beginnt. Nach Abschluss der Installation wird im Bereich Ausgabe eine Meldung wie die folgende angezeigt: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.
In diesem Schnellstart installieren Sie das Speech SDK für Go.
Plattformanforderungen
Das Speech SDK für Go unterstützt die folgenden Distributionen für die x64-Architektur:
Ubuntu 20.04/22.04/24.04
Debian 11/12
Wichtig
Verwenden Sie das neueste LTS-Release der Linux-Distribution. Wenn Sie beispielsweise Ubuntu 20.04 LTS verwenden, verwenden Sie das neueste Release von Ubuntu 20.04.X.
Das Speech SDK hängt von den folgenden Linux-Systembibliotheken ab:
Freigegebene Bibliotheken der GNU C-Bibliothek, einschließlich der POSIX Threads Programming-Bibliothek, libpthreads.
Die OpenSSL-Bibliothek, Version 1.x (libssl1) oder 3.x (libssl3), und Zertifikate (ca-certificates).
Freigegebene Bibliothek für ALSA-Anwendungen (libasound2).
Wählen Sie ein Verzeichnis für die Dateien des Speech SDK aus. Legen Sie die Umgebungsvariable SPEECHSDK_ROOT so fest, dass sie auf dieses Verzeichnis verweist. Diese Variable erleichtert es, in zukünftigen Befehlen auf das Verzeichnis zu verweisen.
Um das Verzeichnis speechsdk in Ihrem Basisverzeichnis zu verwenden, führen Sie den folgenden Befehl aus:
export SPEECHSDK_ROOT="$HOME/speechsdk"
Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist:
mkdir -p "$SPEECHSDK_ROOT"
Laden Sie das .tar.gz-Archiv herunter, das die Speech SDK-Binärdateien enthält, und extrahieren Sie diese Dateien:
Überprüfen Sie den Inhalt des Verzeichnisses auf oberster Ebene des extrahierten Pakets:
ls -l "$SPEECHSDK_ROOT"
Die Verzeichnisauflistung sollte die Partnerhinweise und Lizenzdateien enthalten. Die Liste sollte auch ein Include-Verzeichnis mit Header-Dateien (.h) und ein Lib-Verzeichnis mit Bibliotheken für arm32, arm64, x64 und x86 enthalten.
Pfad
Beschreibung
license.md
Lizenz
ThirdPartyNotices.md
Partnerhinweise
REDIST.txt
Umverteilungshinweis
include
Erforderliche Headerdateien für C++
lib/arm32
Zum Linken Ihrer Anwendung ist die native Bibliothek für ARM32 erforderlich.
lib/arm64
Zum Linken Ihrer Anwendung ist die native Bibliothek für ARM64 erforderlich.
lib/x64
Zum Linken Ihrer Anwendung ist die native Bibliothek für x64 erforderlich.
lib/x86
Zum Linken Ihrer Anwendung ist die native Bibliothek für x86 erforderlich.
Konfigurieren der Go-Umgebung
Mithilfe der folgenden Schritte können Sie Ihre Go-Umgebung für die Suche nach dem Speech SDK einrichten.
Da für die Bindungen cgo verwendet wird, müssen Sie die Umgebungsvariablen festlegen, damit das SDK von Go gefunden werden kann.
Das Speech SDK für Java unterstützt kein Windows auf ARM64.
Das Speech-SDK für Java unterstützt die folgenden Distributionen für x64-, ARM32- und ARM64-Architekturen:
Ubuntu 20.04/22.04/24.04
Debian 11/12
Amazon Linux 2023
Azure Linux 3.0
Wichtig
Verwenden Sie das neueste LTS-Release der Linux-Distribution. Wenn Sie beispielsweise Ubuntu 20.04 LTS verwenden, verwenden Sie das neueste Release von Ubuntu 20.04.X.
Das Speech SDK hängt von den folgenden Linux-Systembibliotheken ab:
Freigegebene Bibliotheken der GNU C-Bibliothek, einschließlich der POSIX Threads Programming-Bibliothek, libpthreads.
Die OpenSSL-Bibliothek, Version 1.x (libssl1) oder 3.x (libssl3), und Zertifikate (ca-certificates).
Freigegebene Bibliothek für ALSA-Anwendungen (libasound2).
In einigen Anweisungen wird eine bestimmte SDK-Version verwendet, z. B. 1.24.2. Um die neueste Version zu ermitteln, durchsuchen Sie unser GitHub-Repository.
Führen Sie den folgenden Maven-Befehl aus, um das Speech SDK und Abhängigkeiten zu installieren.
mvn clean dependency:copy-dependencies
Erstellen eines Eclipse-Projekts und Installieren des Sprach-SDK
Installieren Sie die Eclipse-Java-IDE. Diese IDE erfordert, dass Java bereits installiert ist.
Starten Sie Eclipse.
Geben Sie im Eclipse-Startprogramm im Feld Arbeitsbereich den Namen eines neuen Arbeitsbereichsverzeichnisses ein. Wählen Sie dann Starten aus.
Nach kurzer Zeit wird das Hauptfenster der Eclipse-IDE angezeigt. Schließen Sie den Begrüßungsbildschirm, sofern vorhanden.
Wählen Sie im Eclipse-Menü Datei>Neu>Projekt aus.
Das Dialogfeld Neues Projekt wird angezeigt. Wählen Sie Java-Projekt und dann Weiter aus.
Der Assistent für ein neues Java-Projekt wird gestartet. Geben Sie im Feld Projektname den Namen Schnellstart ein. Wählen Sie als Ausführungsumgebung JavaSE-1.8 aus. Wählen Sie Fertig stellen aus.
Wenn das Fenster Zugeordnete Perspektive öffnen? angezeigt wird, wählen Sie Perspektive öffnen aus.
Klicken Sie im Paket-Explorer mit der rechten Maustaste auf das Projekt Schnellstart. Wählen Sie Konfigurieren>In Maven-Projekt konvertieren aus dem Kontextmenü aus.
Das Fenster Neue POM-Datei erstellen wird angezeigt. Geben Sie im Feld Gruppen-ID die ID com.microsoft.cognitiveservices.speech.samples ein. Geben Sie im Feld Artefakt-ID den Begriff Schnellstart ein. Wählen Sie dann Fertig stellen aus.
Öffnen Sie die Datei pom.xml, und bearbeiten Sie sie:
Fügen Sie am Ende der Datei ein dependencies-Element vor dem schließenden Tag </project> mit dem Speech SDK als Abhängigkeit hinzu:
In diesem Leitfaden erfahren Sie, wie Sie das Speech SDK für Java unter Android installieren.
Das Speech SDK für Android ist als AAR-Datei (Android-Archiv) gepackt und enthält die erforderlichen Bibliotheken sowie die erforderlichen Android-Berechtigungen.
Installieren des Speech SDK mithilfe von Android Studio
Erstellen Sie ein neues Projekt in Android Studio, und fügen Sie das Speech SDK für Java als Bibliotheksabhängigkeit hinzu. Die Einrichtung basiert auf dem Maven-Paket für das Speech SDK sowie auf Android Studio Chipmunk 2021.2.1.
Erstellen eines leeren Projekts
Öffnen Sie Android Studio, und wählen Sie Neues Projekt aus.
Wählen Sie im angezeigten Neues Projekt die Option Telefon und Tablet>Leere Aktivität aus, und wählen Sie dann Weiter aus.
Geben Sie SpeechQuickstart im Textfeld Name ein.
Geben Sie samples.speech.cognitiveservices.microsoft.com im Textfeld Paketname ein.
Wählen Sie im Feld Speicherort speichern ein Projektverzeichnis aus.
Wählen Sie Java im Feld Sprache aus.
Wählen Sie API 23: Android 6.0 (Marshmallow) im Feld API-Mindestebene aus.
Wählen Sie Fertig stellenaus.
Android Studio braucht einige Zeit, um Ihr neues Projekt vorzubereiten. Wenn Sie Android Studio zum ersten Mal verwenden, kann es einige Minuten dauern, um Einstellungen festzulegen, Lizenzen zu akzeptieren und den Assistenten abzuschließen.
Installieren des Speech SDK für Java auf Android
Fügen Sie das Speech SDK als Abhängigkeit in Ihrem Projekt hinzu.
Wählen Sie Datei>Projektstruktur>Abhängigkeiten>App aus.
Wählen Sie das Plussymbol (+) unter Deklarierte Abhängigkeiten aus, um eine Abhängigkeit hinzuzufügen. Wählen Sie dann Bibliotheksabhängigkeit aus dem Dropdownmenü aus.
Geben Sie im angezeigten Fenster Bibliotheksabhängigkeit hinzufügen den Namen und die Version des Speech-SDK für Java ein: com.microsoft.cognitiveservices.speech:client-sdk:1.42.0. Wählen Sie anschließend Suchen aus.
Stellen Sie sicher, dass als Gruppen-ID die ID com.microsoft.cognitiveservices.speech ausgewählt ist, und wählen Sie dann OK aus.
Wählen Sie OK aus, um das Fenster Projektstruktur zu schließen und Ihre Änderungen auf das Projekt anzuwenden.
Berücksichtigen Sie die verschiedenen architektonischen Auswirkungen zwischen Node.js und Clientwebbrowsern. Zum Beispiel ist das Document Object Model (DOM) für serverseitige Anwendungen nicht verfügbar. Das Node.js Dateisystem steht clientseitigen Anwendungen nicht zur Verfügung.
Installieren Sie das Speech SDK für JavaScript
Verwenden Sie je nach Zielumgebung einen der folgenden Leitfäden:
In diesem Leitfaden erfahren Sie, wie Sie das Speech SDK für JavaScript zur Verwendung mit einer Webseite installieren.
Entpacken in einen Ordner
Erstellen Sie einen neuen leeren Ordner. Wenn Sie das Beispiel auf einem Webserver hosten möchten, stellen Sie sicher, dass der Webserver auf den Ordner zugreifen kann.
Laden Sie das Speech SDK als ZIP-Paket herunter, und entpacken Sie es in den neu erstellten Ordner. Die folgenden Dateien werden entpackt:
microsoft.cognitiveservices.speech.sdk.bundle.js: Eine für Menschen lesbare Version des Speech SDK.
microsoft.cognitiveservices.speech.sdk.bundle.js.map ist eine Zuordnungsdatei, die zum Debuggen von SDK-Code verwendet wird.
microsoft.cognitiveservices.speech.sdk.bundle.d.ts: Objektdefinitionen, die mit TypeScript verwendet werden.
microsoft.cognitiveservices.speech.sdk.bundle-min.js: Eine minimierte Version des Speech SDK.
speech-processor.js: Code zum Verbessern der Leistung in einigen Browsern.
Erstellen Sie im Ordner eine neue Datei namens index.html, und öffnen Sie diese Datei mit einem Text-Editor.
HTML-Skripttag
Laden Sie die Datei microsoft.cognitiveservices.speech.sdk.bundle.js aus dem Speech SDK für JavaScript herunter, und extrahieren Sie sie. Speichern Sie sie in einem Ordner, auf den Ihre HTML-Datei zugreifen kann.
Verwenden Sie für einen Webbrowser das Tag <script>. Das Präfix sdk ist nicht erforderlich. Das Präfix sdk ist ein Alias, mit dem das Modul require benannt wird.
Alternativ können Sie ein <script>-Tag direkt im <head>-Element des HTML-Codes einfügen, das JSDelivr nutzt.
Das Speech SDK für Objective-C ist nativ als CocoaPod-Paket für x64- und Arm-basierte Systeme für Mac verfügbar.
Systemanforderungen für Mac:
Eine macOS-Version 10.14 oder höher
Das macOS-CocoaPod-Paket steht zum Download zur Verfügung und kann mit der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) Xcode 9.4.1 oder höher verwendet werden.
Wechseln Sie zu dem Xcode Verzeichnis, in dem sich Ihre .xcodeproj-Projektdatei befindet.
Führen Sie pod init aus, um eine Poddatei namens Podfile zu erstellen.
Ersetzen Sie den Inhalt von Podfile durch folgenden Inhalt. Ersetzen Sie den target Namen von AppName durch den Namen Ihrer App. Aktualisieren Sie bei Bedarf die Plattform- oder Podversion.
platform :osx, 10.14
use_frameworks!
target 'AppName' do
pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.42.0'
end
Führen Sie pod install aus, um das Speech SDK zu installieren.
Alternativ können Sie den binären CocoaPod herunterladen und seinen Inhalt extrahieren. Fügen Sie in Ihrem Xcode-Projekt einen Verweis auf den extrahierten Ordner MicrosoftCognitiveServicesSpeech.xcframework und dessen Inhalt hinzu.
Hinweis
.NET-Entwickler können native macOS-Anwendungen mithilfe des Xamarin.Mac-Anwendungsframeworks erstellen. Weitere Informationen finden Sie unter Xamarin.Mac.
Das Speech SDK für Objective-C ist nativ als CocoaPod-Paket verfügbar.
Systemanforderungen für iOS:
Eine macOS-Version 10.14 oder höher
Zielversion: iOS 9.3 oder höher
Das macOS-CocoaPod-Paket steht zum Download zur Verfügung und kann mit der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) Xcode 9.4.1 oder höher verwendet werden.
Wechseln Sie zu dem Xcode Verzeichnis, in dem sich Ihre .xcodeproj-Projektdatei befindet.
Führen Sie pod init aus, um eine Poddatei namens Podfile zu erstellen.
Ersetzen Sie den Inhalt von Podfile durch folgenden Inhalt. Ersetzen Sie den target Namen von AppName durch den Namen Ihrer App. Aktualisieren Sie bei Bedarf die Plattform- oder Podversion.
platform :ios, '9.3'
use_frameworks!
target 'AppName' do
pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.42.0'
end
Führen Sie pod install aus, um das Speech SDK zu installieren.
Alternativ können Sie den binären CocoaPod herunterladen und seinen Inhalt extrahieren. Fügen Sie in Ihrem Xcode-Projekt einen Verweis auf den extrahierten Ordner MicrosoftCognitiveServicesSpeech.xcframework und dessen Inhalt hinzu.
Hinweis
.NET-Entwickler und -Entwicklerinnen können native iOS-Anwendungen mithilfe des Xamarin.iOS-Anwendungsframeworks erstellen. Weitere Informationen finden Sie unter Xamarin.iOS.
Das Speech SDK für Swift ist nativ als CocoaPod-Paket für x64- und ARM-basierte Systeme für Mac verfügbar.
Systemanforderungen für Mac:
Eine macOS-Version 10.14 oder höher
Das macOS-CocoaPod-Paket steht zum Download zur Verfügung und kann mit der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) Xcode 9.4.1 oder höher verwendet werden.
Wechseln Sie zu dem Xcode Verzeichnis, in dem sich Ihre .xcodeproj-Projektdatei befindet.
Führen Sie pod init aus, um eine Poddatei namens Podfile zu erstellen.
Ersetzen Sie den Inhalt von Podfile durch folgenden Inhalt. Ersetzen Sie den target Namen von AppName durch den Namen Ihrer App. Aktualisieren Sie bei Bedarf die Plattform- oder Podversion.
platform :osx, 10.14
use_frameworks!
target 'AppName' do
pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.42.0'
end
Führen Sie pod install aus, um das Speech SDK zu installieren.
Alternativ können Sie den binären CocoaPod herunterladen und seinen Inhalt extrahieren. Fügen Sie in Ihrem Xcode-Projekt einen Verweis auf den extrahierten Ordner MicrosoftCognitiveServicesSpeech.xcframework und dessen Inhalt hinzu.
Hinweis
.NET-Entwickler können native macOS-Anwendungen mithilfe des Xamarin.Mac-Anwendungsframeworks erstellen. Weitere Informationen finden Sie unter Xamarin.Mac.
Das Speech SDK für Swift ist nativ als CocoaPod-Paket verfügbar.
Systemanforderungen für iOS:
Eine macOS-Version 10.14 oder höher
Zielversion: iOS 9.3 oder höher
Das macOS-CocoaPod-Paket steht zum Download zur Verfügung und kann mit der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) Xcode 9.4.1 oder höher verwendet werden.
Wechseln Sie zu dem Xcode Verzeichnis, in dem sich Ihre .xcodeproj-Projektdatei befindet.
Führen Sie pod init aus, um eine Poddatei namens Podfile zu erstellen.
Ersetzen Sie den Inhalt von Podfile durch Folgendes: Ersetzen Sie den target Namen von AppName durch den Namen Ihrer App. Aktualisieren Sie bei Bedarf die Plattform- oder Podversion.
platform :ios, '9.3'
use_frameworks!
target 'AppName' do
pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.42.0'
end
Führen Sie pod install aus, um das Speech SDK zu installieren.
Alternativ können Sie den binären CocoaPod herunterladen und seinen Inhalt extrahieren. Fügen Sie in Ihrem Xcode-Projekt einen Verweis auf den extrahierten Ordner MicrosoftCognitiveServicesSpeech.xcframework und dessen Inhalt hinzu.
Hinweis
.NET-Entwickler und -Entwicklerinnen können native iOS-Anwendungen mithilfe des Xamarin.iOS-Anwendungsframeworks erstellen. Weitere Informationen finden Sie unter Xamarin.iOS.
Stellen Sie sicher, dass Pakete der gleichen Zielarchitektur installiert sind. Wenn Sie beispielsweise das Redistributable-Paket für x64 installieren, installieren Sie auch das Python-Paket für x64.
Das Speech SDK für Python unterstützt die folgenden Distributionen für x64- und Arm64-Architekturen:
Ubuntu 20.04/22.04/24.04
Debian 11/12
Amazon Linux 2023
Azure Linux 3.0
Wichtig
Verwenden Sie das neueste LTS-Release der Linux-Distribution. Wenn Sie beispielsweise Ubuntu 20.04 LTS verwenden, verwenden Sie das neueste Release von Ubuntu 20.04.X.
Das Speech SDK hängt von den folgenden Linux-Systembibliotheken ab:
Freigegebene Bibliotheken der GNU C-Bibliothek, einschließlich der POSIX Threads Programming-Bibliothek, libpthreads.
Die OpenSSL-Bibliothek, Version 1.x (libssl1) oder 3.x (libssl3), und Zertifikate (ca-certificates).
Freigegebene Bibliothek für ALSA-Anwendungen (libasound2).
Öffnen Sie ein Terminal, und führen Sie den Befehl python --version aus, um die Installation zu überprüfen. Wenn Python ordnungsgemäß installiert ist, erhalten Sie eine Antwort wie Python 3.8.10.
Wenn Sie macOS oder Linux verwenden, müssen Sie möglicherweise stattdessen den Befehl python3 --version ausführen.
Um die Verwendung von python anstelle von python3 zu aktivieren, führen Sie alias python='python3' aus, um einen Alias einzurichten. Die Schnellstartbeispiele des Speech SDK geben die Verwendung von python an.
Installieren des Speech SDK für Python
Bevor Sie das Speech SDK für Python installieren, stellen Sie sicher, dass die Plattformvoraussetzungen erfüllt sind.
Die derzeit installierte Version des Speech SDK für Python können Sie der Variablen azure.cognitiveservices.speech.__version__ entnehmen. Führen Sie beispielsweise diesen Befehl in einem Konsolenfenster aus:
pip list
Installieren des Speech SDK mithilfe von Visual Studio Code
So installieren Sie das Speech SDK für Python:
Laden Sie Visual Studio Code herunter, und installieren Sie die Software.
Führen Sie Visual Studio Code aus, und installieren Sie die Python-Erweiterung:
Wählen Sie Datei>Einstellungen>Erweiterungen aus.
Suchen Sie nach Python, wählen Sie die Python-Erweiterung für Visual Studio Code von Microsoft aus, und wählen Sie dann Installieren aus.
Wählen Sie Terminal>Neues Terminal aus, um ein Terminal in Visual Studio Code zu öffnen.
Führen Sie in der Eingabeaufforderung des Terminals den folgenden Befehl aus, um das Paket mit dem Speech SDK für Python zu installieren.