Schnellstart: Erkennen von Sprache mit dem Speech SDK für .NET Framework (Windows)Quickstart: Recognize speech with the Speech SDK for .NET Framework (Windows)

Schnellstarts sind auch für Sprachsynthese und Sprachübersetzung verfügbar.Quickstarts are also available for text-to-speech and speech-translation.

Wählen Sie bei Bedarf eine andere Programmiersprache und/oder Umgebung:If desired, choose a different programming language and/or environment:

In dieser Anleitung erfahren Sie, wie Sie unter Verwendung von .NET Framework für Windows und dem Speech SDK eine Konsolenanwendung zur Spracherkennung erstellen.Use this guide to create a speech-to-text console application using the .NET framework for Windows and the Speech SDK. Danach können Sie das Mikrofon Ihres Computers verwenden, um Sprache in Echtzeit zu transkribieren.When finished, you can use your computer's microphone to transcribe speech to text in real time.

Eine schnelle Demonstration (ohne eigene Erstellung des Visual Studio-Projekts, wie weiter unten gezeigt) erhalten Sie wie folgt:For a quick demonstration (without building the Visual Studio project yourself as shown below):

Laden Sie die neuesten Beispiele für das Cognitive Services Speech SDK von GitHub herunter.Get the latest Cognitive Services Speech SDK Samples from GitHub.

VoraussetzungenPrerequisites

Für dieses Projekt benötigen Sie Folgendes:To complete this project, you'll need:

Erstellen eines Visual Studio-ProjektsCreate a Visual Studio project

  1. Starten Sie Visual Studio 2017.Start Visual Studio 2017.

  2. Wählen Sie auf der Menüleiste in Visual Studio Tools > Tools herunterladen aus, und vergewissern Sie sich, dass die Workload .NET-Desktopentwicklung verfügbar ist.From the menu bar in Visual Studio, select Tools > Get Tools and make sure that the .NET desktop development workload is available. Wurde die Workload noch nicht installiert, aktivieren Sie das Kontrollkästchen, und klicken Sie auf Ändern, um die Installation zu starten.If the workload hasn't been installed, mark the checkbox, then click Modify to start the installation. Der Download und die Installation können einige Minuten dauern.It may take a few minutes to download and install.

    Ist das Kontrollkästchen neben .NET-Desktopentwicklung aktiviert, können Sie das Dialogfeld jetzt schließen.If the checkbox next to .NET desktop development is selected, you can close the dialog box now.

    Aktivieren der .NET-Desktopentwicklung

  3. Als Nächstes erstellen wir ein Projekt.Next, let's create a project. Wählen Sie auf der Menüleiste Datei > Neu > Projekt aus.From the menu bar select File > New > Project. Erweitern Sie im angezeigten Dialogfeld im linken Bereich die Abschnitte Installiert > Visual C# > Windows Desktop, und wählen Sie Konsolen-App (.NET Framework) aus.When the dialog box appears, from the left panel expand these sections Installed > Visual C# > Windows Desktop and select Console App (.NET Framework). Nennen Sie dieses Projekt helloworld.Name this project helloworld.

    Erstellen einer Visual C#-Konsolen-App (.NET Framework)Create Visual C# Console App (.NET Framework)

  4. Das Projekt ist eingerichtet. Nun müssen Sie das NuGet-Paket für das Speech SDK installieren und im Code darauf verweisen.Now that the project is set up, we need to install the Speech SDK NuGet package and reference it in our code. Suchen Sie den Projektmappen-Explorer, und klicken Sie mit der rechten Maustaste auf „helloworld“.Locate the Solution Explorer and right-click on helloworld. Wählen Sie im Menü die Option NuGet-Pakete verwalten... aus.From the menu, select Manage NuGet Packages....

    Klicken Sie mit der rechten Maustaste auf „NuGet-Pakete für Projektmappen verwalten“Right-click Manage NuGet Packages for Solution

  5. Navigieren Sie im NuGet-Paket-Manager oben rechts zum Dropdownmenü Paketquelle, und stellen Sie sicher, dass nuget.org ausgewählt ist.In the upper-right corner of the NuGet Package Manager, locate the Package Source dropdown and make sure that nuget.org is selected. Wählen Sie dann Durchsuchen aus, suchen Sie nach dem Paket Microsoft.CognitiveServices.Speech, und installieren Sie die letzte stabile Version.Then, select Browse and search for the Microsoft.CognitiveServices.Speech package and install the latest stable version.

    NuGet-Paket Microsoft.CognitiveServices.Speech installierenInstall Microsoft.CognitiveServices.Speech NuGet Package

  6. Akzeptieren Sie alle Vereinbarungen und Lizenzen, um die Installation zu starten.Accept all agreements and licenses to start the installation.

    Akzeptieren der LizenzbedingungenAccept the license

    Nachdem das Paket installiert wurde, wird eine Bestätigung in der Paket-Manager-Konsole angezeigt.After the package is installed, a confirmation appears in the Package Manager console.

  7. Im nächsten Schritt erstellen Sie eine Plattformkonfiguration, die der Architektur des Computers entspricht, mit dem Sie die Konsolenanwendung erstellen und ausführen.The next step is to create a platform configuration that matches the architecture of the computer you're using to build and run the console application. Wählen Sie auf der Menüleiste Build > Konfigurations-Manager aus.From the menu bar, select Build > Configuration Manager....

    Starten des Konfigurations-ManagersLaunch the configuration manager

  8. Klicken Sie im Dialogfeld Konfigurations-Manager auf die Dropdownliste Aktive Projektmappenplattform, und wählen Sie Neu aus.In the Configuration Manager dialog box, locate the Active solution platform drop-down list, and select New.

    Hinzufügen einer neuen Plattform im Fenster des Konfigurations-ManagersAdd a new platform under the configuration manager window

  9. Wenn Sie bei Verwendung einer 64-Bit-Windows-Version zum Eingeben oder Auswählen der neuen Plattform aufgefordert werden, wählen Sie x64 aus.If you are running 64-bit Windows, when prompted with Type or select the new platform, x64. Wird eine 32-Bit-Version von Windows ausgeführt, wählen Sie x86 aus.If you are running 32-bit Windows, select x86. Klicken Sie abschließend auf OK.When you're finished, click OK.

    Fügen Sie unter Windows 64-Bit eine neue Plattform mit dem Namen „x64“ hinzuOn 64-bit Windows, add a new platform named "x64"

