다음을 통해 공유


class 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 형식으로 지정합니다. 또는 사용 가능한 모든 음성을 얻으려면 비워 둡니다.

반환

음성 목록을 나타내는 비동기 작업입니다. 결과적으로 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 오디오 구성.

반환

스마트 포인터 래핑된 음성 신시사이저 포인터입니다.