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
오디오 구성.
반환
스마트 포인터 래핑된 음성 신시사이저 포인터입니다.