你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

SpeechTranslationConfig 类

定义使用语音输入进行翻译配置的类。

可以通过不同的方式初始化配置:

  • 从订阅:传递订阅密钥和区域

  • 从终结点:传递订阅密钥和终结点

  • 从主机:传递订阅密钥和主机地址

  • 从授权令牌:传递授权令牌和区域

继承
SpeechTranslationConfig

构造函数

SpeechTranslationConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, target_languages: Iterable[str] = None, voice_name: str = '', speech_recognition_language: str = '')

参数

名称 说明
subscription

订阅密钥。

默认值: None
region

区域名称 (请参阅 区域页面) 。

默认值: None
endpoint

要连接到的服务终结点。

默认值: None
host

要连接到的服务主机。 将假定使用标准资源路径。 格式为“protocol://host:port”,其中“:p ort”是可选的。

默认值: None
auth_token

授权令牌。

默认值: None
speech_recognition_language
必需

语音识别的输入语言。 语言以 BCP-47 格式指定。

target_languages

翻译的目标语言。

默认值: None
voice_name
必需

用于合成输出的语音。

方法

add_target_language

语言 添加到要翻译的目标语言列表中。

enable_audio_logging

在服务中启用音频日志记录。 音频和内容日志存储在 Microsoft 拥有的存储中,或存储在与认知服务订阅关联的自己的存储帐户中, (自带存储 (BYOS) 已启用语音资源) 。

注意

在版本 1.5.0 中添加。

enable_dictation

启用听写。 仅在语音连续识别中受支持。

注意

在版本 1.5.0 中添加。

get_property

按 ID 获取属性。

get_property_by_name

按名称获取属性。

remove_target_language

从要翻译的目标语言列表中删除语言。

注意

在版本 1.7.0 中添加。

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

设置语音合成输出音频格式。

add_target_language

语言 添加到要翻译的目标语言列表中。

add_target_language(language: str)

参数

名称 说明
language
必需

要添加的语言代码。

enable_audio_logging

在服务中启用音频日志记录。 音频和内容日志存储在 Microsoft 拥有的存储中,或存储在与认知服务订阅关联的自己的存储帐户中, (自带存储 (BYOS) 已启用语音资源) 。

注意

在版本 1.5.0 中添加。

enable_audio_logging()

enable_dictation

启用听写。 仅在语音连续识别中受支持。

注意

在版本 1.5.0 中添加。

enable_dictation()

get_property

按 ID 获取属性。

get_property(property_id: PropertyId) -> str

参数

名称 说明
property_id
必需

要检索的属性的 ID。

返回

类型 说明

该属性的值。

get_property_by_name

按名称获取属性。

get_property_by_name(property_name: str) -> str

参数

名称 说明
property_name
必需

要检索的属性的名称。

返回

类型 说明

该属性的值。

remove_target_language

从要翻译的目标语言列表中删除语言。

注意

在版本 1.7.0 中添加。

remove_target_language(language: str)

参数

名称 说明
language
必需

要删除的语言代码。

request_word_level_timestamps

在响应结果中包含单词级别时间戳。

注意

在版本 1.5.0 中添加。

request_word_level_timestamps()

set_profanity

设置不雅内容选项。

注意

在版本 1.5.0 中添加。

set_profanity(profanity_option: ProfanityOption) -> None

参数

名称 说明
profanity_option
必需

要设置的亵渎级别。

set_properties

按 ID 设置多个属性。

set_properties(properties: Dict[PropertyId, str])

参数

名称 说明
properties
必需

将属性 ID 映射到要设置的值的 dict。

set_properties_by_name

按名称设置多个属性。

set_properties_by_name(properties: Dict[str, str])

参数

名称 说明
properties
必需

将属性 ID 映射到要设置的值的 dict。

set_property

按 ID 设置属性。

set_property(property_id: PropertyId, value: str)

参数

名称 说明
property_id
必需

要设置的属性的 ID。

value
必需

要为 属性设置的值。

set_property_by_name

按名称设置属性。

set_property_by_name(property_name: str, value: str)

参数

名称 说明
property_name
必需

要设置的属性的名称。

value
必需

要为 属性设置的值。

set_proxy

设置代理信息。

注意

代理功能在 macOS 上不可用。 此函数对

此平台。

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

参数

名称 说明
hostname
必需

代理服务器的主机名。 不要将协议信息 (http) 添加到主机名。

port
必需

代理服务器的端口号。

username

代理服务器的用户名。

默认值: None
password

代理服务器的密码。

默认值: None

set_service_property

设置将使用指定通道传递给服务的属性值。

注意

在版本 1.5.0 中添加。

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

参数

名称 说明
name
必需

属性名称。

value
必需

属性值。

channel
必需

用于将指定属性传递给服务的通道。

set_speech_synthesis_output_format

设置语音合成输出音频格式。

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

参数

名称 说明
format_id
必需

音频格式 ID,例如 Riff16Khz16BitMonoPcm。

属性

authorization_token

将用于连接到服务的授权令牌。

注意

调用方需要确保授权令牌有效。 在

授权令牌过期,调用方需要通过调用此资源库来刷新它

新的有效令牌。 由于在创建新的识别器时会复制配置值,

新令牌值将不适用于已创建的识别器。 For

之前创建的识别器需要设置 的授权令牌

用于刷新令牌的相应识别器。 否则,识别器将遇到

识别过程中的错误。

endpoint_id

终结点 ID。

output_format

输出格式 (语音识别结果的简单或详细) 。

region

用于创建识别器的区域键。

speech_recognition_language

要以 BCP-47 格式识别的口语的名称。

speech_synthesis_language

获取语音合成语言。

speech_synthesis_output_format_string

获取语音合成输出音频格式字符串。

speech_synthesis_voice_name

获取语音合成语音名称。

subscription_key

用于创建识别器的订阅密钥。

target_languages

翻译的目标语言。

voice_name

用于合成输出的语音。