类 SpeechSynthesizer

  • 项目 
class SpeechSynthesizer
  : public std::enable_shared_from_this< SpeechSynthesizer >

语音合成器类。 在版本 1.14.0 中更新。

成员

属性

语法： public PropertyCollection & Properties;

为此 SpeechSynthesizer 定义的属性及其值的集合。

SynthesisStarted

语法： public EventSignal< constSpeechSynthesisEventArgs & > SynthesisStarted;

事件指示在刚开始合成时收到语音合成结果。

合成

语法： public EventSignal< constSpeechSynthesisEventArgs & > Synthesizing;

事件指示在合成过程中收到语音合成结果。

SynthesisCompleted

语法： public EventSignal< constSpeechSynthesisEventArgs & > SynthesisCompleted;

事件指示在合成完成后收到语音合成结果。

SynthesisCanceled

语法： public EventSignal< constSpeechSynthesisEventArgs & > SynthesisCanceled;

事件指示在取消合成时收到语音合成结果。

WordBoundary

语法： public EventSignal< constSpeechSynthesisWordBoundaryEventArgs & > WordBoundary;

该事件指示在合成过程中收到语音合成词边界。 在版本 1.7.0 中添加。

VisemeReceived

语法： public EventSignal< constSpeechSynthesisVisemeEventArgs & > VisemeReceived;

该事件指示在合成过程中收到语音合成视素事件。 在版本 1.16.0 中添加。

BookmarkReached

语法： public EventSignal< constSpeechSynthesisBookmarkEventArgs & > BookmarkReached;

事件指示在合成正在进行时已到达语音合成书签。 在版本 1.16.0 中添加。

SpeakText

语法： public inline std::shared_ptr< SpeechSynthesisResult > SpeakText ( const std::string & text );

以同步方式对纯文本执行语音合成。

参数

  • text 用于合成的纯文本。

返回

包装语音合成结果的智能指针。

SpeakText

语法： public inline std::shared_ptr< SpeechSynthesisResult > SpeakText ( const std::wstring & text );

以同步方式对纯文本执行语音合成。 在 1.9.0 中添加。

参数

  • text 用于合成的纯文本。

返回

包装语音合成结果的智能指针。

SpeakSsml

语法： public inline std::shared_ptr< SpeechSynthesisResult > SpeakSsml ( const std::string & ssml );

在 SSML 上同步执行语音合成。

参数

  • ssml 用于合成的 SSML。

返回

包装语音合成结果的智能指针。

SpeakSsml

语法： public inline std::shared_ptr< SpeechSynthesisResult > SpeakSsml ( const std::wstring & ssml );

在 SSML 上同步执行语音合成。 在版本 1.9.0 中添加。

参数

  • ssml 用于合成的 SSML。

返回

包装语音合成结果的智能指针。

SpeakTextAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > SpeakTextAsync ( const std::string & text );

以异步方式对纯文本执行语音合成。

参数

  • text 用于合成的纯文本。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

SpeakTextAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > SpeakTextAsync ( const std::wstring & text );

以异步方式对纯文本执行语音合成。 在版本 1.9.0 中添加。

参数

  • text 用于合成的纯文本。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

SpeakSsmlAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > SpeakSsmlAsync ( const std::string & ssml );

在 SSML 上异步执行语音合成。

参数

  • ssml 用于合成的 SSML。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

SpeakSsmlAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > SpeakSsmlAsync ( const std::wstring & ssml );

在 SSML 上异步执行语音合成。 在版本 1.9.0 中添加。

参数

  • ssml 用于合成的 SSML。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

StartSpeakingText

语法： public inline std::shared_ptr< SpeechSynthesisResult > StartSpeakingText ( const std::string & text );

以同步方式启动纯文本语音合成。

参数

  • text 用于合成的纯文本。

返回

包装语音合成结果的智能指针。

StartSpeakingText

语法： public inline std::shared_ptr< SpeechSynthesisResult > StartSpeakingText ( const std::wstring & text );

同步启动纯文本语音合成。 在版本 1.9.0 中添加。

参数

  • text 用于合成的纯文本。

返回

包装语音合成结果的智能指针。

StartSpeakingSsml

语法： public inline std::shared_ptr< SpeechSynthesisResult > StartSpeakingSsml ( const std::string & ssml );

同步启动 SSML 上的语音合成。

参数

  • ssml 用于合成的 SSML。

返回

包装语音合成结果的智能指针。

StartSpeakingSsml

