TranslationRecognizer class
Reconhecedor de tradução
- Extends
Construtores
Translation |
Inicializa uma instância do TranslationRecognizer. |
Propriedades
authorization |
Obtém o token de autorização utilizado para comunicar com o serviço. |
canceled | O evento cancelou os sinais de que ocorreu um erro durante o reconhecimento. |
internal |
|
properties | A coleção de propriedades e os respetivos valores definidos para este TranslationRecognizer. |
recognized | O evento reconheceu sinais de que é recebido um resultado de reconhecimento final. |
recognizing | O evento reconhece que é recebido um resultado de reconhecimento intermédio. |
speech |
Obtém o nome de idioma que foi definido quando o reconhecedor foi criado. |
synthesizing | O evento sintetiza sinais de que é recebido um resultado de sintetização de tradução. |
target |
Obtém idiomas de destino para tradução que foram definidos quando o reconhecedor foi criado. O idioma é especificado no formato BCP-47. A tradução fornecerá texto traduzido para cada idioma. |
telemetry |
Este método devolve o estado atual da definição de telemetria. |
voice |
Obtém o nome da voz de saída. |
Propriedades Herdadas
session |
Define o processador de eventos para eventos iniciados pela sessão. |
session |
Define o processador de eventos para eventos parados de sessão. |
speech |
Define o processador de eventos para eventos parados de voz. |
speech |
Define o processador de eventos para eventos iniciados por voz. |
Métodos
add |
adicionar dinamicamente um idioma à lista de idiomas de destino (pode ser utilizado enquanto o reconhecimento está em curso) |
close(() => void, (error: string) => void) | fecha todos os recursos externos detidos por uma instância desta classe. |
From |
Construtor TranslationRecognizer. |
on |
processa ConnectionEstablishedEvent para cenários de tradução de conversação. |
recognize |
Inicia o reconhecimento e a tradução e para após a primeira expressão ser reconhecida. A tarefa devolve o texto de tradução como resultado. Nota: recognizeOnceAsync devolve quando a primeira expressão é reconhecida, pelo que é adequada apenas para reconhecimento de tiro único, como comando ou consulta. Para reconhecimento de execução prolongada, utilize startContinuousRecognitionAsync() em vez disso. |
remove |
remover dinamicamente um idioma da lista de idiomas de destino (pode ser utilizado enquanto o reconhecimento está em curso) |
start |
Inicia o reconhecimento e a tradução até que stopContinuousRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de tradução. |
stop |
Para o reconhecimento e tradução contínuas. |
Métodos Herdados
enable |
Este método ativa ou desativa globalmente a telemetria. |
Detalhes do Construtor
TranslationRecognizer(SpeechTranslationConfig, AudioConfig, IConnectionFactory)
Inicializa uma instância do TranslationRecognizer.
new TranslationRecognizer(speechConfig: SpeechTranslationConfig, audioConfig?: AudioConfig, connectionFactory?: IConnectionFactory)
Parâmetros
- speechConfig
- SpeechTranslationConfig
Conjunto de propriedades para configurar este reconhecedor.
- audioConfig
- AudioConfig
Uma configuração de áudio opcional associada ao reconhecedor
- connectionFactory
-
IConnectionFactory
Uma fábrica de ligação opcional a utilizar para gerar os URIs de ponto final, os cabeçalhos a definir, etc...
Detalhes de Propriedade
authorizationToken
Obtém o token de autorização utilizado para comunicar com o serviço.
string authorizationToken
Valor de Propriedade
string
Token de autorização.
canceled
O evento cancelou os sinais de que ocorreu um erro durante o reconhecimento.
public canceled: (sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
Valor de Propriedade
(sender: TranslationRecognizer, event: TranslationRecognitionCanceledEventArgs) => void
internalData
object internalData
Valor de Propriedade
object
properties
A coleção de propriedades e os respetivos valores definidos para este TranslationRecognizer.
PropertyCollection properties
Valor de Propriedade
A coleção de propriedades e os respetivos valores definidos para este TranslationRecognizer.
recognized
O evento reconheceu sinais de que é recebido um resultado de reconhecimento final.
public recognized: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
Valor de Propriedade
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
recognizing
O evento reconhece que é recebido um resultado de reconhecimento intermédio.
public recognizing: (sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
Valor de Propriedade
(sender: TranslationRecognizer, event: TranslationRecognitionEventArgs) => void
speechRecognitionLanguage
Obtém o nome de idioma que foi definido quando o reconhecedor foi criado.
string speechRecognitionLanguage
Valor de Propriedade
string
Obtém o nome de idioma que foi definido quando o reconhecedor foi criado.
synthesizing
O evento sintetiza sinais de que é recebido um resultado de sintetização de tradução.
public synthesizing: (sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
Valor de Propriedade
(sender: TranslationRecognizer, event: TranslationSynthesisEventArgs) => void
targetLanguages
Obtém idiomas de destino para tradução que foram definidos quando o reconhecedor foi criado. O idioma é especificado no formato BCP-47. A tradução fornecerá texto traduzido para cada idioma.
string[] targetLanguages
Valor de Propriedade
string[]
Obtém idiomas de destino para tradução que foram definidos quando o reconhecedor foi criado.
telemetryEnabled
Este método devolve o estado atual da definição de telemetria.
static boolean telemetryEnabled
Valor de Propriedade
boolean
true se a telemetria estiver ativada, caso contrário, falso.
voiceName
Obtém o nome da voz de saída.
string voiceName
Valor de Propriedade
string
o nome da voz de saída.
Detalhes da Propriedade Herdada
sessionStarted
Define o processador de eventos para eventos iniciados pela sessão.
public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SessionEventArgs) => void
Herdado deRecognizer.sessionStarted
sessionStopped
Define o processador de eventos para eventos parados de sessão.
public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SessionEventArgs) => void
Herdado deRecognizer.sessionStopped
speechEndDetected
Define o processador de eventos para eventos parados de voz.
public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: RecognitionEventArgs) => void
Herdado deRecognizer.speechEndDetected
speechStartDetected
Define o processador de eventos para eventos iniciados por voz.
public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: RecognitionEventArgs) => void
Herdado deRecognizer.speechStartDetected
Detalhes de Método
addTargetLanguage(string)
adicionar dinamicamente um idioma à lista de idiomas de destino (pode ser utilizado enquanto o reconhecimento está em curso)
function addTargetLanguage(lang: string)
Parâmetros
- lang
-
string
idioma a adicionar
close(() => void, (error: string) => void)
fecha todos os recursos externos detidos por uma instância desta classe.
function close(cb?: () => void, errorCb?: (error: string) => void)
Parâmetros
- cb
-
() => void
- errorCb
-
(error: string) => void
FromConfig(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)
Construtor TranslationRecognizer.
static function FromConfig(speechTranslationConfig: SpeechTranslationConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): TranslationRecognizer
Parâmetros
- speechTranslationConfig
- SpeechTranslationConfig
um conjunto de propriedades iniciais para este reconhecedor
- autoDetectSourceLanguageConfig
- AutoDetectSourceLanguageConfig
Uma configuração de deteção de idioma de origem associada ao reconhecedor
- audioConfig
- AudioConfig
Uma configuração de áudio opcional associada ao reconhecedor
Devoluções
onConnection()
processa ConnectionEstablishedEvent para cenários de tradução de conversação.
function onConnection()
recognizeOnceAsync((e: TranslationRecognitionResult) => void, (e: string) => void)
Inicia o reconhecimento e a tradução e para após a primeira expressão ser reconhecida. A tarefa devolve o texto de tradução como resultado. Nota: recognizeOnceAsync devolve quando a primeira expressão é reconhecida, pelo que é adequada apenas para reconhecimento de tiro único, como comando ou consulta. Para reconhecimento de execução prolongada, utilize startContinuousRecognitionAsync() em vez disso.
function recognizeOnceAsync(cb?: (e: TranslationRecognitionResult) => void, err?: (e: string) => void)
Parâmetros
- cb
-
(e: TranslationRecognitionResult) => void
Chamada de retorno que recebeu o resultado quando a tradução foi concluída.
- err
-
(e: string) => void
Chamada de retorno invocada em caso de erro.
removeTargetLanguage(string)
remover dinamicamente um idioma da lista de idiomas de destino (pode ser utilizado enquanto o reconhecimento está em curso)
function removeTargetLanguage(lang: string)
Parâmetros
- lang
-
string
idioma a remover
startContinuousRecognitionAsync(() => void, (e: string) => void)
Inicia o reconhecimento e a tradução até que stopContinuousRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de tradução.
function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
Parâmetros
- cb
-
() => void
A chamada de retorno que recebeu a tradução foi iniciada.
- err
-
(e: string) => void
Chamada de retorno invocada em caso de erro.
stopContinuousRecognitionAsync(() => void, (e: string) => void)
Para o reconhecimento e tradução contínuas.
function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
Parâmetros
- cb
-
() => void
A chamada de retorno que recebeu a tradução parou.
- err
-
(e: string) => void
Chamada de retorno invocada em caso de erro.
Detalhes do Método Herdado
enableTelemetry(boolean)
Este método ativa ou desativa globalmente a telemetria.
static function enableTelemetry(enabled: boolean)
Parâmetros
- enabled
-
boolean
Definição global da coleção de telemetria. Se estiver definido como verdadeiro, as informações de telemetria, como erros de microfone, são recolhidos e enviados erros de reconhecimento para a Microsoft. Se estiver definido como falso, não será enviada telemetria para a Microsoft.
Herdado doReconhecedor.enableTelemetry