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

TranslationRecognizer 类

对语音输入执行翻译。

继承

Recognizer

TranslationRecognizer

构造函数

TranslationRecognizer(translation_config: SpeechTranslationConfig, auto_detect_source_language_config: AutoDetectSourceLanguageConfig | None = None, audio_config: AudioConfig | None = None)

参数

名称	说明
translation_config 必需	转换识别器的配置。
auto_detect_source_language_config	自动检测源语言配置 默认值: None
audio_config	音频输入的配置。 默认值: None

方法

add_target_language	将 语言 添加到要翻译的目标语言列表中。 注意 在版本 1.7.0 中添加。
recognize_once	在阻止 (同步) 模式下执行识别。 在识别单个言语后返回。 单个言语的结束是通过在结束时倾听静音或处理最长 15 秒音频时确定的。 该任务返回作为结果的识别文本。 对于长时间运行的多言语识别，请改用 start_continuous_recognition_async。
recognize_once_async	在非阻塞 (异步) 模式下执行识别。 这将识别单个言语。 单个言语的结束是通过在结束时倾听静音或处理最长 15 秒音频时确定的。 对于长时间运行的多言语识别，请改用 start_continuous_recognition_async。
remove_target_language	从要翻译的目标语言列表中删除语言。 注意 在版本 1.7.0 中添加。
start_continuous_recognition	同步启动连续识别操作。 用户必须连接到 EventSignal 才能接收识别结果。 调用 stop_continuous_recognition_async 以停止识别。
start_continuous_recognition_async	异步启动连续识别操作。 用户必须连接到 EventSignal 才能接收识别结果。 调用 stop_continuous_recognition_async 以停止识别。
start_keyword_recognition	使用给定的关键字 (keyword) 模型同步配置识别器。 调用此方法后，识别器正在侦听关键字 (keyword) 以启动识别。 调用 stop_keyword_recognition () 以结束关键字 (keyword) 发起的识别。
start_keyword_recognition_async	使用给定的关键字 (keyword) 模型异步配置识别器。 调用此方法后，识别器正在侦听关键字 (keyword) 以启动识别。 调用 stop_keyword_recognition_async () 以结束关键字 (keyword) 发起的识别。
stop_continuous_recognition	同步终止正在进行的连续识别操作。
stop_continuous_recognition_async	异步终止正在进行的连续识别操作。
stop_keyword_recognition	同步结束关键字 (keyword) 发起的识别。
stop_keyword_recognition_async	异步结束关键字 (keyword) 发起的识别。

add_target_language

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

注意

在版本 1.7.0 中添加。

add_target_language(language: str)

参数

名称	说明
language 必需	要添加的语言代码。

recognize_once

在阻止 (同步) 模式下执行识别。 在识别单个言语后返回。 单个言语的结束是通过在结束时倾听静音或处理最长 15 秒音频时确定的。 该任务返回作为结果的识别文本。 对于长时间运行的多言语识别，请改用 start_continuous_recognition_async。

recognize_once() -> TranslationRecognitionResult

返回

类型	说明
	同步识别的结果值。

recognize_once_async

在非阻塞 (异步) 模式下执行识别。 这将识别单个言语。 单个言语的结束是通过在结束时倾听静音或处理最长 15 秒音频时确定的。 对于长时间运行的多言语识别，请改用 start_continuous_recognition_async。

recognize_once_async() -> ResultFuture

返回

类型	说明
	包含异步识别的结果值的未来。

remove_target_language

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

注意

在版本 1.7.0 中添加。

remove_target_language(language: str)

参数

名称	说明
language 必需	要删除的语言代码。

start_continuous_recognition

同步启动连续识别操作。 用户必须连接到 EventSignal 才能接收识别结果。 调用 stop_continuous_recognition_async 以停止识别。

start_continuous_recognition()

start_continuous_recognition_async

异步启动连续识别操作。 用户必须连接到 EventSignal 才能接收识别结果。 调用 stop_continuous_recognition_async 以停止识别。

start_continuous_recognition_async() -> ResultFuture

返回

类型	说明
	初始化识别后实现的未来。

start_keyword_recognition

使用给定的关键字 (keyword) 模型同步配置识别器。 调用此方法后，识别器正在侦听关键字 (keyword) 以启动识别。 调用 stop_keyword_recognition () 以结束关键字 (keyword) 发起的识别。

start_keyword_recognition(model: KeywordRecognitionModel)

参数

名称	说明
model 必需	指定要识别关键字 (keyword) 的关键字 (keyword) 识别模型。

start_keyword_recognition_async

使用给定的关键字 (keyword) 模型异步配置识别器。 调用此方法后，识别器正在侦听关键字 (keyword) 以启动识别。 调用 stop_keyword_recognition_async () 以结束关键字 (keyword) 发起的识别。

start_keyword_recognition_async(model: KeywordRecognitionModel)

参数

名称	说明
model 必需	指定要识别关键字 (keyword) 的关键字 (keyword) 识别模型。

返回

类型	说明
	初始化识别后实现的未来。

stop_continuous_recognition

同步终止正在进行的连续识别操作。

stop_continuous_recognition()

stop_continuous_recognition_async

异步终止正在进行的连续识别操作。

stop_continuous_recognition_async()

返回

类型	说明
	一个在识别停止后实现的未来。

stop_keyword_recognition

同步结束关键字 (keyword) 发起的识别。

stop_keyword_recognition()

stop_keyword_recognition_async

异步结束关键字 (keyword) 发起的识别。

stop_keyword_recognition_async()

返回

类型	说明
	一个在识别停止后实现的未来。

属性

authorization_token

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

注意

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

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

新的有效令牌。 否则，识别器将在识别过程中遇到错误。

canceled

包含已取消识别结果的事件的信号 (指示因结果或直接取消请求而取消的识别尝试，或者) 传输或协议失败。

连接到此信号的回调使用 作为单个参数的 实例调用 TranslationRecognitionCanceledEventArgs。

endpoint_id

用于识别的自定义语音模型的终结点 ID，或用于语音合成的自定义语音模型的终结点 ID。

properties

为此识别器定义的属性及其值的集合。

recognized

包含最终识别结果的事件的信号 (指示) 成功识别尝试。

连接到此信号的回调使用 作为单个参数的 实例调用 TranslationRecognitionEventArgs，具体取决于识别器的类型。

recognizing

包含中间识别结果的事件的信号。

连接到此信号的回调使用 作为单个参数的 实例调用 TranslationRecognitionEventArgs。

session_started

指示识别会话开始 (操作) 的事件的信号。

连接到此信号的回调调用时，实例 SessionEventArgs 作为单个参数。

session_stopped

指示识别会话结束 (操作) 的事件的信号。

连接到此信号的回调调用时，实例 SessionEventArgs 作为单个参数。

speech_end_detected

指示语音结束的事件的信号。

连接到此信号的回调调用时，实例 RecognitionEventArgs 作为单个参数。

speech_start_detected

指示语音开始的事件的信号。

连接到此信号的回调调用时，实例 RecognitionEventArgs 作为单个参数。

synthesizing

事件指示已收到转换合成结果。

连接到此信号的回调调用时，实例 TranslationSynthesisEventArgs 作为单个参数。

target_languages

翻译的目标语言。

注意

在版本 1.7.0 中添加。