SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer SpeechSynthesizer Class

정의

설치된 음성 합성 엔진의 기능에 액세스할 수 있습니다.Provides access to the functionality of an installed speech synthesis engine.

public ref class SpeechSynthesizer sealed : IDisposable
public sealed class SpeechSynthesizer : IDisposable
type SpeechSynthesizer = class
    interface IDisposable
Public NotInheritable Class SpeechSynthesizer
Implements IDisposable
상속
SpeechSynthesizerSpeechSynthesizerSpeechSynthesizerSpeechSynthesizer
구현

예제

다음 예제는 초기화 하는 콘솔 애플리케이션의 일부를 SpeechSynthesizer 개체 및 문자열을 말합니다.The following example is part of a console application that initializes a SpeechSynthesizer object and speaks a string.


using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      SpeechSynthesizer synth = new SpeechSynthesizer();  

      // Configure the audio output.   
      synth.SetOutputToDefaultAudioDevice();  

      // Speak a string.  
      synth.Speak("This example demonstrates a basic use of Speech Synthesizer");  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

설명

새로 만들 때 SpeechSynthesizer 개체를 기본 시스템 음성을 사용 합니다.When you create a new SpeechSynthesizer object, it uses the default system voice. 구성 하는 SpeechSynthesizer 설치 된 음성 합성 (텍스트 음성 변환) 음성 중 하나를 사용 하려면 사용 합니다 SelectVoice 또는 SelectVoiceByHints 메서드.To configure the SpeechSynthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the SelectVoice or SelectVoiceByHints method. 에 설치 된 음성에 대 한 정보를 가져오려면 다음을 사용 합니다 GetInstalledVoices 메서드 및 VoiceInfo 클래스입니다.To get information about which voices are installed, use the GetInstalledVoices method and the VoiceInfo class.

또한이 클래스는 음성 합성의 다음 양상에 대 한 제어를 제공 합니다.This class also provides control over the following aspects of speech synthesis:

SpeechSynthesizer 표시 되는 메시지의 특정 기능을 발견할 때 이벤트를 발생 시키는: (BookmarkReached, PhonemeReached, VisemeReached, 및 SpeakProgress).The SpeechSynthesizer raises events when it encounters certain features in prompts: (BookmarkReached, PhonemeReached, VisemeReached, and SpeakProgress). 시작 시 보고 하는 이벤트 발생 (SpeakStarted) 및 종료 (SpeakCompleted)의 작업을 사용 및 음성의 변경 내용에 대 (VoiceChange).It also raises events that report on the start (SpeakStarted) and end (SpeakCompleted) of speak operations and on the change of the speaking voice (VoiceChange).

참고

Dispose에 대한 마지막 참조를 해제하기 전에 반드시 SpeechSynthesizer를 호출하십시오.Always call Dispose before you release your last reference to the SpeechSynthesizer. 이렇게 하지 않으면 가비지 컬렉션이 SpeechSynthesizer 개체의 Finalize 메서드를 호출할 때까지 사용 중인 리소스가 해제되지 않습니다.Otherwise, the resources it is using will not be freed until the garbage collector calls the SpeechSynthesizer object's Finalize method.

생성자

SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer() SpeechSynthesizer()

SpeechSynthesizer 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the SpeechSynthesizer class.

속성

Rate Rate Rate Rate

SpeechSynthesizer 개체의 읽어주기 속도를 가져오거나 설정합니다.Gets or sets the speaking rate of the SpeechSynthesizer object.

State State State State

SpeechSynthesizer 개체의 현재 말하기 상태를 가져옵니다.Gets the current speaking state of the SpeechSynthesizer object.

Voice Voice Voice Voice

SpeechSynthesizer 개체의 현재 음성에 대한 정보를 가져옵니다.Gets information about the current voice of the SpeechSynthesizer object.

Volume Volume Volume Volume

SpeechSynthesizer 개체의 출력 볼륨을 가져오거나 설정합니다.Get or sets the output volume of the SpeechSynthesizer object.

메서드

AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String) AddLexicon(Uri, String)

SpeechSynthesizer 개체에 어휘집을 추가합니다.Adds a lexicon to the SpeechSynthesizer object.

Dispose() Dispose() Dispose() Dispose()

SpeechSynthesizer 개체를 삭제하고 세션 중에 사용되는 리소스를 해제합니다.Disposes the SpeechSynthesizer object and releases resources used during the session.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Dispose() 메서드가 호출되지 않을 경우 리소스를 정리하는 보호 기능으로 사용됩니다.Acts as a safeguard to clean up resources in the event that the Dispose() method is not called.

GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt() GetCurrentlySpokenPrompt()

SpeechSynthesizer에서 말하는 프롬프트를 가져옵니다.Gets the prompt that the SpeechSynthesizer is speaking.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetInstalledVoices() GetInstalledVoices() GetInstalledVoices() GetInstalledVoices()

설치된 음성의 모든 설치된 합성 음성(텍스트 음성 변환)을 반환합니다.Returns all of the installed speech synthesis (text-to-speech) voices.

GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo) GetInstalledVoices(CultureInfo)

설치된 음성의 모든 특정 로케일 지원 (텍스트 음성 변환) 합성 음성을 반환합니다.Returns all of the installed speech synthesis (text-to-speech) voices that support a specific locale.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
Pause() Pause() Pause() Pause()

SpeechSynthesizer 개체를 일시 정지합니다.Pauses the SpeechSynthesizer object.

RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri) RemoveLexicon(Uri)

SpeechSynthesizer 개체에서 어휘집을 제거합니다.Removes a lexicon from the SpeechSynthesizer object.

Resume() Resume() Resume() Resume()

