SpeechTranslationConfig class

패키지:

microsoft-cognitiveservices-speech-sdk

음성 번역 구성.

Extends

SpeechConfig

속성

authorizationToken	권한 부여 토큰을 가져오/설정합니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다.
endpointId	음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID를 가져옵니다.
outputFormat	음성 인식 출력 형식(단순 또는 상세)을 가져옵니다. 참고: 이 출력 형식은 음성 인식 결과를 위한 것입니다. [SpeechConfig.speechSynthesisOutputFormat]을 사용하여 합성된 오디오 출력 형식을 가져옵니다.
region
speechRecognitionLanguage	음성 인식 언어를 가져오고 설정합니다.
speechSynthesisLanguage	음성 신시사이저의 언어를 가져옵니다. 버전 1.11.0에 추가되었습니다.
speechSynthesisOutputFormat	음성 합성 출력 형식을 가져옵니다. 버전 1.11.0에 추가되었습니다.
speechSynthesisVoiceName	음성 신시사이저의 음성을 가져옵니다. 버전 1.11.0에 추가되었습니다.
subscriptionKey
targetLanguages	번역할 (텍스트) 대상 언어를 가져옵니다.
voiceName	선택한 음성 이름을 가져옵니다.

메서드

addTargetLanguage(string)	번역할 (텍스트) 대상 언어를 추가합니다.
close()	연결된 리소스를 삭제합니다.
fromAuthorizationToken(string, string)	권한 부여 토큰 및 서비스 지역을 전달하여 반환된 SpeechTranslationConfig의 정적 instance. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 속성 authorizationToken을 새 유효한 토큰으로 설정하여 새로 고쳐야 합니다. 그렇지 않으면 이 SpeechTranslationConfig instance 만든 모든 인식기에 인식 중에 오류가 발생합니다. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 생성된 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.
fromEndpoint(URL, string)	지정된 엔드포인트 및 구독 키를 사용하여 음성 번역 구성의 instance 만듭니다. 이 메서드는 비표준 서비스 엔드포인트 또는 매개 변수를 사용하는 사용자만을 위한 것입니다. 참고: 엔드포인트 URL에 지정된 쿼리 속성은 다른 API에 의해 설정되더라도 변경되지 않습니다. 예를 들어 언어가 쿼리 매개 변수 "language=de-DE"로 URI에 정의되고 speechRecognitionLanguage 속성으로도 설정된 경우 uri의 언어 설정이 우선하며 유효 언어는 "de-DE"입니다. 엔드포인트 URL에 지정되지 않은 속성만 다른 API에서 설정할 수 있습니다. 참고: fromEndpoint에서 권한 부여 토큰을 사용하려면 fromEndpoint 메서드의 subscriptionKey에 빈 문자열을 전달한 다음, 만든 SpeechConfig instance authorizationToken="token"을 설정하여 권한 부여 토큰을 사용합니다.
fromHost(URL, string)	지정된 호스트 및 구독 키를 사용하여 음성 구성의 instance 만듭니다. 이 메서드는 기본이 아닌 서비스 호스트를 사용하는 사용자만을 위한 것입니다. 표준 리소스 경로가 가정됩니다. 표준이 아닌 리소스 경로 또는 경로가 전혀 없는 서비스의 경우 fromEndpoint를 대신 사용합니다. 참고: 쿼리 매개 변수는 호스트 URI에서 허용되지 않으며 다른 API에서 설정해야 합니다. 참고: fromHost에서 권한 부여 토큰을 사용하려면 fromHost(URL)를 사용한 다음, 만든 SpeechConfig instance AuthorizationToken 속성을 설정합니다. 참고: 버전 1.9.0에 추가되었습니다.
fromSubscription(string, string)	구독 키 및 서비스 지역을 전달하여 반환된 SpeechTranslationConfig의 정적 instance.
setProperty(string | PropertyId, string)	명명된 속성을 값으로 설정합니다.

상속된 메서드

enableAudioLogging()	서비스에서 오디오 로깅을 사용하도록 설정합니다. 오디오 및 콘텐츠 로그는 Microsoft 소유 스토리지 또는 Cognitive Services 구독에 연결된 사용자 고유의 스토리지 계정(BYOS(Bring Your Own Storage) 사용 음성 리소스)에 저장됩니다. 로그는 30일 후에 제거됩니다. 버전 1.7.0에 추가되었습니다.
enableDictation()	받아쓰기를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다. 버전 1.7.0에 추가되었습니다.
getProperty(string, string)	임의 속성의 현재 값을 반환합니다.
requestWordLevelTimestamps()	단어 수준 타임스탬프를 포함합니다. 버전 1.7.0에 추가되었습니다.
setProfanity(ProfanityOption)	욕설 옵션을 설정합니다. 버전 1.7.0에 추가되었습니다.
setProxy(string, number)	프록시 구성을 설정합니다. Node.js 환경에서만 관련됩니다. 버전 1.4.0에 추가되었습니다.
setProxy(string, number, string, string)	프록시 구성을 설정합니다. Node.js 환경에서만 관련됩니다. 버전 1.4.0에 추가되었습니다.
setServiceProperty(string, string, UriQueryParameter)	지정된 채널을 사용하여 서비스에 전달될 속성 값을 설정합니다. 버전 1.7.0에 추가되었습니다.

