共用方式為

類別 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;

當合成正在進行時，事件會發出語音合成viseme事件的訊號。 已在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 格式指定語音的地區設定;或將它保留空白，以取得所有可用的語音。

傳回

表示語音清單的異步操作。 它會傳回 Result 為 SynthesisVoicesResult 的值。

SetAuthorizationToken

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

設定將用於連線至服務的授權令牌。 注意：呼叫端必須確定授權令牌有效。 授權令牌到期之前，呼叫端必須使用新的有效令牌呼叫這個 setter 來重新整理它。 否則，合成器會在語音合成時遇到錯誤。 已在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 音訊組態。

傳回

智慧型指標包裝語音合成器指標。