빠른 시작: 음성을 인식하고 텍스트로 변환

참조 설명서 | 패키지(NuGet) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

환경 설정

음성 SDK는 NuGet 패키지로 사용할 수 있으며 .NET Standard 2.0을 구현합니다. 이 가이드의 뒷부분에서 Speech SDK를 설치하지만, 먼저 SDK 설치 가이드 에서 더 많은 요구 사항을 확인합니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 setx를 사용하여 환경 변수를 set 설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

다음 단계에 따라 새 콘솔 애플리케이션을 만들고 음성 SDK를 설치합니다.

  1. 새 프로젝트를 원하는 명령 프롬프트를 열고 .NET CLI를 사용하여 콘솔 애플리케이션을 만듭니다. 파일은 Program.cs 프로젝트 디렉터리에 만들어야 합니다.

    dotnet new console
    
  2. .NET CLI를 사용하여 새 프로젝트에 음성 SDK를 설치합니다.

    dotnet add package Microsoft.CognitiveServices.Speech
    
  3. Program.cs의 내용을 다음 코드로 바꿉니다.

    using System;
    using System.IO;
    using System.Threading.Tasks;
    using Microsoft.CognitiveServices.Speech;
    using Microsoft.CognitiveServices.Speech.Audio;
    
    class Program 
    {
        // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
        static string speechKey = Environment.GetEnvironmentVariable("SPEECH_KEY");
        static string speechRegion = Environment.GetEnvironmentVariable("SPEECH_REGION");
    
        static void OutputSpeechRecognitionResult(SpeechRecognitionResult speechRecognitionResult)
        {
            switch (speechRecognitionResult.Reason)
            {
                case ResultReason.RecognizedSpeech:
                    Console.WriteLine($"RECOGNIZED: Text={speechRecognitionResult.Text}");
                    break;
                case ResultReason.NoMatch:
                    Console.WriteLine($"NOMATCH: Speech could not be recognized.");
                    break;
                case ResultReason.Canceled:
                    var cancellation = CancellationDetails.FromResult(speechRecognitionResult);
                    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 set the speech resource key and region values?");
                    }
                    break;
            }
        }
    
        async static Task Main(string[] args)
        {
            var speechConfig = SpeechConfig.FromSubscription(speechKey, speechRegion);        
            speechConfig.SpeechRecognitionLanguage = "en-US";
    
            using var audioConfig = AudioConfig.FromDefaultMicrophoneInput();
            using var speechRecognizer = new SpeechRecognizer(speechConfig, audioConfig);
    
            Console.WriteLine("Speak into your microphone.");
            var speechRecognitionResult = await speechRecognizer.RecognizeOnceAsync();
            OutputSpeechRecognitionResult(speechRecognitionResult);
        }
    }
    
  4. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

새 콘솔 애플리케이션을 실행하여 마이크의 음성 인식을 시작합니다.

dotnet run

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

메시지가 표시되면 마이크에 말합니다. 말하는 내용이 텍스트로 출력되어야 합니다.

Speak into your microphone.
RECOGNIZED: Text=I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 이 예제에서는 RecognizeOnceAsync 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.
  • 오디오 파일에서 음성을 인식하려면 FromDefaultMicrophoneInput 대신 FromWavFileInput를 사용합니다.
    using var audioConfig = AudioConfig.FromWavFileInput("YourAudioFile.wav");
    
  • MP4와 같은 압축 오디오 파일의 경우 GStreamer를 설치하고 PullAudioInputStream 또는 PushAudioInputStream을 사용합니다. 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(NuGet) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

환경 설정

음성 SDK는 NuGet 패키지로 사용할 수 있으며 .NET Standard 2.0을 구현합니다. 이 가이드의 뒷부분에서 Speech SDK를 설치하지만, 먼저 SDK 설치 가이드 에서 더 많은 요구 사항을 확인합니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 를 사용하여 환경 변수를 setsetx설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

