class SpeechSynthesizer
: public std::enable_shared_from_this< SpeechSynthesizer >
음성 신시사이저에 대한 클래스입니다. 버전 1.14.0에서 업데이트되었습니다.
구성원
속성
구문: public PropertyCollection & Properties;
이 SpeechSynthesizer에 대해 정의된 속성 및 해당 값의 컬렉션입니다.
SynthesisStarted
구문: public EventSignal< const SpeechSynthesisEventArgs & > SynthesisStarted;
이 이벤트는 합성이 막 시작될 때 음성 합성 결과를 수신한다는 신호를 보냅니다.
합성
구문: public EventSignal< const SpeechSynthesisEventArgs & > Synthesizing;
이 이벤트는 합성이 진행되는 동안 음성 합성 결과를 수신한다는 신호를 보냅니다.
SynthesisCompleted
구문: public EventSignal< const SpeechSynthesisEventArgs & > SynthesisCompleted;
이 이벤트는 합성이 완료될 때 음성 합성 결과를 수신한다는 신호를 보냅니다.
SynthesisCanceled
구문: public EventSignal< const SpeechSynthesisEventArgs & > SynthesisCanceled;
이 이벤트는 합성이 취소될 때 음성 합성 결과를 수신한다는 신호를 보냅니다.
WordBoundary
구문: public EventSignal< const SpeechSynthesisWordBoundaryEventArgs & > WordBoundary;
이 이벤트는 합성이 진행되는 동안 음성 합성 단어 경계를 수신한다는 신호를 보냅니다. 버전 1.7.0에 추가되었습니다.
VisemeReceived
구문: public EventSignal< const SpeechSynthesisVisemeEventArgs & > VisemeReceived;
이 이벤트는 합성이 진행되는 동안 음성 합성 viseme 이벤트를 수신한다는 신호를 보냅니다. 버전 1.16.0에 추가되었습니다.
BookmarkReached
구문: public EventSignal< const SpeechSynthesisBookmarkEventArgs & > 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입니다.
반품
음성 합성 결과를 래핑하는 스마트 포인터입니다.
말하다
구문: public inline std::shared_ptr< SpeechSynthesisResult > Speak ( const std::shared_ptr< SpeechSynthesisRequest > & request );
요청에 따라 동기적으로 음성 합성을 실행합니다. 이 API를 사용하여 입력 텍스트 스트림의 음성을 합성하여 텍스트 생성 시나리오의 대기 시간을 줄일 수 있습니다. 참고: 이 기능은 미리 보기 상태이며 변경될 수 있습니다. 버전 1.37.0에 추가되었습니다.
매개 변수
-
request
합성 요청입니다.
반품
음성 합성 결과를 래핑하는 스마트 포인터입니다.
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 값을 반환합니다.
SpeakAsync
구문: public inline std::future< std::shared_ptr< SpeechSynthesisResult > > SpeakAsync ( const std::shared_ptr< SpeechSynthesisRequest > & request );
요청에 따라 동기적으로 음성 합성을 실행합니다. 이 API를 사용하여 입력 텍스트 스트림의 음성을 합성하여 텍스트 생성 시나리오의 대기 시간을 줄일 수 있습니다. 참고: 이 기능은 미리 보기 상태이며 변경될 수 있습니다. 버전 1.37.0에 추가되었습니다.
매개 변수
-
request
합성 요청입니다.
반품
합성을 나타내는 비동기 작업입니다. 결과적으로 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입니다.
반품
음성 합성 결과를 래핑하는 스마트 포인터입니다.
StartSpeaking
구문: public inline std::shared_ptr< SpeechSynthesisResult > StartSpeaking ( const std::shared_ptr< SpeechSynthesisRequest > & request );
요청에 따라 동기적으로 음성 합성을 시작합니다. 이 API를 사용하여 입력 텍스트 스트림의 음성을 합성하여 텍스트 생성 시나리오의 대기 시간을 줄일 수 있습니다. 참고: 이 기능은 미리 보기 상태이며 변경될 수 있습니다. 버전 1.37.0에 추가되었습니다.
매개 변수
-
request
합성 요청입니다.
반품
음성 합성 결과를 래핑하는 스마트 포인터입니다.
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
Speech 구성입니다.
반품
스마트 포인터 래핑된 음성 신시사이저 포인터입니다.
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
Speech 구성입니다.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
Speech 구성입니다.autoDetectSourceLangConfig
자동 검색 원본 언어 구성입니다.audioconfig
오디오 구성입니다.
반품
스마트 포인터 래핑된 음성 신시사이저 포인터입니다.