Szybki start: Rozpoznawanie mowy przy użyciu zestawu SDK usługi Mowa dla platformy .NET Framework (Windows)Quickstart: Recognize speech with the Speech SDK for .NET Framework (Windows)

Przewodniki Szybki Start są również dostępne dla syntezy mowy i tłumaczenia mowy.Quickstarts are also available for speech synthesis and speech translation.

Jeśli chcesz, wybierz inny język programowania i/lub środowisko:If you want, choose a different programming language and/or environment:

Korzystając z tego przewodnika, możesz utworzyć aplikację konsolową zamieniającą mowę na tekst przy użyciu programu .NET Framework dla systemu Windows oraz zestawu SDK usługi Mowa.Use this guide to create a speech-to-text console application using the .NET framework for Windows and the Speech SDK. Następnie za pomocą mikrofonu komputera będzie możliwa transkrypcja mowy na tekst w czasie rzeczywistym.When finished, you can use your computer's microphone to transcribe speech to text in real time.

Aby uzyskać szybką demonstrację (bez kompilowania projektu programu Visual Studio zgodnie z opisem w tym artykule), Pobierz najnowsze przykłady zestawu SDK mowy Cognitive Services z usługi GitHub.For a quick demonstration (without building the Visual Studio project yourself, as described in this article), get the latest Cognitive Services Speech SDK Samples from GitHub.

Wymagania wstępnePrerequisites

Aby ukończyć ten projekt, będą potrzebne następujące elementy:To complete this project, you'll need:

Tworzenie projektu programu Visual StudioCreate a Visual Studio project

Aby utworzyć projekt programu Visual Studio dla rozwoju systemu Windows, musisz utworzyć projekt, skonfigurować program Visual Studio do tworzenia aplikacji klasycznych platformy .NET, zainstalować zestaw Speech SDK i wybrać architekturę docelową.To create a Visual Studio project for Windows development, you need to create the project, set up Visual Studio for .NET desktop development, install the Speech SDK, and choose the target architecture.

Utwórz projekt i Dodaj obciążenieCreate the project and add the workload

Aby rozpocząć, Utwórz projekt w programie Visual Studio i upewnij się, że program Visual Studio został skonfigurowany do tworzenia aplikacji klasycznych platformy .NET:To start, create the project in Visual Studio, and make sure that Visual Studio is set up for .NET desktop development:

  1. Open Visual Studio 2019.Open Visual Studio 2019.

  2. W oknie uruchamiania wybierz pozycję Utwórz nowy projekt.In the Start window, select Create a new project.

  3. W oknie Tworzenie nowego projektu wybierz pozycję aplikacja konsoli (.NET Framework) , a następnie wybierz przycisk dalej.In the Create a new project window, choose Console App (.NET Framework), and then select Next.

  4. W oknie Konfigurowanie nowego projektu wprowadź wartość HelloWorld w polu Nazwa projektu, wybierz lub Utwórz ścieżkę katalogu w lokalizacji, a następnie wybierz pozycję Utwórz.In the Configure your new project window, enter helloworld in Project name, choose or create the directory path in Location, and then select Create.

  5. Na pasku menu programu Visual Studio wybierz kolejno pozycje narzędzia > Pobierz narzędzia i funkcje, które otwiera Instalator programu Visual Studio i wyświetla okno dialogowe Modyfikowanie .From the Visual Studio menu bar, select Tools > Get Tools and Features, which opens Visual Studio Installer and displays the Modifying dialog box.

  6. Sprawdź, czy jest dostępne obciążenie Programowanie aplikacji klasycznych dla platformy .NET .Check whether the .NET desktop development workload is available. Jeśli obciążenie nie zostało zainstalowane, zaznacz pole wyboru obok niego, a następnie wybierz pozycję Modyfikuj , aby rozpocząć instalację.If the workload hasn't been installed, select the check box next to it, and then select Modify to start the installation. Pobranie i zainstalowanie tego składnika może potrwać kilka minut.It may take a few minutes to download and install.

    Jeśli pole wyboru obok pozycji Programowanie aplikacji klasycznych platformy .NET jest już zaznaczone, wybierz pozycję Zamknij , aby zamknąć okno dialogowe.If the check box next to .NET desktop development is already selected, select Close to exit the dialog box.

    Włącz pakiet roboczy Programowanie aplikacji klasycznych dla platformy .NET

  7. Zamknij Instalator programu Visual Studio.Close Visual Studio Installer.

Instalowanie zestawu SDK usługi MowaInstall the Speech SDK