다음 단계에 따라 새 콘솔 애플리케이션을 만들고 음성 SDK를 설치합니다.

  1. Visual Studio에서 새 C++ 콘솔 프로젝트를 만듭니다.

  2. NuGet 패키지 관리자를 사용하여 새 프로젝트에 음성 SDK를 설치합니다.

    Install-Package Microsoft.CognitiveServices.Speech
    
  3. main.cpp의 내용을 다음 코드로 바꿉니다.

    #include <iostream> 
    #include <stdlib.h>
    #include <speechapi_cxx.h>
    
    using namespace Microsoft::CognitiveServices::Speech;
    using namespace Microsoft::CognitiveServices::Speech::Audio;
    
    std::string GetEnvironmentVariable(const char* name);
    
    int main()
    {
        // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
        auto speechKey = GetEnvironmentVariable("SPEECH_KEY");
        auto speechRegion = GetEnvironmentVariable("SPEECH_REGION");
    
        if ((size(speechKey) == 0) || (size(speechRegion) == 0)) {
            std::cout << "Please set both SPEECH_KEY and SPEECH_REGION environment variables." << std::endl;
            return -1;
        }
    
        auto speechConfig = SpeechConfig::FromSubscription(speechKey, speechRegion);
    
        speechConfig->SetSpeechRecognitionLanguage("en-US");
    
        auto audioConfig = AudioConfig::FromDefaultMicrophoneInput();
        auto recognizer = SpeechRecognizer::FromConfig(speechConfig, audioConfig);
    
        std::cout << "Speak into your microphone.\n";
        auto result = recognizer->RecognizeOnceAsync().get();
    
        if (result->Reason == ResultReason::RecognizedSpeech)
        {
            std::cout << "RECOGNIZED: Text=" << result->Text << std::endl;
        }
        else if (result->Reason == ResultReason::NoMatch)
        {
            std::cout << "NOMATCH: Speech could not be recognized." << std::endl;
        }
        else if (result->Reason == ResultReason::Canceled)
        {
            auto cancellation = CancellationDetails::FromResult(result);
            std::cout << "CANCELED: Reason=" << (int)cancellation->Reason << std::endl;
    
            if (cancellation->Reason == CancellationReason::Error)
            {
                std::cout << "CANCELED: ErrorCode=" << (int)cancellation->ErrorCode << std::endl;
                std::cout << "CANCELED: ErrorDetails=" << cancellation->ErrorDetails << std::endl;
                std::cout << "CANCELED: Did you set the speech resource key and region values?" << std::endl;
            }
        }
    }
    
    std::string GetEnvironmentVariable(const char* name)
    {
    #if defined(_MSC_VER)
        size_t requiredSize = 0;
        (void)getenv_s(&requiredSize, nullptr, 0, name);
        if (requiredSize == 0)
        {
            return "";
        }
        auto buffer = std::make_unique<char[]>(requiredSize);
        (void)getenv_s(&requiredSize, buffer.get(), requiredSize, name);
        return buffer.get();
    #else
        auto value = getenv(name);
        return value ? value : "";
    #endif
    }
    
  4. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

새 콘솔 애플리케이션을 작성하고 실행하여 마이크의 음성 인식을 시작합니다.

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

메시지가 표시되면 마이크에 말합니다. 말하는 내용이 텍스트로 출력되어야 합니다.

Speak into your microphone.
RECOGNIZED: Text=I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 이 예제에서는 RecognizeOnceAsync 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.
  • 오디오 파일에서 음성을 인식하려면 FromDefaultMicrophoneInput 대신 FromWavFileInput를 사용합니다.
    auto audioInput = AudioConfig::FromWavFileInput("YourAudioFile.wav");
    
  • MP4와 같은 압축 오디오 파일의 경우 GStreamer를 설치하고 PullAudioInputStream 또는 PushAudioInputStream을 사용합니다. 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(Go) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

환경 설정

Go용 Speech SDK를 설치합니다. 더 많은 요구 사항은 SDK 설치 가이드 를 확인하세요.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 를 사용하여 환경 변수를 setsetx설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

새 GO 모듈을 만들려면 다음 단계를 수행합니다.

  1. 새 모듈을 원하는 명령 프롬프트를 열고 speech-recognition.go라는 새 파일을 만듭니다.

  2. 다음 코드를 speech-recognition.go에 복사합니다.

    package main
    
    import (
    	"bufio"
    	"fmt"
    	"os"
    
    	"github.com/Microsoft/cognitive-services-speech-sdk-go/audio"
    	"github.com/Microsoft/cognitive-services-speech-sdk-go/speech"
    )
    
    func sessionStartedHandler(event speech.SessionEventArgs) {
    	defer event.Close()
    	fmt.Println("Session Started (ID=", event.SessionID, ")")
    }
    
    func sessionStoppedHandler(event speech.SessionEventArgs) {
    	defer event.Close()
    	fmt.Println("Session Stopped (ID=", event.SessionID, ")")
    }
    
    func recognizingHandler(event speech.SpeechRecognitionEventArgs) {
    	defer event.Close()
    	fmt.Println("Recognizing:", event.Result.Text)
    }
    
    func recognizedHandler(event speech.SpeechRecognitionEventArgs) {
    	defer event.Close()
    	fmt.Println("Recognized:", event.Result.Text)
    }
    
    func cancelledHandler(event speech.SpeechRecognitionCanceledEventArgs) {
    	defer event.Close()
    	fmt.Println("Received a cancellation: ", event.ErrorDetails)
        fmt.Println("Did you set the speech resource key and region values?")
    }
    
    func main() {
        // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
        speechKey :=  os.Getenv("SPEECH_KEY")
        speechRegion := os.Getenv("SPEECH_REGION")
    
    	audioConfig, err := audio.NewAudioConfigFromDefaultMicrophoneInput()
    	if err != nil {
    		fmt.Println("Got an error: ", err)
    		return
    	}
    	defer audioConfig.Close()
    	speechConfig, err := speech.NewSpeechConfigFromSubscription(speechKey, speechRegion)
    	if err != nil {
    		fmt.Println("Got an error: ", err)
    		return
    	}
    	defer speechConfig.Close()
    	speechRecognizer, err := speech.NewSpeechRecognizerFromConfig(speechConfig, audioConfig)
    	if err != nil {
    		fmt.Println("Got an error: ", err)
    		return
    	}
    	defer speechRecognizer.Close()
    	speechRecognizer.SessionStarted(sessionStartedHandler)
    	speechRecognizer.SessionStopped(sessionStoppedHandler)
    	speechRecognizer.Recognizing(recognizingHandler)
    	speechRecognizer.Recognized(recognizedHandler)
    	speechRecognizer.Canceled(cancelledHandler)
    	speechRecognizer.StartContinuousRecognitionAsync()
    	defer speechRecognizer.StopContinuousRecognitionAsync()
    	bufio.NewReader(os.Stdin).ReadBytes('\n')
    }
    

