你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
SpeechConfig 类
- java.
lang. Object - com.
microsoft. cognitiveservices. speech. SpeechConfig
- com.
实现
public class SpeechConfig
implements java.lang.AutoCloseable
语音配置。 注意：必须调用 close () 才能释放对象持有的基础资源。 在版本 1.7.0 中更改
字段摘要
| 修饰符和类型 | 字段和描述 |
|---|---|
| static java.lang.Class<?> |
speechConfigClass
用于加载本机库的访问器。 |
构造函数摘要
| 修饰符 | 构造函数 | 说明 |
|---|---|---|
| protected | SpeechConfig(long handleValue) |
语音配置对象的内部构造函数。 |
方法摘要
方法继承自 java.lang.Object
字段详细信息
speechConfigClass
public static Class speechConfigClass
用于加载本机库的访问器。 使类保持活动状态，以便类 GC 不会 (和局部变量回收它！)
构造函数详细信息
SpeechConfig
protected SpeechConfig(long handleValue)
语音配置对象的内部构造函数。
Parameters:
方法详细信息
close
public void close()
释放关联的资源。
enableAudioLogging
public void enableAudioLogging()
在服务中启用音频日志记录。 音频和内容日志存储在 Microsoft 拥有的存储中，或存储在与认知服务订阅关联的自己的存储帐户中， (自带存储 (BYOS) 已启用语音资源) 。 在版本 1.5.0 中添加。
enableDictation
public void enableDictation()
启用听写。 仅在语音连续识别中受支持。 在版本 1.5.0 中添加。
fromAuthorizationToken
public static SpeechConfig fromAuthorizationToken(String authorizationToken, String region)
使用指定的授权令牌和服务区域创建语音配置的实例。 注意：调用方需要确保授权令牌有效。 在授权令牌过期之前，调用方需要使用新的有效令牌调用此资源库来刷新它。 由于在创建新的识别器时会复制配置值，因此新令牌值将不适用于已创建的识别器。 对于以前创建的识别器，需要设置相应识别器的授权令牌才能刷新令牌。 否则，识别器将在识别过程中遇到错误。
Parameters:
Returns:
fromEndpoint
public static SpeechConfig fromEndpoint(URI endpoint)
使用指定的终结点创建语音配置的实例。 此方法仅适用于使用非标准服务终结点或参数的用户。 注意：终结点 URI 中指定的查询参数不会更改，即使它们是由任何其他 API 设置的。 例如，如果在 URI 中将识别语言定义为查询参数“language=de-DE”，并且还由 setSpeechRecognitionLanguage (“en-US”) 设置，则 URI 中的语言设置优先，有效语言为“de-DE”。 其他 API 只能设置终结点 URI 中未指定的参数。 注意：如果终结点需要订阅密钥进行身份验证，请使用 fromEndpoint (java.net.URI，String) 将订阅密钥作为参数传递。 若要将授权令牌与 fromEndpoint 配合使用，请使用此方法创建 SpeechConfig 实例，然后在创建的 SpeechConfig 实例上调用 setAuthorizationToken () 。 注意：在版本 1.5.0 中添加。
Parameters:
Returns:
fromEndpoint
public static SpeechConfig fromEndpoint(URI endpoint, String subscriptionKey)
使用指定的终结点和订阅密钥创建语音配置的实例。 此方法仅适用于使用非标准服务终结点或参数的用户。 注意：终结点 URI 中指定的查询参数不会更改，即使它们是由任何其他 API 设置的。 例如，如果在 URI 中将识别语言定义为查询参数“language=de-DE”，并且还由 setSpeechRecognitionLanguage (“en-US”) 设置，则 URI 中的语言设置优先，有效语言为“de-DE”。 其他 API 只能设置终结点 URI 中未指定的参数。 注意：若要将授权令牌与 fromEndpoint 一起使用，请使用 fromEndpoint (java.net.URI) ，然后在创建的 SpeechConfig 实例上调用 setAuthorizationToken () 。
Parameters:
Returns:
fromHost
public static SpeechConfig fromHost(URI host)
使用指定的主机创建语音配置的实例。 此方法仅适用于使用非默认服务主机的用户。 将假定使用标准资源路径。 对于具有非标准资源路径或根本没有路径的服务，请改用 fromEndpoint。 注意：主机 URI 中不允许使用查询参数，必须由其他 API 设置。 注意：如果主机需要订阅密钥进行身份验证，请使用 fromHost (java.net.URI、String) 将订阅密钥作为参数传递。 若要将授权令牌与 fromHost 配合使用，请使用此方法创建 SpeechConfig 实例，然后在创建的 SpeechConfig 实例上调用 setAuthorizationToken () 。 注意：在版本 1.8.0 中添加。
Parameters:
Returns:
fromHost
public static SpeechConfig fromHost(URI host, String subscriptionKey)
使用指定的主机和订阅密钥创建语音配置的实例。 此方法仅适用于使用非默认服务主机的用户。 将假定使用标准资源路径。 对于具有非标准资源路径或根本没有路径的服务，请改用 fromEndpoint。 注意：主机 URI 中不允许使用查询参数，必须由其他 API 设置。 注意：若要将授权令牌与 fromHost 一起使用，请使用 fromHost (java.net.URI) ，然后在创建的 SpeechConfig 实例上调用 setAuthorizationToken () 。 注意：在版本 1.8.0 中添加。
Parameters:
Returns:
fromSubscription
public static SpeechConfig fromSubscription(String subscriptionKey, String region)
使用指定的订阅密钥和服务区域创建语音配置的实例。
Parameters:
Returns:
getAuthorizationToken
public String getAuthorizationToken()
获取授权令牌。
Returns:
getEndpointId
public String getEndpointId()
获取用于语音识别的自定义语音模型的终结点 ID，或用于语音合成的自定义语音模型。
Returns:
getImpl
public SafeHandle getImpl()
获取语音配置对象的本机句柄。
Returns:
getOutputFormat
public OutputFormat getOutputFormat()
获取语音识别输出格式 (简单或详细) 。 注意：此输出格式适用于语音识别结果，用于 com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat 设置合成音频输出格式。
Returns:
getProperty
public String getProperty(PropertyId id)
通过 propertyId 获取属性。 在版本 1.3.0 中添加。
Parameters:
Returns:
getProperty
public String getProperty(String name)
获取命名属性作为值。
Parameters:
Returns:
getSpeechRecognitionLanguage
public String getSpeechRecognitionLanguage()
获取语音识别语言
Returns:
getSpeechSynthesisLanguage
public String getSpeechSynthesisLanguage()
获取语音合成语言。 在版本 1.7.0 中添加
Returns:
getSpeechSynthesisOutputFormat
public String getSpeechSynthesisOutputFormat()
获取语音合成输出格式。 在版本 1.7.0 中添加
Returns:
getSpeechSynthesisVoiceName
public String getSpeechSynthesisVoiceName()
获取语音合成语音名称。 在版本 1.7.0 中添加
Returns:
requestWordLevelTimestamps
public void requestWordLevelTimestamps()
包括单词级时间戳。 在版本 1.5.0 中添加。
setAuthorizationToken
public void setAuthorizationToken(String value)
设置授权令牌。 注意：调用方需要确保授权令牌有效。 在授权令牌过期之前，调用方需要使用新的有效令牌调用此资源库来刷新它。 由于在创建新的识别器时会复制配置值，因此新令牌值将不适用于已创建的识别器。 对于以前创建的识别器，需要设置相应识别器的授权令牌才能刷新令牌。 否则，识别器将在识别过程中遇到错误。
Parameters:
setEndpointId
public void setEndpointId(String value)
设置用于语音识别的自定义语音模型的终结点 ID，或用于语音合成的自定义语音模型。
Parameters:
setOutputFormat
public void setOutputFormat(OutputFormat format)
设置语音识别输出格式 (简单或详细) 。 注意：此输出格式适用于语音识别结果，用于 com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat 设置合成音频输出格式。
Parameters:
setProfanity
public void setProfanity(ProfanityOption profanity)
设置不雅内容选项。 在版本 1.5.0 中添加。
Parameters:
setProperty
public void setProperty(PropertyId id, String value)
通过 propertyId 设置属性。 在版本 1.3.0 中添加。
Parameters:
setProperty
public void setProperty(String name, String value)
将命名属性设置为值。
Parameters:
setProxy
public void setProxy(String proxyHostName, int proxyPort, String proxyUserName, String proxyPassword)
设置在版本 1.1.0 中添加的代理配置。 注意：代理功能在 macOS 上不可用。 此函数对此平台没有影响。
Parameters:
setServiceProperty
public void setServiceProperty(String name, String value, ServicePropertyChannel channel)
设置将使用指定通道传递给服务的属性值。 在版本 1.5.0 中添加。
Parameters:
setSpeechRecognitionLanguage
public void setSpeechRecognitionLanguage(String value)
设置语音识别语言
Parameters:
setSpeechSynthesisLanguage
public void setSpeechSynthesisLanguage(String value)
设置语音合成语言。 在版本 1.7.0 中添加
Parameters:
setSpeechSynthesisOutputFormat
public void setSpeechSynthesisOutputFormat(SpeechSynthesisOutputFormat value)
设置语音合成输出格式。 在版本 1.7.0 中添加
Parameters:
setSpeechSynthesisVoiceName
public void setSpeechSynthesisVoiceName(String value)
设置语音合成语音名称。 在版本 1.7.0 中添加
Parameters:
