다음을 통해 공유


SpeechConfig 클래스

음성/의도 인식 및 음성 합성에 대한 구성을 정의하는 클래스입니다.

구성은 다음과 같은 다양한 방법으로 초기화할 수 있습니다.

  • 구독에서: 구독 키 및 지역 전달

  • 엔드포인트에서: 엔드포인트를 전달합니다. 구독 키 또는 권한 부여 토큰은 선택 사항입니다.

  • 호스트에서: 호스트 주소를 전달합니다. 구독 키 또는 권한 부여 토큰은 선택 사항입니다.

  • 권한 부여 토큰에서: 권한 부여 토큰 및 지역 전달

상속
builtins.object
SpeechConfig

생성자

SpeechConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, speech_recognition_language: str | None = None)

매개 변수

Name Description
subscription

구독 키입니다.

기본값: None
region

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

기본값: None
endpoint

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

기본값: None
host

연결할 서비스 호스트입니다. 표준 리소스 경로가 가정됩니다. 형식은 "protocol://host:port"입니다. 여기서 ":p ort"는 선택 사항입니다.

기본값: None
auth_token

권한 부여 토큰입니다.

기본값: None
speech_recognition_language

음성 인식에 대한 입력 언어입니다. 언어는 BCP-47 형식으로 지정됩니다.

기본값: None

메서드

enable_audio_logging

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

참고

버전 1.5.0에 추가되었습니다.

enable_dictation

받아쓰기를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다.

참고

버전 1.5.0에 추가되었습니다.

get_property

ID로 속성을 가져옵니다.

get_property_by_name

이름으로 속성을 가져옵니다.

request_word_level_timestamps

응답 결과에 단어 수준 타임스탬프를 포함합니다.

참고

버전 1.5.0에 추가되었습니다.

set_profanity

욕설 옵션을 설정합니다.

참고

버전 1.5.0에 추가되었습니다.

set_properties

ID별로 여러 속성을 설정합니다.

set_properties_by_name

이름으로 여러 속성을 설정합니다.

set_property

id로 속성을 설정합니다.

set_property_by_name

이름으로 속성을 설정합니다.

set_proxy

프록시 정보를 설정합니다.

참고

프록시 기능은 macOS에서 사용할 수 없습니다. 이 함수는 영향을 주지 않습니다.

이 플랫폼.

set_service_property

지정된 채널을 사용하여 서비스에 전달될 속성 값을 설정합니다.

참고

버전 1.5.0에 추가되었습니다.

set_speech_synthesis_output_format

음성 합성 출력 오디오 형식을 설정합니다.

enable_audio_logging

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

참고

버전 1.5.0에 추가되었습니다.

enable_audio_logging()

enable_dictation

받아쓰기를 사용하도록 설정합니다. 음성 연속 인식에서만 지원됩니다.

참고

버전 1.5.0에 추가되었습니다.

enable_dictation()

get_property

ID로 속성을 가져옵니다.

get_property(property_id: PropertyId) -> str

매개 변수

Name Description
property_id
필수

검색할 속성의 ID입니다.

반환

형식 Description

속성 값입니다.

get_property_by_name

이름으로 속성을 가져옵니다.

get_property_by_name(property_name: str) -> str

매개 변수

Name Description
property_name
필수

검색할 속성의 이름입니다.

반환

형식 Description

속성 값입니다.

request_word_level_timestamps

응답 결과에 단어 수준 타임스탬프를 포함합니다.

참고

버전 1.5.0에 추가되었습니다.

request_word_level_timestamps()

set_profanity

욕설 옵션을 설정합니다.

참고

버전 1.5.0에 추가되었습니다.

set_profanity(profanity_option: ProfanityOption) -> None

매개 변수

Name Description
profanity_option
필수

설정할 욕설 수준입니다.

set_properties

ID별로 여러 속성을 설정합니다.

set_properties(properties: Dict[PropertyId, str])

매개 변수

Name Description
properties
필수

설정할 값에 대한 dict 매핑 속성 ID입니다.

set_properties_by_name

이름으로 여러 속성을 설정합니다.

set_properties_by_name(properties: Dict[str, str])

매개 변수

Name Description
properties
필수

설정할 값에 대한 dict 매핑 속성 ID입니다.

set_property

id로 속성을 설정합니다.

set_property(property_id: PropertyId, value: str)

매개 변수

Name Description
property_id
필수

설정할 속성의 ID입니다.

value
필수

속성에 설정할 값입니다.

set_property_by_name

이름으로 속성을 설정합니다.

set_property_by_name(property_name: str, value: str)

매개 변수

Name Description
property_name
필수

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

value
필수

속성에 설정할 값입니다.

set_proxy

프록시 정보를 설정합니다.

참고

프록시 기능은 macOS에서 사용할 수 없습니다. 이 함수는 영향을 주지 않습니다.

이 플랫폼.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

매개 변수

Name Description
hostname
필수

프록시 서버의 호스트 이름입니다. 호스트 이름에 프로토콜 정보(http)를 추가하지 마세요.

port
필수

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

username

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

기본값: None
password

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

기본값: None

set_service_property

지정된 채널을 사용하여 서비스에 전달될 속성 값을 설정합니다.

참고

버전 1.5.0에 추가되었습니다.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

매개 변수

Name Description
name
필수

속성 이름입니다.

value
필수

속성 값입니다.

channel
필수

지정된 속성을 서비스에 전달하는 데 사용되는 채널입니다.

set_speech_synthesis_output_format

음성 합성 출력 오디오 형식을 설정합니다.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

매개 변수

Name Description
format_id
필수

오디오 형식 ID(예: Riff16Khz16BitMonoPcm)입니다.

특성

authorization_token

서비스에 연결하는 데 사용할 권한 부여 토큰입니다.

참고

호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 이전의

권한 부여 토큰이 만료되면 호출자는 이 setter를 로 호출하여 새로 고쳐야 합니다.

새 유효한 토큰입니다. 새 인식기를 만들 때 구성 값이 복사되면

새 토큰 값은 이미 생성된 인식자에는 적용되지 않습니다. For

이전에 만든 인식기는 의 권한 부여 토큰을 설정해야 합니다.

해당 인식기를 사용하여 토큰을 새로 고칩니다. 그렇지 않으면 인식기가 발생합니다.

인식 중에 오류가 발생했습니다.

endpoint_id

엔드포인트 ID입니다.

output_format

음성 인식 결과의 출력 형식(단순 또는 상세)입니다.

region

Recognizer를 만드는 데 사용된 지역 키입니다.

speech_recognition_language

BCP-47 형식으로 인식할 음성 언어의 이름입니다.

speech_synthesis_language

음성 합성 언어를 가져옵니다.

speech_synthesis_output_format_string

음성 합성 출력 오디오 형식 문자열을 가져옵니다.

speech_synthesis_voice_name

음성 합성 음성 이름을 가져옵니다.

subscription_key

Recognizer를 만드는 데 사용된 구독 키입니다.