다음 명령을 실행하여 GitHub에서 호스팅되는 구성 요소에 연결되는 go.mod 파일을 만듭니다.

go mod init speech-recognition
go get github.com/Microsoft/cognitive-services-speech-sdk-go

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

이제 코드를 빌드하고 실행합니다.

go build
go run speech-recognition

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

환경 설정

작업을 수행하려면 먼저 Speech SDK를 설치해야 합니다. 이 빠른 시작의 샘플은 Java 런타임에서 작동합니다.

  1. Apache Maven을 설치합니다. 그런 다음 를 실행 mvn -v 하여 성공적인 설치를 확인합니다.
  2. 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>
        <repositories>
            <repository>
            <id>maven-cognitiveservices-speech</id>
            <name>Microsoft Cognitive Services Speech Maven Repository</name>
            <url>https://azureai.azureedge.net/maven/</url>
            </repository>
        </repositories>
        <dependencies>
            <dependency>
            <groupId>com.microsoft.cognitiveservices.speech</groupId>
            <artifactId>client-sdk</artifactId>
            <version>1.24.2</version>
            </dependency>
        </dependencies>
    </project>
    
  3. Speech SDK 및 종속성을 설치합니다.
    mvn clean dependency:copy-dependencies
    

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 setx를 사용하여 환경 변수를 set 설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

음성 인식을 위한 새 콘솔 애플리케이션을 만들려면 다음 단계를 수행합니다.

  1. 동일한 프로젝트 루트 디렉터리에 SpeechRecognition.java라는 새 파일을 만듭니다.

  2. 다음 코드를 SpeechRecognition.java에 복사합니다.

    import com.microsoft.cognitiveservices.speech.*;
    import com.microsoft.cognitiveservices.speech.audio.AudioConfig;
    
    import java.util.concurrent.ExecutionException;
    import java.util.concurrent.Future;
    
    public class SpeechRecognition {
        // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
        private static String speechKey = System.getenv("SPEECH_KEY");
        private static String speechRegion = System.getenv("SPEECH_REGION");
    
        public static void main(String[] args) throws InterruptedException, ExecutionException {
            SpeechConfig speechConfig = SpeechConfig.fromSubscription(speechKey, speechRegion);
            speechConfig.setSpeechRecognitionLanguage("en-US");
            recognizeFromMicrophone(speechConfig);
        }
    
        public static void recognizeFromMicrophone(SpeechConfig speechConfig) throws InterruptedException, ExecutionException {
            AudioConfig audioConfig = AudioConfig.fromDefaultMicrophoneInput();
            SpeechRecognizer speechRecognizer = new SpeechRecognizer(speechConfig, audioConfig);
    
            System.out.println("Speak into your microphone.");
            Future<SpeechRecognitionResult> task = speechRecognizer.recognizeOnceAsync();
            SpeechRecognitionResult speechRecognitionResult = task.get();
    
            if (speechRecognitionResult.getReason() == ResultReason.RecognizedSpeech) {
                System.out.println("RECOGNIZED: Text=" + speechRecognitionResult.getText());
            }
            else if (speechRecognitionResult.getReason() == ResultReason.NoMatch) {
                System.out.println("NOMATCH: Speech could not be recognized.");
            }
            else if (speechRecognitionResult.getReason() == ResultReason.Canceled) {
                CancellationDetails cancellation = CancellationDetails.fromResult(speechRecognitionResult);
                System.out.println("CANCELED: Reason=" + cancellation.getReason());
    
                if (cancellation.getReason() == CancellationReason.Error) {
                    System.out.println("CANCELED: ErrorCode=" + cancellation.getErrorCode());
                    System.out.println("CANCELED: ErrorDetails=" + cancellation.getErrorDetails());
                    System.out.println("CANCELED: Did you set the speech resource key and region values?");
                }
            }
    
            System.exit(0);
        }
    }
    
  3. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