속성 세부 정보

authorizationToken

권한 부여 토큰을 가져오/설정합니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다.

void authorizationToken

속성 값

void

endpointId

음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID를 가져옵니다.

string endpointId

속성 값

string

엔드포인트 ID

outputFormat

음성 인식 출력 형식(단순 또는 상세)을 가져옵니다. 참고: 이 출력 형식은 음성 인식 결과를 위한 것입니다. [SpeechConfig.speechSynthesisOutputFormat]을 사용하여 합성된 오디오 출력 형식을 가져옵니다.

OutputFormat outputFormat

속성 값

OutputFormat

출력 형식을 반환합니다.

region

string region

속성 값

string

구성에 설정된 지역입니다.

speechRecognitionLanguage

음성 인식 언어를 가져오고 설정합니다.

void speechRecognitionLanguage

속성 값

void

speechSynthesisLanguage

음성 신시사이저의 언어를 가져옵니다. 버전 1.11.0에 추가되었습니다.

string speechSynthesisLanguage

속성 값

string

음성 합성 언어를 반환합니다.

speechSynthesisOutputFormat

음성 합성 출력 형식을 가져옵니다. 버전 1.11.0에 추가되었습니다.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

속성 값

SpeechSynthesisOutputFormat

음성 합성 출력 형식을 반환합니다.

speechSynthesisVoiceName

음성 신시사이저의 음성을 가져옵니다. 버전 1.11.0에 추가되었습니다.

string speechSynthesisVoiceName

속성 값

string

음성 합성 음성을 반환합니다.

subscriptionKey

string subscriptionKey

속성 값

string

구성에 설정된 구독 키입니다.

targetLanguages

번역할 (텍스트) 대상 언어를 가져옵니다.

string[] targetLanguages

속성 값

string[]

voiceName

선택한 음성 이름을 가져옵니다.

string voiceName

속성 값

string

음성 이름입니다.

메서드 세부 정보

addTargetLanguage(string)

번역할 (텍스트) 대상 언어를 추가합니다.

function addTargetLanguage(value: string)

매개 변수

value

string

de-DE와 같은 언어

close()

연결된 리소스를 삭제합니다.

function close()

fromAuthorizationToken(string, string)

권한 부여 토큰 및 서비스 지역을 전달하여 반환된 SpeechTranslationConfig의 정적 instance. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 속성 authorizationToken을 새 유효한 토큰으로 설정하여 새로 고쳐야 합니다. 그렇지 않으면 이 SpeechTranslationConfig instance 만든 모든 인식기에 인식 중에 오류가 발생합니다. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 생성된 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

매개 변수

authorizationToken

string

권한 부여 토큰입니다.

region

string

지역 이름( 지역 페이지 참조)입니다.

반환

SpeechTranslationConfig

음성 번역 구성입니다.

fromEndpoint(URL, string)

지정된 엔드포인트 및 구독 키를 사용하여 음성 번역 구성의 instance 만듭니다. 이 메서드는 비표준 서비스 엔드포인트 또는 매개 변수를 사용하는 사용자만을 위한 것입니다. 참고: 엔드포인트 URL에 지정된 쿼리 속성은 다른 API에 의해 설정되더라도 변경되지 않습니다. 예를 들어 언어가 쿼리 매개 변수 "language=de-DE"로 URI에 정의되고 speechRecognitionLanguage 속성으로도 설정된 경우 uri의 언어 설정이 우선하며 유효 언어는 "de-DE"입니다. 엔드포인트 URL에 지정되지 않은 속성만 다른 API에서 설정할 수 있습니다. 참고: fromEndpoint에서 권한 부여 토큰을 사용하려면 fromEndpoint 메서드의 subscriptionKey에 빈 문자열을 전달한 다음, 만든 SpeechConfig instance authorizationToken="token"을 설정하여 권한 부여 토큰을 사용합니다.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

매개 변수

endpoint

URL

연결할 서비스 엔드포인트입니다.

subscriptionKey