일시 중지된 후 SpeechSynthesizer 개체를 다시 시작합니다.Resumes the SpeechSynthesizer object after it has been paused.

SelectVoice(String) SelectVoice(String) SelectVoice(String) SelectVoice(String)

특정 음성 이름으로 선택합니다.Selects a specific voice by name.

SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender) SelectVoiceByHints(VoiceGender)

음성을 사용하여 특정 성별을 선택합니다.Selects a voice with a specific gender.

SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge) SelectVoiceByHints(VoiceGender, VoiceAge)

음성을 사용 하 여 특정 성별 및 시대를 선택합니다.Selects a voice with a specific gender and age.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32) SelectVoiceByHints(VoiceGender, VoiceAge, Int32)

음성이 정렬되는 위치를 기준으로 특정 성별과 나이의 음성을 선택합니다.Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo) SelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

음성이 정렬되는 위치를 기준으로 특정 성별과 나이, 로캘의 음성을 선택합니다.Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo) SetOutputToAudioStream(Stream, SpeechAudioFormatInfo)

오디오 스트림에 출력을 추가하도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to append output to an audio stream.

SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice() SetOutputToDefaultAudioDevice()

기본 오디오 디바이스에 출력을 보내도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to send output to the default audio device.

SetOutputToNull() SetOutputToNull() SetOutputToNull() SetOutputToNull()

합성 작업에서 디바이스, 파일 또는 스트림으로 출력을 보내지 않도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to not send output from synthesis operations to a device, file, or stream.

SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String) SetOutputToWaveFile(String)

Waveform 형식 오디오를 포함하는 파일에 출력을 추가하도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to append output to a file that contains Waveform format audio.

SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo) SetOutputToWaveFile(String, SpeechAudioFormatInfo)

지정된 형식의 Waveform 오디오 형식 파일에 출력을 추가하도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to append output to a Waveform audio format file in a specified format.

SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream) SetOutputToWaveStream(Stream)

Waveform 형식 오디오를 포함하는 스트림에 출력을 추가하도록 SpeechSynthesizer 개체를 구성합니다.Configures the SpeechSynthesizer object to append output to a stream that contains Waveform format audio.

Speak(Prompt) Speak(Prompt) Speak(Prompt) Speak(Prompt)

Prompt 객체의 내용을 동기적으로 말합니다.Synchronously speaks the contents of a Prompt object.

Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder) Speak(PromptBuilder)

PromptBuilder 객체의 내용을 동기적으로 말합니다.Synchronously speaks the contents of a PromptBuilder object.

Speak(String) Speak(String) Speak(String) Speak(String)

문자열의 내용을 동기적으로 말합니다.Synchronously speaks the contents of a string.

SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt) SpeakAsync(Prompt)

Prompt 개체의 내용을 비동기적으로 말합니다.Asynchronously speaks the contents of a Prompt object.

SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder) SpeakAsync(PromptBuilder)

PromptBuilder 개체의 내용을 비동기적으로 말합니다.Asynchronously speaks the contents of a PromptBuilder object.

SpeakAsync(String) SpeakAsync(String) SpeakAsync(String) SpeakAsync(String)

문자열의 내용을 비동기적으로 말합니다.Asynchronously speaks the contents of a string.

SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt) SpeakAsyncCancel(Prompt)

쿼리된 프롬프트에 대한 비동기 합성 작업을 취소합니다.Cancels the asynchronous synthesis operation for a queued prompt.

SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll() SpeakAsyncCancelAll()

모든 쿼리된 비동기 음성 합성 작업을 취소합니다.Cancels all queued, asynchronous, speech synthesis operations.

SpeakSsml(String) SpeakSsml(String) SpeakSsml(String) SpeakSsml(String)

SSML 태그를 포함하는 String을 동기적으로 말합니다.Synchronously speaks a String that contains SSML markup.

SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String) SpeakSsmlAsync(String)

SSML 태그를 포함하는 String을 비동기적으로 말합니다.Asynchronously speaks a String that contains SSML markup.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

이벤트

BookmarkReached BookmarkReached BookmarkReached BookmarkReached

SpeechSynthesizer가 프롬프트에서 책갈피를 발견할 때 발생했습니다.Raised when the SpeechSynthesizer encounters a bookmark in a prompt.

PhonemeReached PhonemeReached PhonemeReached PhonemeReached

음소가 달성될 때 발생했습니다.Raised when a phoneme is reached.

SpeakCompleted SpeakCompleted SpeakCompleted SpeakCompleted

SpeechSynthesizer가 프롬프트에 대해 말하기를 완료할 때 발생했습니다.Raised when the SpeechSynthesizer completes the speaking of a prompt.

SpeakProgress SpeakProgress SpeakProgress SpeakProgress

SpeechSynthesizer가 프롬프트의 개개의 단어를 말한 후에 발생했습니다.Raised after the SpeechSynthesizer speaks each individual word of a prompt.

SpeakStarted SpeakStarted SpeakStarted SpeakStarted

SpeechSynthesizer가 프롬프트를 말하기 시작할 때 발생했습니다.Raised when the SpeechSynthesizer begins the speaking of a prompt.

StateChanged StateChanged StateChanged StateChanged

SpeechSynthesizer의 상태가 변경될 때 발생했습니다.Raised when the state of the SpeechSynthesizer changes.

VisemeReached VisemeReached VisemeReached VisemeReached

viseme가 달성될 때 발생했습니다.Raised when a viseme is reached.

VoiceChange VoiceChange VoiceChange VoiceChange

SpeechSynthesizer의 보이스가 변경될 때 발생했습니다.Raised when the voice of the SpeechSynthesizer changes.

적용 대상

추가 정보