새 콘솔 애플리케이션을 실행하여 마이크의 음성 인식을 시작합니다.

javac SpeechRecognition.java -cp ".;target\dependency\*"
java -cp ".;target\dependency\*" SpeechRecognition

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

메시지가 표시되면 마이크에 말합니다. 말하는 내용이 텍스트로 출력되어야 합니다.

Speak into your microphone.
RECOGNIZED: Text=I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 이 예제에서는 RecognizeOnceAsync 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.
  • 오디오 파일에서 음성을 인식하려면 fromDefaultMicrophoneInput 대신 fromWavFileInput를 사용합니다.
    AudioConfig audioConfig = AudioConfig.fromWavFileInput("YourAudioFile.wav");
    
  • MP4와 같은 압축 오디오 파일의 경우 GStreamer를 설치하고 PullAudioInputStream 또는 PushAudioInputStream을 사용합니다. 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(npm) | GitHub의 추가 샘플 | 라이브러리 소스 코드

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

또한 로컬 컴퓨터에 오디오 파일이 필요합니다 .wav . 사용자 고유 .wav 의 파일(최대 30초)을 사용하거나 샘플 파일을 다운로드할 https://crbn.us/whatstheweatherlike.wav 수 있습니다.

환경 설정

작업을 수행하려면 먼저 JavaScript용 Speech SDK를 설치해야 합니다. 설치할 패키지 이름만 알고 싶으면 npm install microsoft-cognitiveservices-speech-sdk를 실행합니다. 단계별 설치 지침은 SDK 설치 가이드를 참조하세요.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 setx를 사용하여 환경 변수를 set 설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

파일에서 음성 인식

음성 인식을 위한 Node.js 콘솔 애플리케이션을 만들려면 다음 단계를 수행합니다.

  1. 새 프로젝트를 원하는 명령 프롬프트를 열고 SpeechRecognition.js라는 새 파일을 만듭니다.

  2. JavaScript용 Speech SDK를 설치합니다.

    npm install microsoft-cognitiveservices-speech-sdk
    
  3. 다음 코드를 SpeechRecognition.js에 복사합니다.

    const fs = require("fs");
    const sdk = require("microsoft-cognitiveservices-speech-sdk");
    
    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
    const speechConfig = sdk.SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
    speechConfig.speechRecognitionLanguage = "en-US";
    
    function fromFile() {
        let audioConfig = sdk.AudioConfig.fromWavFileInput(fs.readFileSync("YourAudioFile.wav"));
        let speechRecognizer = new sdk.SpeechRecognizer(speechConfig, audioConfig);
    
        speechRecognizer.recognizeOnceAsync(result => {
            switch (result.reason) {
                case sdk.ResultReason.RecognizedSpeech:
                    console.log(`RECOGNIZED: Text=${result.text}`);
                    break;
                case sdk.ResultReason.NoMatch:
                    console.log("NOMATCH: Speech could not be recognized.");
                    break;
                case sdk.ResultReason.Canceled:
                    const cancellation = sdk.CancellationDetails.fromResult(result);
                    console.log(`CANCELED: Reason=${cancellation.reason}`);
    
                    if (cancellation.reason == sdk.CancellationReason.Error) {
                        console.log(`CANCELED: ErrorCode=${cancellation.ErrorCode}`);
                        console.log(`CANCELED: ErrorDetails=${cancellation.errorDetails}`);
                        console.log("CANCELED: Did you set the speech resource key and region values?");
                    }
                    break;
            }
            speechRecognizer.close();
        });
    }
    fromFile();
    
  4. SpeechRecognition.js에서 YourAudioFile.wav를 사용자 고유의 WAV 파일로 바꿉니다. 이 예제에서는 WAV 파일의 음성만 인식합니다. 다른 오디오 형식에 대한 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요. 이 예제에서는 최대 30초 오디오를 지원합니다.

  5. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

새 콘솔 애플리케이션을 실행하여 파일의 음성 인식을 시작합니다.

node.exe SpeechRecognition.js

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

오디오 파일의 음성이 텍스트로 출력되어야 합니다.

RECOGNIZED: Text=I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

이 예제에서는 recognizeOnceAsync 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.

참고

마이크의 음성 인식은 Node.js에서 지원되지 않습니다. 이는 브라우저 기반 JavaScript 환경에서만 지원됩니다. 자세한 내용은 GitHub의 React 샘플마이크의 음성 텍스트 변환 구현을 참조하세요. React 샘플은 인증 토큰의 교환 및 관리를 위한 디자인 패턴을 보여줍니다. 또한 음성 텍스트 변환을 위해 마이크 또는 파일에서 오디오 캡처를 보여줍니다.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(다운로드) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

사전 요구 사항

환경 설정

Objective-C용 Speech SDK는 프레임워크 번들로 배포됩니다. 프레임워크는 iOS와 macOS 모두에서 Objective-C 및 Swift를 모두 지원합니다.