语法： public inline std::shared_ptr< SpeechSynthesisResult > StartSpeakingSsml ( const std::wstring & ssml );

同步启动 SSML 上的语音合成。 在版本 1.9.0 中添加。

参数

  • ssml 用于合成的 SSML。

返回

包装语音合成结果的智能指针。

StartSpeakingTextAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > StartSpeakingTextAsync ( const std::string & text );

异步启动纯文本语音合成。

参数

  • text 用于合成的纯文本。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

StartSpeakingTextAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > StartSpeakingTextAsync ( const std::wstring & text );

异步启动纯文本语音合成。 在版本 1.9.0 中添加。

参数

  • text 用于合成的纯文本。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

StartSpeakingSsmlAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > StartSpeakingSsmlAsync ( const std::string & ssml );

异步启动 SSML 上的语音合成。

参数

  • ssml 用于合成的 SSML。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

StartSpeakingSsmlAsync

语法： public inline std::future< std::shared_ptr< SpeechSynthesisResult > > StartSpeakingSsmlAsync ( const std::wstring & ssml );

异步启动 SSML 上的语音合成。 在版本 1.9.0 中添加。

参数

  • ssml 用于合成的 SSML。

返回

表示合成的异步操作。 它返回一个值 SpeechSynthesisResult 作为结果。

StopSpeakingAsync

语法： public inline std::future< void > StopSpeakingAsync ( );

异步停止语音合成。 在版本 1.14.0 中添加。

返回

一个空的未来。

GetVoicesAsync

语法： public inline std::future< std::shared_ptr< SynthesisVoicesResult > > GetVoicesAsync ( const std::string & locale );

异步获取可用语音。 在版本 1.16.0 中添加。

参数

  • locale 以 BCP-47 格式指定语音的区域设置;或将其留空以获取所有可用语音。

返回

表示语音列表的异步操作。 它返回一个值 SynthesisVoicesResult 作为结果。

SetAuthorizationToken

语法： public inline void SetAuthorizationToken ( const std::string & token );

设置将用于连接到服务的授权令牌。 注意：调用方需要确保授权令牌有效。 在授权令牌过期之前，调用方需要使用新的有效令牌调用此资源库来刷新它。 否则，合成器在语音合成时会遇到错误。 在版本 1.7.0 中添加。

参数

  • token 授权令牌。

GetAuthorizationToken

语法： public inline std::string GetAuthorizationToken ( ) const;

获取授权令牌。 在版本 1.7.0 中添加。

返回

授权令牌

~SpeechSynthesizer

语法： public inline ~SpeechSynthesizer ( );

析构函数。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< SpeechConfig > speechconfig , std::nullptr_t );

从语音配置创建语音合成器。

参数

  • speechconfig 语音配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechconfig , std::nullptr_t );

从嵌入式语音配置创建语音合成器。在版本 1.19.0 中添加。

参数

  • speechconfig 嵌入式语音配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< HybridSpeechConfig > speechconfig , std::nullptr_t );

从混合语音配置创建语音合成器。

参数

  • speechconfig 混合语音配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< SpeechConfig > speechconfig , std::shared_ptr< Audio::AudioConfig > audioconfig );

根据语音配置和音频配置创建语音合成器。

参数

  • speechconfig 语音配置。

  • audioconfig 音频配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechconfig , std::shared_ptr< Audio::AudioConfig > audioconfig );

从嵌入式语音配置和音频配置创建语音合成器。在版本 1.19.0 中添加。

参数

  • speechconfig 嵌入式语音配置。

  • audioconfig 音频配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< HybridSpeechConfig > speechconfig , std::shared_ptr< Audio::AudioConfig > audioconfig );

从混合语音配置和音频配置创建语音合成器。

参数

  • speechconfig 混合语音配置。

  • audioconfig 音频配置。

返回

智能指针包装语音合成器指针。

FromConfig

语法： public inline static std::shared_ptr< SpeechSynthesizer > FromConfig ( std::shared_ptr< SpeechConfig > speechconfig , std::shared_ptr< AutoDetectSourceLanguageConfig > autoDetectSourceLangConfig , std::shared_ptr< Audio::AudioConfig > audioconfig );

根据语音配置、自动检测源语言配置和 1.13.0 中添加的音频配置创建语音合成器。

参数

  • speechconfig 语音配置。

  • autoDetectSourceLangConfig 自动检测源语言配置。

  • audioconfig 音频配置。

返回

智能指针包装语音合成器指针。