다음을 통해 공유


클래스 SpeechSynthesizer

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 오디오 구성입니다.

반품

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