이 Speech SDK는 Xcode 프로젝트에서 CocoaPod로 사용하거나, 여기에서 직접 다운로드하고 수동으로 연결할 수 있습니다. 이 가이드에서는 CocoaPod를 사용합니다. 해당 설치 지침에 설명된 대로 CocoaPod 종속성 관리자를 설치합니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 setx를 사용하여 환경 변수를 set 설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

macOS 애플리케이션에서 음성을 인식하려면 다음 단계를 수행합니다.

  1. Azure-Samples/cognitive-services-speech-sdk 리포지토리를 복제하여 macOS의 Objective-C에서 마이크의 음성 인식 샘플 프로젝트를 가져옵니다. 리포지토리에는 iOS 샘플도 있습니다.

  2. 터미널에서 다운로드한 샘플 앱(helloworld)의 디렉터리로 이동합니다.

  3. pod install 명령을 실행합니다. 이렇게 하면 종속성으로 샘플 앱 및 Speech SDK가 모두 포함되는 helloworld.xcworkspace Xcode 작업 영역이 생성됩니다.

  4. XCode에서 helloworld.xcworkspace 작업 영역을 엽니다.

  5. 여기에 표시된 대로 AppDelegate.m이라는 파일을 열고 buttonPressed 메서드를 찾습니다.

    - (void)buttonPressed:(NSButton *)button {
        // Creates an instance of a speech config with specified subscription key and service region.
        NSString *speechKey = [[[NSProcessInfo processInfo] environment] objectForKey:@"SPEECH_KEY"];
        NSString *serviceRegion = [[[NSProcessInfo processInfo] environment] objectForKey:@"SPEECH_REGION"];
    
        SPXAudioConfiguration *audioConfig = [[SPXAudioConfiguration alloc] initWithMicrophone:nil];
        SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithSubscription:speechKey region:serviceRegion];
        SPXSpeechRecognizer *speechRecognizer = [[SPXSpeechRecognizer alloc] initWithSpeechConfiguration:speechConfig language:@"en-US" audioConfiguration:audioConfig];
    
        NSLog(@"Speak into your microphone.");
    
        SPXSpeechRecognitionResult *speechResult = [speechRecognizer recognizeOnce];
    
        // Checks result.
        if (SPXResultReason_Canceled == speechResult.reason) {
            SPXCancellationDetails *details = [[SPXCancellationDetails alloc] initFromCanceledRecognitionResult:speechResult];
            NSLog(@"Speech recognition was canceled: %@. Did you set the speech resource key and region values?", details.errorDetails);
            [self.label setStringValue:([NSString stringWithFormat:@"Canceled: %@", details.errorDetails])];
        } else if (SPXResultReason_RecognizedSpeech == speechResult.reason) {
            NSLog(@"Speech recognition result received: %@", speechResult.text);
            [self.label setStringValue:(speechResult.text)];
        } else {
            NSLog(@"There was an error.");
            [self.label setStringValue:(@"Speech Recognition Error")];
        }
    }
    
  6. 에서 AppDelegate.mSpeech 리소스 키 및 지역에 대해 이전에 설정한 환경 변수 를 사용합니다.

    NSString *speechKey = [[[NSProcessInfo processInfo] environment] objectForKey:@"SPEECH_KEY"];
    NSString *serviceRegion = [[[NSProcessInfo processInfo] environment] objectForKey:@"SPEECH_REGION"];
    
  7. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

  8. 디버그 출력을 표시되도록 설정합니다(>디버그 영역>콘솔 활성화).

  9. 메뉴에서 제품>실행을 선택하거나 재생 단추를 선택하여 예제 코드를 빌드하고 실행합니다.

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

앱에서 이 단추를 선택하고 몇 단어를 말하면 화면 아래쪽 부분에 사용자가 말한 텍스트가 표시되어야 합니다. 처음으로 앱을 실행하는 경우 컴퓨터 마이크에 대한 앱 액세스 권한을 부여하라는 메시지가 표시됩니다.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 이 예제에서는 recognizeOnce 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.
  • 오디오 파일에서 음성을 인식하려면 initWithMicrophone 대신 initWithWavFileInput를 사용합니다.
    SPXAudioConfiguration *audioConfig = [[SPXAudioConfiguration alloc] initWithWavFileInput:YourAudioFile];
    

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(다운로드) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

필수 구성 요소

환경 설정

Swift용 Speech SDK는 프레임워크 번들로 배포됩니다. 프레임워크는 iOS와 macOS 모두에서 Objective-C 및 Swift를 모두 지원합니다.

이 Speech SDK는 Xcode 프로젝트에서 CocoaPod로 사용하거나, 여기에서 직접 다운로드하고 수동으로 연결할 수 있습니다. 이 가이드에서는 CocoaPod를 사용합니다. 해당 설치 지침에 설명된 대로 CocoaPod 종속성 관리자를 설치합니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 setx를 사용하여 환경 변수를 set 설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

