你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
TranslationRecognizer class
翻译识别器
- 扩展
构造函数
Translation |
初始化 TranslationRecognizer 的实例。 |
属性
authorization |
获取用于与服务通信的授权令牌。 |
canceled | 事件已取消,表明识别过程中发生了错误。 |
internal |
|
properties | 为此 TranslationRecognizer 定义的属性及其值的集合。 |
recognized | 事件识别的信号是收到最终识别结果。 |
recognizing | 事件识别信号表明收到中间识别结果。 |
speech |
获取创建识别器时设置的语言名称。 |
synthesizing | 接收转换合成结果的事件合成信号。 |
target |
获取创建识别器时设置的翻译的目标语言。 语言以 BCP-47 格式指定。 翻译将为每种语言提供翻译的文本。 |
telemetry |
此方法返回遥测设置的当前状态。 |
voice |
获取输出语音的名称。 |
继承属性
session |
定义会话启动事件的事件处理程序。 |
session |
定义会话停止事件的事件处理程序。 |
speech |
定义语音停止事件的事件处理程序。 |
speech |
定义语音启动事件的事件处理程序。 |
方法
add |
将语言动态添加到目标语言列表(可在识别正在进行时使用) |
close(() => void, (error: string) => void) | 关闭此类实例持有的所有外部资源。 |
From |
TranslationRecognizer 构造函数。 |
on |
处理用于聊天翻译方案的 ConnectionEstablishedEvent。 |
recognize |
启动识别和翻译,并在识别第一个话语后停止。 该任务返回翻译文本作为结果。 注意:识别第一个话语后,recognizeOnceAsync 将返回,因此它仅适用于单次识别(如命令或查询)。 对于长时间运行的识别,请改用 startContinuousRecognitionAsync()。 |
remove |
从目标语言列表中动态删除语言(可在识别正在进行时使用) |
start |
启动识别和翻译,直到调用 stopContinuousRecognitionAsync()。 用户必须订阅事件才能接收翻译结果。 |
stop |
停止连续识别和翻译。 |
继承的方法
enable |
此方法全局启用或禁用遥测。 |
构造函数详细信息
TranslationRecognizer(SpeechTranslationConfig, AudioConfig, IConnectionFactory)
初始化 TranslationRecognizer 的实例。
new TranslationRecognizer(speechConfig: SpeechTranslationConfig, audioConfig?: AudioConfig, connectionFactory?: IConnectionFactory)
参数
- speechConfig
- SpeechTranslationConfig
要配置此识别器的属性集。
- audioConfig
- AudioConfig
与识别器关联的可选音频配置
- connectionFactory
-
IConnectionFactory
用于生成终结点 URI、要设置的标头等的可选连接工厂...
属性详细信息
authorizationToken
获取用于与服务通信的授权令牌。
string authorizationToken
属性值
string
授权令牌。
canceled
事件已取消,表明识别过程中发生了错误。
public canceled: (sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
属性值
(sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
internalData
object internalData
属性值
object
properties
为此 TranslationRecognizer 定义的属性及其值的集合。
PropertyCollection properties
属性值
为此 TranslationRecognizer 定义的属性及其值的集合。
recognized
事件识别的信号是收到最终识别结果。
public recognized: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
属性值
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
recognizing
事件识别信号表明收到中间识别结果。
public recognizing: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
属性值
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
speechRecognitionLanguage
获取创建识别器时设置的语言名称。
string speechRecognitionLanguage
属性值
string
获取创建识别器时设置的语言名称。
synthesizing
接收转换合成结果的事件合成信号。
public synthesizing: (sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
属性值
(sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
targetLanguages
获取创建识别器时设置的翻译的目标语言。 语言以 BCP-47 格式指定。 翻译将为每种语言提供翻译的文本。
string[] targetLanguages
属性值
string[]
获取创建识别器时设置的翻译的目标语言。
telemetryEnabled
此方法返回遥测设置的当前状态。
static boolean telemetryEnabled
属性值
boolean
如果启用遥测数据,则为 true;否则为 false。
voiceName
获取输出语音的名称。
string voiceName
属性值
string
输出语音的名称。
继承属性详细信息
sessionStarted
定义会话启动事件的事件处理程序。
public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void
属性值
(sender: Recognizer, event: SessionEventArgs) => void
sessionStopped
定义会话停止事件的事件处理程序。
public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void
属性值
(sender: Recognizer, event: SessionEventArgs) => void
speechEndDetected
定义语音停止事件的事件处理程序。
public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
属性值
(sender: Recognizer, event: RecognitionEventArgs) => void
speechStartDetected
定义语音启动事件的事件处理程序。
public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
属性值
(sender: Recognizer, event: RecognitionEventArgs) => void
方法详细信息
addTargetLanguage(string)
将语言动态添加到目标语言列表(可在识别正在进行时使用)
function addTargetLanguage(lang: string)
参数
- lang
-
string
要添加的语言
close(() => void, (error: string) => void)
关闭此类实例持有的所有外部资源。
function close(cb?: () => void, errorCb?: (error: string) => void)
参数
- cb
-
() => void
- errorCb
-
(error: string) => void
FromConfig(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)
TranslationRecognizer 构造函数。
static function FromConfig(speechTranslationConfig: SpeechTranslationConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): TranslationRecognizer
参数
- speechTranslationConfig
- SpeechTranslationConfig
此识别器的初始属性集
- autoDetectSourceLanguageConfig
- AutoDetectSourceLanguageConfig
与识别器关联的源语言检测配置
- audioConfig
- AudioConfig
与识别器关联的可选音频配置
返回
onConnection()
处理用于聊天翻译方案的 ConnectionEstablishedEvent。
function onConnection()
recognizeOnceAsync((e: TranslationRecognitionResult) => void, (e: string) => void)
启动识别和翻译,并在识别第一个话语后停止。 该任务返回翻译文本作为结果。 注意:识别第一个话语后,recognizeOnceAsync 将返回,因此它仅适用于单次识别(如命令或查询)。 对于长时间运行的识别,请改用 startContinuousRecognitionAsync()。
function recognizeOnceAsync(cb?: (e: TranslationRecognitionResult) => void, err?: (e: string) => void)
参数
- cb
-
(e: TranslationRecognitionResult) => void
翻译完成后收到结果的回调。
- err
-
(e: string) => void
发生错误时调用的回调。
removeTargetLanguage(string)
从目标语言列表中动态删除语言(可在识别正在进行时使用)
function removeTargetLanguage(lang: string)
参数
- lang
-
string
要删除的语言
startContinuousRecognitionAsync(() => void, (e: string) => void)
启动识别和翻译,直到调用 stopContinuousRecognitionAsync()。 用户必须订阅事件才能接收翻译结果。
function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
参数
- cb
-
() => void
已启动接收翻译的回调。
- err
-
(e: string) => void
发生错误时调用的回调。
stopContinuousRecognitionAsync(() => void, (e: string) => void)
停止连续识别和翻译。
function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
参数
- cb
-
() => void
接收翻译的回调已停止。
- err
-
(e: string) => void
发生错误时调用的回调。
继承的方法详细信息
enableTelemetry(boolean)
此方法全局启用或禁用遥测。
static function enableTelemetry(enabled: boolean)
参数
- enabled
-
boolean
遥测收集的全局设置。 如果设置为 true,则收集遥测信息(如麦克风错误)并将其发送到Microsoft。 如果设置为 false,则不会向Microsoft发送任何遥测数据。