你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
TranslationRecognizer 类
对语音输入执行翻译。
- 继承
-
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 中添加。