macOS 애플리케이션에서 음성을 인식하려면 다음 단계를 수행합니다.

  1. Azure-Samples/cognitive-services-speech-sdk 리포지토리를 복제하여 macOS의 Swift에서 마이크의 음성 인식 샘플 프로젝트를 가져옵니다. 리포지토리에는 iOS 샘플도 있습니다.

  2. 터미널에서 다운로드한 샘플 앱(helloworld)의 디렉터리로 이동합니다.

  3. pod install 명령을 실행합니다. 이렇게 하면 종속성으로 샘플 앱 및 Speech SDK가 모두 포함되는 helloworld.xcworkspace Xcode 작업 영역이 생성됩니다.

  4. XCode에서 helloworld.xcworkspace 작업 영역을 엽니다.

  5. 여기에 표시된 대로 AppDelegate.swift이라는 파일을 열고 applicationDidFinishLaunchingrecognizeFromMic 메서드를 찾습니다.

    import Cocoa
    
    @NSApplicationMain
    class AppDelegate: NSObject, NSApplicationDelegate {
        var label: NSTextField!
        var fromMicButton: NSButton!
    
        var sub: String!
        var region: String!
    
        @IBOutlet weak var window: NSWindow!
    
        func applicationDidFinishLaunching(_ aNotification: Notification) {
            print("loading")
            // load subscription information
            sub = ProcessInfo.processInfo.environment["SPEECH_KEY"]
            region = ProcessInfo.processInfo.environment["SPEECH_REGION"]
    
            label = NSTextField(frame: NSRect(x: 100, y: 50, width: 200, height: 200))
            label.textColor = NSColor.black
            label.lineBreakMode = .byWordWrapping
    
            label.stringValue = "Recognition Result"
            label.isEditable = false
    
            self.window.contentView?.addSubview(label)
    
            fromMicButton = NSButton(frame: NSRect(x: 100, y: 300, width: 200, height: 30))
            fromMicButton.title = "Recognize"
            fromMicButton.target = self
            fromMicButton.action = #selector(fromMicButtonClicked)
            self.window.contentView?.addSubview(fromMicButton)
        }
    
        @objc func fromMicButtonClicked() {
            DispatchQueue.global(qos: .userInitiated).async {
                self.recognizeFromMic()
            }
        }
    
        func recognizeFromMic() {
            var speechConfig: SPXSpeechConfiguration?
            do {
                try speechConfig = SPXSpeechConfiguration(subscription: sub, region: region)
            } catch {
                print("error \(error) happened")
                speechConfig = nil
            }
            speechConfig?.speechRecognitionLanguage = "en-US"
    
            let audioConfig = SPXAudioConfiguration()
    
            let reco = try! SPXSpeechRecognizer(speechConfiguration: speechConfig!, audioConfiguration: audioConfig)
    
            reco.addRecognizingEventHandler() {reco, evt in
                print("intermediate recognition result: \(evt.result.text ?? "(no result)")")
                self.updateLabel(text: evt.result.text, color: .gray)
            }
    
            updateLabel(text: "Listening ...", color: .gray)
            print("Listening...")
    
            let result = try! reco.recognizeOnce()
            print("recognition result: \(result.text ?? "(no result)"), reason: \(result.reason.rawValue)")
            updateLabel(text: result.text, color: .black)
    
            if result.reason != SPXResultReason.recognizedSpeech {
                let cancellationDetails = try! SPXCancellationDetails(fromCanceledRecognitionResult: result)
                print("cancelled: \(result.reason), \(cancellationDetails.errorDetails)")
                print("Did you set the speech resource key and region values?")
                updateLabel(text: "Error: \(cancellationDetails.errorDetails)", color: .red)
            }
        }
    
        func updateLabel(text: String?, color: NSColor) {
            DispatchQueue.main.async {
                self.label.stringValue = text!
                self.label.textColor = color
            }
        }
    }
    
  6. 에서 AppDelegate.mSpeech 리소스 키 및 지역에 대해 이전에 설정한 환경 변수 를 사용합니다.

    sub = ProcessInfo.processInfo.environment["SPEECH_KEY"]
    region = ProcessInfo.processInfo.environment["SPEECH_REGION"]
    
  7. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

  8. 보기>디버그 영역>콘솔 활성화를 선택하여 디버그 출력을 표시합니다.

  9. 메뉴에서 제품>실행을 선택하거나 재생 단추를 선택하여 예제 코드를 빌드하고 실행합니다.

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

앱에서 이 단추를 선택하고 몇 단어를 말하면 화면 아래쪽 부분에 사용자가 말한 텍스트가 표시되어야 합니다. 처음으로 앱을 실행하는 경우 컴퓨터 마이크에 대한 앱 액세스 권한을 부여하라는 메시지가 표시됩니다.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

이 예제에서는 recognizeOnce 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

참조 설명서 | 패키지(PyPi) | GitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

필수 구성 요소

환경 설정

