SpeechConfig class

패키지:

microsoft-cognitiveservices-speech-sdk

음성 구성.

속성

authorizationToken	권한 부여 토큰을 가져옵니다.
endpointId	음성 인식에 사용되는 사용자 지정된 음성 모델의 엔드포인트 ID를 가져옵니다.
outputFormat	음성 인식 출력 형식(단순 또는 상세)을 가져옵니다. 참고: 이 출력 형식은 음성 인식 결과를 위한 것입니다. [SpeechConfig.speechSynthesisOutputFormat]을 사용하여 합성된 오디오 출력 형식을 가져옵니다.
region
speechRecognitionLanguage	구성된 언어를 반환합니다.
speechSynthesisLanguage	음성 신시사이저의 언어를 가져옵니다. 버전 1.11.0에 추가되었습니다.
speechSynthesisOutputFormat	음성 합성 출력 형식을 가져옵니다. 버전 1.11.0에 추가되었습니다.
speechSynthesisVoiceName	음성 신시사이저의 음성을 가져옵니다. 버전 1.11.0에 추가되었습니다.
subscriptionKey

메서드

close()	구성을 닫습니다.
enableAudioLogging()	서비스에서 오디오 로깅을 사용하도록 설정합니다. 오디오 및 콘텐츠 로그는 Microsoft 소유 스토리지 또는 Cognitive Services 구독에 연결된 사용자 고유의 스토리지 계정(BYOS(Bring Your Own Storage) 사용 음성 리소스)에 저장됩니다. 로그는 30일 후에 제거됩니다. 버전 1.7.0에 추가되었습니다.
enableDictation()	받아쓰기를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다. 버전 1.7.0에 추가되었습니다.
fromAuthorizationToken(string, string)	지정된 초기 권한 부여 토큰 및 지역을 사용하여 Speech Factory의 instance 만듭니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 참고: 의도 인식기를 사용하려는 경우 LanguageUnderstanding 구독 키에서 파생된 토큰을 사용하세요. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 만들어진 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.
fromEndpoint(URL, string)	지정된 엔드포인트 및 구독 키를 사용하여 음성 구성의 instance 만듭니다. 이 메서드는 비표준 서비스 엔드포인트 또는 매개 변수를 사용하는 사용자만을 위한 것입니다. 참고: 의도 인식기를 사용하려는 경우 LanguageUnderstanding 구독 키를 사용하세요. 참고: 엔드포인트 URL에 지정된 쿼리 매개 변수는 다른 API에 의해 설정되더라도 변경되지 않습니다. 예를 들어 언어가 uri에서 쿼리 매개 변수 "language=de-DE"로 정의되고 SpeechConfig.speechRecognitionLanguage = "en-US"로 설정된 경우 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)	subscriptionKey 및 서비스 지역을 전달하여 반환된 SpeechConfig의 정적 instance. 참고: 의도 인식기를 사용하려는 경우 LanguageUnderstanding 구독 키를 사용하세요.
getProperty(string, string)	임의 속성의 현재 값을 반환합니다.
requestWordLevelTimestamps()	단어 수준 타임스탬프를 포함합니다. 버전 1.7.0에 추가되었습니다.
setProfanity(ProfanityOption)	욕설 옵션을 설정합니다. 버전 1.7.0에 추가되었습니다.
setProperty(string | PropertyId, string)	임의의 속성을 설정합니다.
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

권한 부여 토큰을 가져옵니다.

string authorizationToken

속성 값

string

endpointId

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

string endpointId

속성 값

string

엔드포인트 ID

outputFormat

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

OutputFormat outputFormat

속성 값

OutputFormat

출력 형식을 반환합니다.

region

string region

속성 값

string

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

speechRecognitionLanguage

구성된 언어를 반환합니다.

string speechRecognitionLanguage

속성 값

string

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

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

메서드 세부 정보

close()

구성을 닫습니다.

function close()

enableAudioLogging()

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

function enableAudioLogging()

enableDictation()

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

function enableDictation()

fromAuthorizationToken(string, string)

지정된 초기 권한 부여 토큰 및 지역을 사용하여 Speech Factory의 instance 만듭니다. 참고: 호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 권한 부여 토큰이 만료되기 전에 호출자는 이 setter를 새 유효한 토큰으로 호출하여 새로 고쳐야 합니다. 참고: 의도 인식기를 사용하려는 경우 LanguageUnderstanding 구독 키에서 파생된 토큰을 사용하세요. 새 인식기를 만들 때 구성 값이 복사되므로 새 토큰 값은 이미 만들어진 인식자에 적용되지 않습니다. 이전에 만든 인식기의 경우 해당 인식기의 권한 부여 토큰을 설정하여 토큰을 새로 고쳐야 합니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.

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

매개 변수

authorizationToken

string

초기 권한 부여 토큰입니다.

region

string

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

반환

SpeechConfig

음성 팩터리 instance.

fromEndpoint(URL, string)

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

static function fromEndpoint(endpoint: URL, subscriptionKey?: string): SpeechConfig

매개 변수

endpoint

URL

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

subscriptionKey

string

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

반환

SpeechConfig

음성 팩터리 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)

subscriptionKey 및 서비스 지역을 전달하여 반환된 SpeechConfig의 정적 instance. 참고: 의도 인식기를 사용하려는 경우 LanguageUnderstanding 구독 키를 사용하세요.

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

매개 변수

subscriptionKey

string

구독 키입니다.

region

string

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

반환

SpeechConfig

음성 팩터리

getProperty(string, string)

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

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

매개 변수

name

string

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

def

string

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

반환

string

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

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

매개 변수

profanity

ProfanityOption

setProperty(string | PropertyId, string)

임의의 속성을 설정합니다.

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

매개 변수

name

string | PropertyId

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

value

string

속성의 새 값입니다.

setProxy(string, number)

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

function setProxy(proxyHostName: string, proxyPort: number)

매개 변수

proxyHostName

string

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

proxyPort

number

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

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

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

setServiceProperty(string, string, UriQueryParameter)

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

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

매개 변수

name

string

value

string

channel

UriQueryParameter