클래스 SpeechConfig
음성/의도 인식 또는 음성 합성에 대한 구성을 정의하는 클래스입니다.
멤버
EmbeddedSpeechConfig
구문: public friend EmbeddedSpeechConfig;
HybridSpeechConfig
구문: public friend HybridSpeechConfig;
연산자 SPXSPEECHCONFIGHANDLE
구문: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;
내부 연산자는 기본 핸들 값을 가져오는 데 사용됩니다.
반환
핸들입니다.
SetSpeechRecognitionLanguage
구문: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );
입력 언어를 음성 인식기로 설정합니다.
매개 변수
langBCP-47 형식으로 인식할 음성 언어의 이름을 지정합니다.
GetSpeechRecognitionLanguage
구문: public inline std::string GetSpeechRecognitionLanguage ( ) const;
음성 인식에 대한 입력 언어를 가져옵니다. 언어는 BCP-47 형식으로 지정됩니다.
반환
음성 인식 언어입니다.
SetSpeechSynthesisLanguage
구문: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );
음성 신시사이저의 언어를 설정합니다. 버전 1.4.0에 추가되었습니다.
매개 변수
lang언어 이름을 지정합니다(예: en-US).
GetSpeechSynthesisLanguage
구문: public inline std::string GetSpeechSynthesisLanguage ( ) const;
음성 신시사이저의 언어를 가져옵니다. 버전 1.4.0에 추가되었습니다.
반환
음성 합성 언어입니다.
SetSpeechSynthesisVoiceName
구문: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );
음성 신시사이저의 음성을 설정합니다. 버전 1.4.0에 추가되었습니다.
매개 변수
voiceName음성의 이름을 지정합니다.
GetSpeechSynthesisVoiceName
구문: public inline std::string GetSpeechSynthesisVoiceName ( ) const;
음성 신시사이저의 음성을 가져옵니다. 버전 1.4.0에 추가되었습니다.
반환
음성 합성 음성 이름입니다.
SetSpeechSynthesisOutputFormat
구문: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );
음성 합성 출력 형식(예: Riff16Khz16BitMonoPcm)을 설정합니다. 버전 1.4.0에 추가되었습니다.
매개 변수
formatId출력 형식 ID를 지정합니다.
GetSpeechSynthesisOutputFormat
구문: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;
음성 합성 출력 형식을 가져옵니다. 버전 1.4.0에 추가되었습니다.
반환
음성 합성 출력 형식입니다.
SetEndpointId
구문: public inline void SetEndpointId ( const std::string & endpointId );
Custom Speech 또는 Custom Voice의 엔드포인트 ID를 설정합니다.
매개 변수
endpointId엔드포인트 ID입니다.
GetEndpointId
구문: public inline std::string GetEndpointId ( ) const;
Custom Speech 또는 Custom Voice의 엔드포인트 ID를 가져옵니다.
반환
엔드포인트 ID.
SetAuthorizationToken
구문: public inline void SetAuthorizationToken ( const std::string & token );
서비스에 연결할 권한 부여 토큰을 설정합니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 생성된 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.
매개 변수
token권한 부여 토큰입니다.
GetAuthorizationToken
구문: public inline std::string GetAuthorizationToken ( ) const;
서비스에 연결할 권한 부여 토큰을 가져옵니다.
반환
권한 부여 토큰입니다.
GetSubscriptionKey
구문: public inline std::string GetSubscriptionKey ( ) const;
Speech Recognizer 또는 Intent Recognizer 또는 Translation Recognizer 또는 Speech Synthesizer를 만드는 데 사용되는 구독 키를 가져옵니다.
반환
구독 키입니다.
GetRegion
구문: public inline std::string GetRegion ( ) const;
Speech Recognizer 또는 Intent Recognizer 또는 Translation Recognizer 또는 Speech Synthesizer를 만드는 데 사용되는 지역 키를 가져옵니다.
반환
지역.
GetOutputFormat
구문: public inline OutputFormat GetOutputFormat ( ) const;
음성 인식 출력 형식(단순 또는 상세)을 가져옵니다. 참고: 이 출력 형식은 음성 인식 결과를 위한 것이며, SpeechConfig::GetSpeechSynthesisOutputFormat 을 사용하여 합성된 오디오 출력 형식을 가져옵니다.
반환
음성 인식 출력 형식입니다.
SetOutputFormat
구문: public inline void SetOutputFormat ( OutputFormat format );
음성 인식 출력 형식(단순 또는 상세)을 설정합니다. 참고: 이 출력 형식은 음성 인식 결과를 위한 것입니다. SpeechConfig::SetSpeechSynthesisOutputFormat 을 사용하여 합성된 오디오 출력 형식을 설정합니다.
매개 변수
format음성 인식 출력 형식
SetProfanity
구문: public inline void SetProfanity ( ProfanityOption profanity );
욕설 옵션을 설정합니다. 버전 1.5.0에 추가되었습니다.
매개 변수
profanity욕설 옵션 값입니다.
EnableAudioLogging
구문: public inline void EnableAudioLogging ( );
서비스에서 오디오 로깅을 사용하도록 설정합니다. 버전 1.5.0에 추가되었습니다.
오디오 및 콘텐츠 로그는 Microsoft 소유 스토리지 또는 Cognitive Services 구독에 연결된 사용자 고유의 스토리지 계정(BYOS(Bring Your Own Storage) 사용 음성 리소스)에 저장됩니다.
RequestWordLevelTimestamps
구문: public inline void RequestWordLevelTimestamps ( );
응답 결과에 단어 수준 타임스탬프를 포함합니다. 버전 1.5.0에 추가되었습니다.
EnableDictation
구문: public inline void EnableDictation ( );
받아쓰기 모드를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다. 버전 1.5.0에 추가되었습니다.
SetProxy
구문: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );
버전 1.1.0에서 프록시 구성 추가를 설정합니다.
참고: 프록시 기능은 macOS에서 사용할 수 없습니다. 이 함수는 이 플랫폼에 영향을 주지 않습니다.
매개 변수
proxyHostName프로토콜 구성표가 없는 프록시 서버의 호스트 이름([http://](http://))proxyPort프록시 서버의 포트 번호proxyUserName프록시 서버의 사용자 이름proxyPassword프록시 서버의 암호
SetProperty
구문: public inline void SetProperty ( const std::string & name , const std::string & value );
속성 값을 이름으로 설정합니다.
매개 변수
name속성 이름입니다.value속성 값입니다.
GetProperty
구문: public inline std::string GetProperty ( const std::string & name ) const;
이름으로 속성 값을 가져옵니다.
매개 변수
name매개 변수 이름입니다.
반환
속성 값입니다.
GetProperty
구문: public inline std::string GetProperty ( PropertyId id ) const;
ID별로 속성 값을 가져옵니다.
매개 변수
id매개 변수 ID입니다.
반환
속성 값입니다.
SetProperty
구문: public inline void SetProperty ( PropertyId id , const std::string & value );
ID별로 속성 값을 설정합니다.
매개 변수
id속성 ID입니다.value속성 값입니다.
SetServiceProperty
구문: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );
지정된 채널을 사용하여 서비스에 전달될 속성 값을 설정합니다. 버전 1.5.0에 추가되었습니다.
매개 변수
name속성 이름입니다.value속성 값입니다.channel지정된 속성을 서비스에 전달하는 데 사용되는 채널입니다.
~SpeechConfig
구문: public inline virtual ~SpeechConfig ( );
개체를 소멸합니다.
FromSubscription
구문: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );
지정된 구독 키 및 지역을 사용하여 음성 구성의 instance 만듭니다.
매개 변수
subscription구독 키입니다.region지역 이름( 지역 페이지 참조)입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.
FromAuthorizationToken
구문: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );
지정된 권한 부여 토큰 및 지역을 사용하여 음성 구성의 instance 만듭니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 만들어진 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.
매개 변수
authToken권한 부여 토큰입니다.region지역 이름( 지역 페이지 참조)입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.
FromEndpoint
구문: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );
지정된 엔드포인트 및 구독을 사용하여 음성 구성의 instance 만듭니다. 이 메서드는 비표준 서비스 엔드포인트를 사용하는 사용자만을 위한 것입니다. 참고: 엔드포인트 URI에 지정된 쿼리 매개 변수는 다른 API에 의해 설정된 경우에도 변경되지 않습니다. 예를 들어 인식 언어가 URI에서 쿼리 매개 변수 "language=de-DE"로 정의되고 SetSpeechRecognitionLanguage("en-US")로 설정된 경우 URI의 언어 설정이 우선하며 유효 언어는 "de-DE"입니다. 엔드포인트 URI에 지정되지 않은 매개 변수만 다른 API에서 설정할 수 있습니다. 참고: FromEndpoint에서 권한 부여 토큰을 사용하려면 FromEndpoint(const SPXSTRING&)를 사용한 다음, 만든 SpeechConfig instance SetAuthorizationToken()을 호출합니다.
매개 변수
endpoint연결할 서비스 엔드포인트입니다.subscription구독 키입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.
FromEndpoint
구문: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );
지정된 엔드포인트를 사용하여 SpeechConfig의 instance 만듭니다. 이 메서드는 비표준 서비스 엔드포인트를 사용하는 사용자만을 위한 것입니다. 참고: 엔드포인트 URI에 지정된 쿼리 매개 변수는 다른 API에 의해 설정된 경우에도 변경되지 않습니다. 특정 쿼리 매개 변수가 지원되는지 여부는 엔드포인트 및 시나리오에 따라 달라집니다. 예를 들어 인식 언어가 URI에서 쿼리 매개 변수 "language=de-DE"로 정의되고 SetSpeechRecognitionLanguage("en-US")로 설정된 경우 URI의 언어 설정이 우선하며 유효 언어는 "de-DE"입니다. 이 예제는 엔드포인트와 시나리오 조합이 언어를 쿼리 매개 변수로 지원하는 경우에만 적용됩니다. 엔드포인트 URI에 지정되지 않은 매개 변수만 다른 API에서 설정할 수 있습니다. 참고: 엔드포인트에 인증을 위해 구독 키가 필요한 경우 FromEndpoint(const SPXSTRING&, const SPXSTRING&)를 사용하여 구독 키를 매개 변수로 전달합니다. FromEndpoint에서 권한 부여 토큰을 사용하려면 이 메서드를 사용하여 SpeechConfig instance 만든 SpeechConfig instance SetAuthorizationToken()을 호출합니다. 참고: 버전 1.5.0에 추가되었습니다.
매개 변수
endpoint연결할 서비스 엔드포인트 URI입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.
FromHost
구문: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );
지정된 호스트 및 구독을 사용하여 음성 구성의 instance 만듭니다. 이 메서드는 기본이 아닌 서비스 호스트를 사용하는 사용자만을 위한 것입니다. 표준 리소스 경로가 가정됩니다. 표준이 아닌 리소스 경로 또는 경로가 전혀 없는 서비스의 경우 대신 FromEndpoint를 사용합니다. 참고: 쿼리 매개 변수는 호스트 URI에서 허용되지 않으며 다른 API에서 설정해야 합니다. 참고: FromHost에서 권한 부여 토큰을 사용하려면 FromHost(const SPXSTRING&)를 사용한 다음, 만든 SpeechConfig instance SetAuthorizationToken()을 호출합니다. 참고: 버전 1.8.0에 추가되었습니다.
매개 변수
host연결할 서비스 호스트입니다. 형식은 "protocol://host:port"입니다. 여기서 ":p ort"는 선택 사항입니다.subscription구독 키입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.
FromHost
구문: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );
지정된 호스트를 사용하여 SpeechConfig의 instance 만듭니다. 이 메서드는 기본이 아닌 서비스 호스트를 사용하는 사용자만을 위한 것입니다. 표준 리소스 경로가 가정됩니다. 표준이 아닌 리소스 경로 또는 경로가 전혀 없는 서비스의 경우 대신 FromEndpoint를 사용합니다. 참고: 쿼리 매개 변수는 호스트 URI에서 허용되지 않으며 다른 API에서 설정해야 합니다. 참고: 호스트에 인증을 위해 구독 키가 필요한 경우 FromHost(const SPXSTRING&, const SPXSTRING&)를 사용하여 구독 키를 매개 변수로 전달합니다. FromHost에서 권한 부여 토큰을 사용하려면 이 메서드를 사용하여 SpeechConfig instance 만든 SpeechConfig instance SetAuthorizationToken()을 호출합니다. 참고: 버전 1.8.0에 추가되었습니다.
매개 변수
host연결할 서비스 호스트 URI입니다. 형식은 "protocol://host:port"입니다. 여기서 ":p ort"는 선택 사항입니다.
반환
새 음성 구성 instance 대한 공유 포인터입니다.