Python용 Speech SDK는 PyPI(Python Package Index) 모듈로 사용할 수 있습니다. Python용 Speech SDK는 Windows, Linux 및 macOS와 호환됩니다.

Python 3.7~3.10 버전을 설치합니다. 먼저 SDK 설치 가이드에서 더 많은 요구 사항을 확인합니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 를 사용하여 환경 변수를 setsetx설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

마이크에서 음성 인식

새 콘솔 애플리케이션을 만들려면 다음 단계를 수행합니다.

  1. 새 프로젝트를 원하는 명령 프롬프트를 열고 speech_recognition.py라는 새 파일을 만듭니다.

  2. 다음 명령을 실행하여 Speech SDK를 설치합니다.

    pip install azure-cognitiveservices-speech
    
  3. 다음 코드를 speech_recognition.py에 복사합니다.

    import os
    import azure.cognitiveservices.speech as speechsdk
    
    def recognize_from_microphone():
        # This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
        speech_config = speechsdk.SpeechConfig(subscription=os.environ.get('SPEECH_KEY'), region=os.environ.get('SPEECH_REGION'))
        speech_config.speech_recognition_language="en-US"
    
        audio_config = speechsdk.audio.AudioConfig(use_default_microphone=True)
        speech_recognizer = speechsdk.SpeechRecognizer(speech_config=speech_config, audio_config=audio_config)
    
        print("Speak into your microphone.")
        speech_recognition_result = speech_recognizer.recognize_once_async().get()
    
        if speech_recognition_result.reason == speechsdk.ResultReason.RecognizedSpeech:
            print("Recognized: {}".format(speech_recognition_result.text))
        elif speech_recognition_result.reason == speechsdk.ResultReason.NoMatch:
            print("No speech could be recognized: {}".format(speech_recognition_result.no_match_details))
        elif speech_recognition_result.reason == speechsdk.ResultReason.Canceled:
            cancellation_details = speech_recognition_result.cancellation_details
            print("Speech Recognition canceled: {}".format(cancellation_details.reason))
            if cancellation_details.reason == speechsdk.CancellationReason.Error:
                print("Error details: {}".format(cancellation_details.error_details))
                print("Did you set the speech resource key and region values?")
    
    recognize_from_microphone()
    
  4. 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다. 음성에 사용될 수 있는 여러 언어 중 하나를 식별하는 방법에 대한 자세한 내용은 언어 식별을 참조하세요.

새 콘솔 애플리케이션을 실행하여 마이크의 음성 인식을 시작합니다.

python speech_recognition.py

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

메시지가 표시되면 마이크에 말합니다. 말하는 내용이 텍스트로 출력되어야 합니다.

Speak into your microphone.
RECOGNIZED: Text=I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 이 예제에서는 recognize_once_async 작업을 사용하여 최대 30초의 발화를 기록하거나 침묵이 감지될 때까지 기록합니다. 다국어 대화를 포함한 더 긴 오디오에 대한 지속적인 인식에 대한 자세한 내용은 음성을 인식하는 방법을 참조하세요.
  • 오디오 파일에서 음성을 인식하려면 use_default_microphone 대신 filename를 사용합니다.
    audio_config = speechsdk.audio.AudioConfig(filename="YourAudioFile.wav")
    
  • MP4와 같은 압축 오디오 파일의 경우 GStreamer를 설치하고 PullAudioInputStream 또는 PushAudioInputStream을 사용합니다. 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

음성 텍스트 변환 REST API 참조 | 짧은 오디오 참조 | 를 위한 음성 텍스트 변환 REST APIGitHub의 추가 샘플

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

필수 구성 요소

로컬 컴퓨터에 오디오 파일도 필요합니다 .wav . 사용자 고유 .wav 의 파일(최대 30초)을 사용하거나 샘플 파일을 다운로드할 https://crbn.us/whatstheweatherlike.wav 수 있습니다.

환경 변수 설정

Cognitive Services 리소스에 액세스하려면 애플리케이션을 인증해야 합니다. 프로덕션의 경우 자격 증명을 안전하게 저장하고 액세스하는 방법을 사용합니다. 예를 들어 에 대한 키를 받은 후 애플리케이션을 실행하는 로컬 컴퓨터의 새 환경 변수에 씁니다.

코드에 키를 직접 포함하지 말고 공개적으로 게시하지 마세요. Azure Key Vault 같은 추가 인증 옵션은 Cognitive Services 보안 문서를 참조하세요.

Speech 리소스 키에 대한 환경 변수를 설정하려면 콘솔 창을 열고 운영 체제 및 개발 환경에 대한 지침을 따릅니다. 환경 변수를 설정하려면 을 SPEECH_KEY 리소스의 키 중 하나로 바꿉 your-key 있습니다.

setx SPEECH_KEY your-key

참고

현재 실행 중인 콘솔에서 환경 변수에만 액세스해야 하는 경우 대신 를 사용하여 환경 변수를 setsetx설정할 수 있습니다.

