类 Translation::SpeechTranslationConfig

class Translation::SpeechTranslationConfig
  : public SpeechConfig

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

成员

AddTargetLanguage

语法: public inline void AddTargetLanguage ( const std::string & language );

添加用于翻译的目标语言。

参数

  • language 要添加的翻译目标语言。

RemoveTargetLanguage

语法: public inline void RemoveTargetLanguage ( const std::string & language );

删除翻译的目标语言。 在版本 1.7.0 中添加。

参数

  • language 要删除的翻译目标语言。

GetTargetLanguages

语法: public inline std::vector< std::string > GetTargetLanguages ( ) const;

获取翻译的目标语言。

返回

翻译目标语言的向量。

SetVoiceName

语法: public inline void SetVoiceName ( const std::string & voice );

设置输出语音名称。

参数

  • voice 要设置的语音名称。

GetVoiceName

语法: public inline std::string GetVoiceName ( ) const;

获取输出语音名称。

返回

输出语音名称。

FromSubscription

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromSubscription ( const std::string & subscription , const std::string & region );

使用指定的订阅密钥和区域创建语音翻译配置的实例。

参数

  • subscription 订阅密钥。

  • region 区域名称 (请参阅 区域页) 。

返回

指向语音翻译配置实例的共享指针。

FromAuthorizationToken

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

使用指定的授权令牌和区域创建语音翻译配置的实例。

参数

  • authToken 授权令牌。

  • region 区域名称 (请参阅 区域页) 。

返回

指向语音翻译配置实例的共享指针。

FromEndpoint

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );

使用指定的终结点和订阅创建语音翻译配置的实例。 此方法仅适用于使用非标准服务终结点的用户。 注意:终结点 URI 中指定的查询参数不会更改,即使这些参数是由任何其他 API 设置的。 例如,如果在 URI 中将识别语言定义为查询参数“language=de-DE”,并且也由 SetSpeechRecognitionLanguage (“en-US”) 设置,则 URI 中的语言设置优先,有效语言为“de-DE”。 其他 API 只能设置终结点 URI 中未指定的参数。 注意:若要将授权令牌与 FromEndpoint 一起使用,请使用 FromEndpoint (const SPXSTRING&) ,然后在创建的 SpeechTranslationConfig 实例上调用 SetAuthorizationToken () 。

参数

  • endpoint 要连接到的服务终结点。

  • subscription 订阅密钥。

返回

指向新的 SpeechTranslationConfig 实例的共享指针。

FromEndpoint

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromEndpoint ( const std::string & endpoint );

使用指定的终结点创建语音翻译配置的实例。 此方法仅适用于使用非标准服务终结点的用户。 注意:终结点 URI 中指定的查询参数不会更改,即使这些参数是由任何其他 API 设置的。 例如,如果在 URI 中将识别语言定义为查询参数“language=de-DE”,并且也由 SetSpeechRecognitionLanguage (“en-US”) 设置,则 URI 中的语言设置优先,有效语言为“de-DE”。 其他 API 只能设置终结点 URI 中未指定的参数。 注意:如果终结点需要订阅密钥进行身份验证,请使用 FromEndpoint (const SPXSTRING&、const SPXSTRING&) 将订阅密钥作为参数传递。 若要将授权令牌与 FromEndpoint 配合使用,请使用此方法创建 SpeechTranslationConfig 实例,然后在创建的 SpeechTranslationConfig 实例上调用 SetAuthorizationToken () 。 注意:在版本 1.5.0 中添加。

参数

  • endpoint 要连接到的服务终结点。

返回

指向新的 SpeechTranslationConfig 实例的共享指针。

FromHost

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromHost ( const std::string & host , const std::string & subscription );

使用指定的主机和订阅创建语音翻译配置的实例。 此方法仅适用于使用非默认服务主机的用户。 将采用标准资源路径。 对于具有非标准资源路径或根本没有路径的服务,请改用 FromEndpoint。 注意:主机 URI 中不允许使用查询参数,必须由其他 API 设置。 注意:若要将授权令牌与 FromHost 配合使用,请使用 FromHost (const SPXSTRING&) ,然后在创建的 SpeechTranslationConfig 实例上调用 SetAuthorizationToken () 。 注意:在版本 1.8.0 中添加。

参数

  • host 要连接到的服务主机。 格式为“protocol://host:port”,其中“:p ort”是可选的。

  • subscription 订阅密钥。

返回

指向新的 SpeechTranslationConfig 实例的共享指针。

FromHost

语法: public inline static std::shared_ptr< SpeechTranslationConfig > FromHost ( const std::string & host );

使用指定的主机创建语音翻译配置的实例。 此方法仅适用于使用非默认服务主机的用户。 将采用标准资源路径。 对于具有非标准资源路径或根本没有路径的服务,请改用 FromEndpoint。 注意:主机 URI 中不允许使用查询参数,必须由其他 API 设置。 注意:如果主机需要订阅密钥进行身份验证,请使用 FromHost (const SPXSTRING&、const SPXSTRING&) 将订阅密钥作为参数传递。 若要将授权令牌与 FromHost 配合使用,请使用此方法创建 SpeechTranslationConfig 实例,然后在创建的 SpeechTranslationConfig 实例上调用 SetAuthorizationToken () 。 注意:在版本 1.8.0 中添加。

参数

  • host 要连接到的服务主机。 格式为“protocol://host:port”,其中“:p ort”是可选的。

返回

指向新 SpeechTranslationConfig 实例的共享指针。