Hinzufügen von BeispielcodeAdd sample code

  1. Öffnen Sie Program.cs, und ersetzen Sie den automatisch generierten Code durch dieses Beispiel:Open Program.cs and replace the automatically generated code with this sample:

    using System;
    using System.Threading.Tasks;
    using Microsoft.CognitiveServices.Speech;
    
    namespace helloworld
    {
        class Program
        {
            public static async Task RecognizeSpeechAsync()
            {
                // Creates an instance of a speech config with specified subscription key and service region.
                // Replace with your own subscription key and service region (e.g., "westus").
                var config = SpeechConfig.FromSubscription("YourSubscriptionKey", "YourServiceRegion");
    
                // Creates a speech recognizer.
                using (var recognizer = new SpeechRecognizer(config))
                {
                    Console.WriteLine("Say something...");
    
                    // Starts speech recognition, and returns after a single utterance is recognized. The end of a
                    // single utterance is determined by listening for silence at the end or until a maximum of 15
                    // seconds of audio is processed.  The task returns the recognition text as result. 
                    // Note: Since RecognizeOnceAsync() returns only a single utterance, it is suitable only for single
                    // shot recognition like command or query. 
                    // For long-running multi-utterance recognition, use StartContinuousRecognitionAsync() instead.
                    var result = await recognizer.RecognizeOnceAsync();
    
                    // Checks result.
                    if (result.Reason == ResultReason.RecognizedSpeech)
                    {
                        Console.WriteLine($"We recognized: {result.Text}");
                    }
                    else if (result.Reason == ResultReason.NoMatch)
                    {
                        Console.WriteLine($"NOMATCH: Speech could not be recognized.");
                    }
                    else if (result.Reason == ResultReason.Canceled)
                    {
                        var cancellation = CancellationDetails.FromResult(result);
                        Console.WriteLine($"CANCELED: Reason={cancellation.Reason}");
    
                        if (cancellation.Reason == CancellationReason.Error)
                        {
                            Console.WriteLine($"CANCELED: ErrorCode={cancellation.ErrorCode}");
                            Console.WriteLine($"CANCELED: ErrorDetails={cancellation.ErrorDetails}");
                            Console.WriteLine($"CANCELED: Did you update the subscription info?");
                        }
                    }
                }
            }
    
            static void Main()
            {
                RecognizeSpeechAsync().Wait();
                Console.WriteLine("Please press a key to continue.");
                Console.ReadLine();
            }
        }
    }
    
  2. Suchen Sie nach der Zeichenfolge YourSubscriptionKey, und ersetzen Sie sie durch Ihren Abonnementschlüssel für die Speech-Dienste.Locate and replace the string YourSubscriptionKey with your Speech Services subscription key.

  3. Suchen Sie nach der Zeichenfolge YourServiceRegion, und ersetzen Sie sie durch die Region, die mit Ihrem Abonnement verknüpft ist.Locate and replace the string YourServiceRegion with the region associated with your subscription. Bei Verwendung der kostenlosen Testversion ist die Region beispielsweise westus.For example, if you're using the free trial, the region is westus.

  4. Speichern Sie die Änderungen am Projekt.Save the changes to the project.

Erstellen und Ausführen der AppBuild and run the app

  1. Wählen Sie in der Menüleiste Build > Projektmappe erstellen aus.From the menu bar, select Build > Build Solution. Der Code sollte nun ohne Fehler kompiliert werden.The code should compile without errors now.

    Screenshot der Visual Studio-Anwendung mit hervorgehobener Option „Projektmappe erstellenScreenshot of Visual Studio application, with Build Solution option highlighted

  2. Wählen Sie auf der Menüleiste Debuggen > Debuggen starten aus, oder drücken SieF5, um die Anwendung zu starten.From the menu bar, select Debug > Start Debugging, or press F5 to start the application.

    Screenshot der Visual Studio-Anwendung mit hervorgehobener Option „Debuggen startenScreenshot of Visual Studio application, with Start Debugging option highlighted

  3. Ein Konsolenfenster mit einer Sprechaufforderung wird angezeigt.A console window will appear, prompting you to speak. Sagen Sie etwas auf Englisch.Now, say something in English. Ihre Spracheingabe wird an die Speech-Dienste übermittelt und in Echtzeit in Text umgewandelt.Your speech is transmitted to the Speech Services and transcribed to text in real time. Das Ergebnis wird in der Konsole ausgegeben.The result is printed to the console.

    Screenshot der Konsolenausgabe nach erfolgreicher ErkennungScreenshot of console output after successful recognition

Nächste SchritteNext steps

Weitere InformationenSee also