Następnym krokiem jest zainstalowanie pakietu NuGet zestawu Speech SDK, aby można było odwołać się do niego w kodzie.The next step is to install the Speech SDK NuGet package, so you can reference it in the code.

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt HelloWorld , a następnie wybierz pozycję Zarządzaj pakietami NuGet , aby wyświetlić Menedżera pakietów NuGet.In the Solution Explorer, right-click the helloworld project, and then select Manage NuGet Packages to show the NuGet Package Manager.

    Menedżer pakietów NuGet

  2. W prawym górnym rogu Znajdź pole listy rozwijanej Źródło pakietu i upewnij się, że wybrano opcję NuGet.org .In the upper-right corner, find the Package Source drop-down box, and make sure that nuget.org is selected.

  3. W lewym górnym rogu wybierz pozycję Przeglądaj.In the upper-left corner, select Browse.

  4. W polu wyszukiwania wpisz Microsoft. CognitiveServices. Speech i wybierz Enter.In the search box, type Microsoft.CognitiveServices.Speech and select Enter.

  5. Z wyników wyszukiwania wybierz pakiet Microsoft. CognitiveServices. Speech , a następnie wybierz pozycję Zainstaluj , aby zainstalować najnowszą stabilną wersję.From the search results, select the Microsoft.CognitiveServices.Speech package, and then select Install to install the latest stable version.

    Zainstaluj pakiet NuGet Microsoft. CognitiveServices. Speech

  6. Zaakceptuj wszystkie umowy i licencje, aby rozpocząć instalację.Accept all agreements and licenses to start the installation.

    Po zainstalowaniu pakietu w oknie konsola Menedżera pakietów zostanie wyświetlone potwierdzenie.After the package is installed, a confirmation appears in the Package Manager Console window.

Wybieranie architektury docelowejChoose the target architecture

Teraz, aby skompilować i uruchomić aplikację konsolową, Utwórz konfigurację platformy zgodną z architekturą komputera.Now, to build and run the console application, create a platform configuration matching your computer's architecture.

  1. Na pasku menu wybierz kolejno opcje Kompiluj > Configuration Manager.From the menu bar, select Build > Configuration Manager. Programu Configuration Manager pojawi się okno dialogowe.The Configuration Manager dialog box appears.

    Okno dialogowe Configuration Manager

  2. W polu listy rozwijanej platforma aktywnego rozwiązania wybierz pozycję Nowy.In the Active solution platform drop-down box, select New. Zostanie wyświetlone okno dialogowe Nowa platforma rozwiązania .The New Solution Platform dialog box appears.

  3. W polu Typ lub wybierz nową platformę z listy rozwijanej:In the Type or select the new platform drop-down box:

    • Jeśli korzystasz z 64-bitowego systemu Windows, wybierz pozycję x64.If you're running 64-bit Windows, select x64.
    • Jeśli korzystasz z 32-bitowego systemu Windows, wybierz pozycję x86.If you're running 32-bit Windows, select x86.
  4. Wybierz przycisk OK , a następnie Zamknij.Select OK and then Close.

Dodaj kod przykładowyAdd sample code

  1. Otwórz program.cs i Zastąp automatycznie wygenerowany kod tym przykładem: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 <Return> to continue.");
                Console.ReadLine();
            }
        }
    }
    
  2. Znajdź ciąg YourSubscriptionKey i zastąp go kluczem subskrypcji usługi Speech Services.Find the string YourSubscriptionKey, and replace it with your Speech Services subscription key.

  3. Znajdź ciąg YourServiceRegion i zastąp go regionem skojarzonym z subskrypcją.Find the string YourServiceRegion, and replace it with the region associated with your subscription. Na przykład jeśli używasz bezpłatnej subskrypcji wersji próbnej, region jest westus.For example, if you're using the free trial subscription, the region is westus.

  4. Na pasku menu wybierz kolejno opcje plik > Zapisz wszystko.From the menu bar, choose File > Save All.

Kompilowanie i uruchamianie aplikacjiBuild and run the app

  1. Na pasku menu wybierz kolejno opcje kompiluj > Kompiluj rozwiązanie , aby skompilować aplikację.From the menu bar, choose Build > Build Solution to build the application. Kod powinien teraz zostać skompilowany bez błędów.The code should compile without errors now.

  2. Wybierz debuguj > Rozpocznij debugowanie (lub wybierz F5), aby uruchomić aplikację HelloWorld .Choose Debug > Start Debugging (or select F5) to start the helloworld application.

  3. Zacznij od angielskiej frazy lub zdania do mikrofonu Twojego urządzenia.Speak an English phrase or sentence into your device's microphone. Aplikacja przesyła mowę do usługi mowy, co spowoduje wysłanie do wyświetlania tekstu uzyskanego z powrotem do aplikacji.The application transmits your speech to the Speech Services, which sends the transcribed text back to the application for display.

    Interfejs użytkownika rozpoznawania mowy

Następne krokiNext steps

Zobacz takżeSee also