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

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)

参数

名称	说明
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 拥有的存储中，或存储在与认知服务订阅关联的自己的存储帐户中， (自带存储 (BYOS) 已启用语音资源) 。 注意 在版本 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 拥有的存储中，或存储在与认知服务订阅关联的自己的存储帐户中， (自带存储 (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 必需	要检索的属性的名称。

返回

类型	说明
	该属性的值。

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

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