환경 변수를 추가한 후에는 콘솔 창을 포함하여 실행 중인 프로그램 중에서 환경 변수를 읽어야 하는 프로그램을 다시 시작해야 할 수도 있습니다. 예를 들어 편집기로 Visual Studio를 사용하는 경우 Visual Studio를 다시 시작한 후 예제를 실행합니다.

Speech 리소스 지역에 대한 환경 변수를 설정하려면 동일한 단계를 수행합니다. 리소스의 지역으로 설정합니다 SPEECH_REGION . 예들 들어 westus입니다.

파일에서 음성 인식

명령 프롬프트에서 다음 cURL 명령을 실행합니다. 을 오디오 파일의 경로 및 이름으로 바꿉 있습니다 YourAudioFile.wav .

audio_file=@'YourAudioFile.wav'

curl --location --request POST \
"https://${SPEECH_REGION}.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US" \
--header "Ocp-Apim-Subscription-Key: ${SPEECH_KEY}" \
--header "Content-Type: audio/wav" \
--data-binary $audio_file

중요

위에서 설명한 SPEECH__KEY 대로 및 SPEECH__REGION 환경 변수를 설정해야 합니다. 이러한 변수를 설정하지 않으면 샘플이 오류 메시지와 함께 실패합니다.

여기에 표시된 것과 유사한 응답이 수신되어야 합니다. DisplayText는 오디오 파일에서 인식된 텍스트여야 합니다. 최대 30초 분량의 오디오가 인식되어 텍스트로 변환됩니다.

{
    "RecognitionStatus": "Success",
    "DisplayText": "My voice is my passport, verify me.",
    "Offset": 6600000,
    "Duration": 32100000
}

자세한 내용은 짧은 오디오를 위한 음성 텍스트 변환 REST API를 참조하세요.

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

이 빠른 시작에서는 애플리케이션을 실행하여 사람의 음성을 인식하고 기록합니다(음성 텍스트 변환이라고도 함).

코드를 등록하거나 작성하지 않고 Speech Studio에서 음성 텍스트 변환을 시도할 수 있습니다.

필수 구성 요소

환경 설정

다음 단계를 수행합니다. 플랫폼에 대한 추가 요구 사항은 Speech CLI 빠른 시작을 참조하세요.

  1. 다음 명령을 입력하여 .NET CLI를 통해 Speech CLI를 설치합니다.

    dotnet tool install --global Microsoft.CognitiveServices.Speech.CLI
    
  2. 다음 명령을 실행하여 음성 리소스 키 및 지역을 구성합니다. SUBSCRIPTION-KEY를 음성 리소스 키로 바꾸고, REGION을 음성 리소스 지역으로 바꿉니다.

    spx config @key --set SUBSCRIPTION-KEY
    spx config @region --set REGION
    

마이크에서 음성 인식

다음 명령을 실행하여 마이크에서 음성 인식을 시작합니다.

spx recognize --microphone --source en-US

마이크에 대고 말하면 실시간으로 단어를 텍스트로 전사하는 것을 볼 수 있습니다. 음성 CLI는 30초 동안 침묵 후 또는 Ctrl+C를 누를 때 중지됩니다.

Connection CONNECTED...
RECOGNIZED: I'm excited to try speech to text.

설명

이제 빠른 시작을 완료했으므로 다음과 같은 몇 가지 추가 고려 사항이 있습니다.

  • 오디오 파일에서 음성을 인식하려면 --microphone 대신 --file을 사용합니다. MP4와 같은 압축 오디오 파일의 경우 GStreamer를 설치하고 --format을 사용합니다. 자세한 내용은 압축 입력 오디오 사용 방법을 참조하세요.
    spx recognize --file YourAudioFile.wav
    spx recognize --file YourAudioFile.mp4 --format any
    
  • 특정 단어 또는 발화의 인식 정확도를 높이려면 구 목록을 사용합니다. 인식 명령과 함께 인라인으로 또는 텍스트 파일을 사용해서 구 목록을 포함할 수 있습니다.
    spx recognize --microphone --phrases "Contoso;Jessie;Rehaan;"
    spx recognize --microphone --phrases @phrases.txt
    
  • 음성 인식 언어를 변경하려면 en-US를 다른 지원되는 언어로 바꿉니다. 예를 들어 스페인어(스페인)의 경우 es-ES입니다. 언어를 지정하지 않은 경우 기본 언어는 en-US입니다.
    spx recognize --microphone --source es-ES
    
  • 30초보다 긴 오디오를 지속적으로 인식하려면 --continuous를 추가합니다.
    spx recognize --microphone --source es-ES --continuous
    

파일 입력 및 출력과 같은 추가 음성 인식 옵션에 대한 정보를 보려면 다음 명령을 실행합니다.

spx help recognize

리소스 정리

Azure Portal 또는 Azure CLI(명령줄 인터페이스)를 사용하여 생성된 음성 리소스를 제거할 수 있습니다.

다음 단계