string

구독 키입니다.

반환

SpeechTranslationConfig

음성 구성 instance.

fromHost(URL, string)

지정된 호스트 및 구독 키를 사용하여 음성 구성의 instance 만듭니다. 이 메서드는 기본이 아닌 서비스 호스트를 사용하는 사용자만을 위한 것입니다. 표준 리소스 경로가 가정됩니다. 표준이 아닌 리소스 경로 또는 경로가 전혀 없는 서비스의 경우 fromEndpoint를 대신 사용합니다. 참고: 쿼리 매개 변수는 호스트 URI에서 허용되지 않으며 다른 API에서 설정해야 합니다. 참고: fromHost에서 권한 부여 토큰을 사용하려면 fromHost(URL)를 사용한 다음, 만든 SpeechConfig instance AuthorizationToken 속성을 설정합니다. 참고: 버전 1.9.0에 추가되었습니다.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

매개 변수

hostName

URL

subscriptionKey

string

구독 키입니다. 구독 키를 지정하지 않으면 권한 부여 토큰을 설정해야 합니다.

반환

SpeechConfig

음성 팩터리 instance.

fromSubscription(string, string)

구독 키 및 서비스 지역을 전달하여 반환된 SpeechTranslationConfig의 정적 instance.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

매개 변수

subscriptionKey

string

구독 키입니다.

region

string

지역 이름( 지역 페이지 참조)입니다.

반환

SpeechTranslationConfig

음성 번역 구성입니다.

setProperty(string | PropertyId, string)

명명된 속성을 값으로 설정합니다.

function setProperty(name: string | PropertyId, value: string)

매개 변수

name

string | PropertyId

설정할 속성의 이름입니다.

value

string

속성의 새 값입니다.

상속된 메서드 세부 정보

enableAudioLogging()

서비스에서 오디오 로깅을 사용하도록 설정합니다. 오디오 및 콘텐츠 로그는 Microsoft 소유 스토리지 또는 Cognitive Services 구독에 연결된 사용자 고유의 스토리지 계정(BYOS(Bring Your Own Storage) 사용 음성 리소스)에 저장됩니다. 로그는 30일 후에 제거됩니다. 버전 1.7.0에 추가되었습니다.

function enableAudioLogging()

SpeechConfig.enableAudioLogging에서 상속됨

enableDictation()

받아쓰기를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다. 버전 1.7.0에 추가되었습니다.

function enableDictation()

SpeechConfig.enableDictation에서 상속됨

getProperty(string, string)

임의 속성의 현재 값을 반환합니다.

function getProperty(name: string, def?: string): string

매개 변수

name

string

쿼리할 속성의 이름입니다.

def

string

속성을 알 수 없는 경우 반환할 값입니다.

반환

string

지정된 속성의 현재 값 또는 제공된 기본값입니다.

SpeechConfig.getProperty에서 상속됨

requestWordLevelTimestamps()

단어 수준 타임스탬프를 포함합니다. 버전 1.7.0에 추가되었습니다.

function requestWordLevelTimestamps()

SpeechConfig.requestWordLevelTimestamps에서 상속됨

setProfanity(ProfanityOption)

욕설 옵션을 설정합니다. 버전 1.7.0에 추가되었습니다.

function setProfanity(profanity: ProfanityOption)

매개 변수

profanity

ProfanityOption

SpeechConfig.setProfanity에서 상속됨

setProxy(string, number)

프록시 구성을 설정합니다. Node.js 환경에서만 관련됩니다. 버전 1.4.0에 추가되었습니다.

function setProxy(proxyHostName: string, proxyPort: number)

매개 변수

proxyHostName

string

프록시 서버의 호스트 이름입니다.

proxyPort

number

프록시 서버의 포트 번호입니다.

SpeechConfig.setProxy에서 상속됨

setProxy(string, number, string, string)

프록시 구성을 설정합니다. Node.js 환경에서만 관련됩니다. 버전 1.4.0에 추가되었습니다.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

매개 변수

proxyHostName

string

프로토콜 구성표가 없는 프록시 서버의 호스트 이름(http://)

proxyPort

number

프록시 서버의 포트 번호입니다.

proxyUserName

string

프록시 서버의 사용자 이름입니다.

proxyPassword

string

프록시 서버의 암호입니다.

SpeechConfig.setProxy에서 상속됨

setServiceProperty(string, string, UriQueryParameter)

지정된 채널을 사용하여 서비스에 전달될 속성 값을 설정합니다. 버전 1.7.0에 추가되었습니다.

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

매개 변수

name

string

value

string

channel

UriQueryParameter

SpeechConfig.setServiceProperty에서 상속됨