xtd::speech::synthesis::speech_synthesizer Class Reference

Definition

Provides access to the functionality of an installed speech synthesis engine.

class core_export_ speech_synthesizer : public xtd::object

Inheritance

xtd::object → xtd::speech::synthesis::speech_synthesizer

Header

#include <xtd/speech/synthesis/speech_synthesizer> 

Namespace

xtd::speech::synthesis

Library

xtd.core

Examples:

hello_world_say.cpp.

Constructors
	speech_synthesizer ()
	Initializes a new instance of the xtd::speech::synthesis::speech_synthesizer class. More...

Properties
synthesizer_state	state () const noexcept
	Gets the current speaking state of the xtd::speech::speech_synthesizer object. More...

Methods
void	speak (const xtd::ustring &text_to_speak)
	Synchronously speaks the contents of a string. More...
void	speak (xtd::speech::synthesis::prompt &prompt)
	Synchronously speaks the contents of a xtd::speech::synthesis::prompt object. More...
xtd::speech::synthesis::prompt &	speak_async (const xtd::ustring &text_to_speak)
	Asynchronously speaks the contents of a string. More...
void	speak_async (xtd::speech::synthesis::prompt &prompt)
	Asynchronously speaks the contents of a xtd::speech::synthesis::prompt object. More...

Events
event< speech_synthesizer, speak_completed_event_handler >	speak_completed
	Raised when the xtd::speech::synthesis::speech_synthesizer completes the speaking of a prompt. More...
event< speech_synthesizer, speak_started_event_handler >	speak_started
	Raised when the xtd::speech::synthesis::speech_synthesizer begins the speaking of a prompt. More...
event< speech_synthesizer, state_changed_event_handler >	state_changed
	Raised when the state of the xtd::speech::synthesis::speech_synthesizer changes. More...

Additional Inherited Members
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object. More...
bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object. More...
virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type. More...
virtual type_object	get_type () const noexcept
	Gets the type of the current instance. More...
template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const noexcept
	Creates a shallow copy of the current object. More...
virtual xtd::ustring	to_string () const noexcept
	Returns a sxd::ustring that represents the current object. More...
Static Public Member Functions inherited from xtd::object
static bool	equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are considered equal. More...
static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance. More...

Constructor & Destructor Documentation

speech_synthesizer()

xtd::speech::synthesis::speech_synthesizer::speech_synthesizer

(

)

Initializes a new instance of the xtd::speech::synthesis::speech_synthesizer class.

Remarks

When you initialize a new xtd::speech::synthesis::speech_synthesizer instance, it uses the default system voice. To configure the xtd::speech::synthesis::speech_synthesizer to use one of the installed speech synthesis (text-to-speech) voices, use the xtd::speech::synthesis::speech_synthesizer::select_voice or xtd::speech::synthesis::speech_synthesizer::select_voice_by_hints method. To get information about which voices are installed, use the xtd::speech::synthesis::speech_synthesizer::get_installed_voices method and the xtd::speech::synthesis::voice_info class.

Member Function Documentation

speak() [1/2]

void xtd::speech::synthesis::speech_synthesizer::speak

(

const xtd::ustring &

text_to_speak

)

Synchronously speaks the contents of a string.

Parameters

text_to_speak

The text to speak.

Remarks

To asynchronously speak the contents of a xtd::speech::synthesis::prompt_builder object, use xtd::speech::synthesis::speech_synthesizer::speak_async.

speak() [2/2]

void xtd::speech::synthesis::speech_synthesizer::speak

(

xtd::speech::synthesis::prompt &

prompt

)

Synchronously speaks the contents of a xtd::speech::synthesis::prompt object.

Parameters

prompt

The content to speak.

Remarks

To asynchronously speak the contents of a xtd::speech::synthesis::prompt_builder object, use xtd::speech::synthesis::speech_synthesizer::speak_async.

speak_async() [1/2]

xtd::speech::synthesis::prompt& xtd::speech::synthesis::speech_synthesizer::speak_async

(

const xtd::ustring &

text_to_speak

)

Asynchronously speaks the contents of a string.

Parameters

text_to_speak

The text to speak.

Returns

Returns the object that contains the content to speak.

speak_async() [2/2]

void xtd::speech::synthesis::speech_synthesizer::speak_async

(

xtd::speech::synthesis::prompt &

prompt

)

Asynchronously speaks the contents of a xtd::speech::synthesis::prompt object.

Parameters

prompt

The content to speak.

state()

synthesizer_state xtd::speech::synthesis::speech_synthesizer::state ( ) const

noexcept

Gets the current speaking state of the xtd::speech::speech_synthesizer object.

Returns

Returns the current speaking state of the xtd::speech::speech_synthesizer object.

Member Data Documentation

speak_completed

event<speech_synthesizer, speak_completed_event_handler> xtd::speech::synthesis::speech_synthesizer::speak_completed

Raised when the xtd::speech::synthesis::speech_synthesizer completes the speaking of a prompt.

Remarks

The xtd::speech::synthesis::speech_synthesizer raises the xtd::speech::synthesis::speech_synthesizer::speak_completed event at the completion of any of the xtd::speech::synthesis::speech_synthesizer::speak, xtd::speech::synthesis::speech_synthesizer::speak_async, xtd::speech::synthesis::speech_synthesizer::speak_ssml, or xtd::speech::synthesis::speech_synthesizer::speak_ssml_async methods.

speak_started

event<speech_synthesizer, speak_started_event_handler> xtd::speech::synthesis::speech_synthesizer::speak_started

Raised when the xtd::speech::synthesis::speech_synthesizer begins the speaking of a prompt.

Remarks

The xtd::speech::synthesis::speech_synthesizer raises this event when it begins processing a prompt using any of the xtd::speech::synthesis::speech_synthesizer::speak, xtd::speech::synthesis::speech_synthesizer::speak_async, xtd::speech::synthesis::speech_synthesizer::speak_ssml, or xtd::speech::synthesis::speech_synthesizer::speak_ssml_async methods.

state_changed

event<speech_synthesizer, state_changed_event_handler> xtd::speech::synthesis::speech_synthesizer::state_changed

Raised when the state of the xtd::speech::synthesis::speech_synthesizer changes.

Remarks

The xtd::speech::synthesis::speech_synthesizer raises this event when its speaking xtd::speech::synthesis::speech_synthesizer::state changes. For an example and more information about data associated with the event, see xtd::speech::synthesis::state_changed_event_args.

To pause and resume speech synthesis, use the xtd::speech::synthesis::speech_synthesizer::pause and xtd::speech::synthesis::speech_synthesizer::resume methods.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/speech/synthesis/speech_synthesizer.h