Dela via


VoiceInformation Class

Definition

Provides info about an installed speech synthesis engine (voice).

public ref class VoiceInformation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class VoiceInformation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class VoiceInformation
Public NotInheritable Class VoiceInformation
Inheritance
Object Platform::Object IInspectable VoiceInformation
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Only Microsoft-signed voices installed on the system can be used to generate speech with a SpeechSynthesizer. Each voice generates synthesized speech in a single language, as spoken in a specific country/region.

Here is a list of Microsoft-signed voices provided with Windows.

VoiceGenderWindows 8Windows 8.1NameDisplay name
English USFemaleYYZiraMicrosoft Zira (en-US, female).
English USMaleYYDavidMicrosoft David (en-US, male)
English GBFemaleYYHazelMicrosoft Hazel (en-GB, female)
French FRFemaleYYHortenseMicrosoft Hortense (fr-FR , female)
German DEFemaleYYHeddaMicrosoft Hedda (de-DE, female)
Spanish ESFemaleYYHelenaMicrosoft Helena (es-ES, female)
Chinese PRCFemaleYYHuihuiMicrosoft Huihui (zh-CN, female)
Chinese TWFemaleYYHanhanMicrosoft Hanhan (zh-TW, female)
Japanese JAFemaleYYHarukaMicrosoft Haruka (ja-JP, female)
Korean KRFemaleYYHeamiMicrosoft Heami (ko-KR, female)
Spanish MXFemaleNYSabinaMicrosoft Sabina (es-MX, female)
Italian ITFemaleNYElsaMicrosoft Elsa (it-IT, female)
English INFemaleNYHeeraMicrosoft Heera (en-IN, female)
Russian RUFemaleNYIrinaMicrosoft Irina (ru-RU, female)
Chinese HKFemaleNYTracyMicrosoft Tracy (zh-HK, female)
Polish PLFemaleNYPaulinaMicrosoft Paulina (pl-PL, female)
Portuguese BRFemaleNYMariaMicrosoft Maria (pt-BR, female)

By default, a new SpeechSynthesizer object uses the current system voice (call DefaultVoice to find out what the default voice is).

To specify any of the other speech synthesis (text-to-speech) voices installed on the user's system, use the Voice method (to find out which voices are installed on the system, call AllVoices).

If you don't specify a language, the voice that most closely corresponds to the language selected in the Language control panel is loaded.

Properties

Description

Gets the description of the speech synthesis engine (voice).

DisplayName

Gets the display name associated with the speech synthesis engine (voice).

Gender

Gets the gender setting of the speech synthesis engine (voice).

Id

Gets the unique ID of the speech synthesis engine (voice).

Language

Gets the normalized BCP-47 language tag of the speech synthesis engine (voice).

Applies to

See also