SpeechTranslationConfig class

Pacote:

microsoft-cognitiveservices-speech-sdk

Configuração de tradução de fala.

Extends

SpeechConfig

Propriedades

authorizationToken	Obtém/define o token de autorização. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo chamando esse setter com um novo token válido.
endpointId	Obtém a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.
outputFormat	Obtém o formato de saída de reconhecimento de fala (simples ou detalhado). Observação: esse formato de saída é para o resultado do reconhecimento de fala, use [SpeechConfig.speechSynthesisOutputFormat] para obter o formato de saída de áudio sintetizado.
region
speechRecognitionLanguage	Obtém/define o idioma de reconhecimento de fala.
speechSynthesisLanguage	Obtém o idioma do sintetizador de fala. Adicionado na versão 1.11.0.
speechSynthesisOutputFormat	Obtém o formato de saída de síntese de fala. Adicionado na versão 1.11.0.
speechSynthesisVoiceName	Obtém a voz do sintetizador de fala. Adicionado na versão 1.11.0.
subscriptionKey
targetLanguages	Obtém o idioma de destino (texto) para traduzir.
voiceName	Obtém o nome de voz selecionado.

Métodos

addTargetLanguage(string)	Adicione um idioma de destino (texto) para traduzir.
close()	Descarte os recursos associados.
fromAuthorizationToken(string, string)	Instância estática de SpeechTranslationConfig retornada passando o token de autorização e a região de serviço. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo definindo a propriedade authorizationToken com um novo token válido. Caso contrário, todos os reconhecedores criados por essa instância speechTranslationConfig encontrarão erros durante o reconhecimento. À medida que os valores de configuração são copiados ao criar um novo reconhecedor, o novo valor de token não se aplicará aos reconhecedores que já foram criados. Para reconhecedores que foram criados antes, você precisa definir o token de autorização do reconhecedor correspondente para atualizar o token. Caso contrário, os reconhecedores encontrarão erros durante o reconhecimento.
fromEndpoint(URL, string)	Cria uma instância da configuração de tradução de fala com o ponto de extremidade e a chave de assinatura especificados. Esse método destina-se apenas a usuários que usam um ponto de extremidade de serviço ou parâmetros não padrão. Observação: as propriedades de consulta especificadas na URL do ponto de extremidade não são alteradas, mesmo que sejam definidas por outras APIs. Por exemplo, se a linguagem for definida no URI como o parâmetro de consulta "language=de-DE" e também definida pela propriedade speechRecognitionLanguage, a configuração de idioma no URI terá precedência e o idioma efetivo será "de-DE". Somente as propriedades que não são especificadas na URL do ponto de extremidade podem ser definidas por outras APIs. Observação: para usar o token de autorização com fromEndpoint, passe uma cadeia de caracteres vazia para subscriptionKey no método fromEndpoint e defina authorizationToken="token" na instância speechConfig criada para usar o token de autorização.
fromHost(URL, string)	Cria uma instância da configuração de fala com a chave de assinatura e host especificada. Esse método destina-se apenas a usuários que usam um host de serviço não padrão. O caminho do recurso padrão será assumido. Para serviços com um caminho de recurso não padrão ou nenhum caminho, use fromEndpoint. Observação: os parâmetros de consulta não são permitidos no URI do host e devem ser definidos por outras APIs. Observação: para usar um token de autorização com fromHost, use fromHost(URL) e defina a propriedade AuthorizationToken na instância speechConfig criada. Observação: adicionado na versão 1.9.0.
fromSubscription(string, string)	Instância estática de SpeechTranslationConfig retornada passando uma chave de assinatura e uma região de serviço.
setProperty(string | PropertyId, string)	Define uma propriedade nomeada como valor

Métodos herdados

enableAudioLogging()	Habilitar o log de áudio no serviço. Os logs de áudio e conteúdo são armazenados no armazenamento de propriedade da Microsoft ou em sua própria conta de armazenamento vinculada à sua assinatura dos Serviços Cognitivos (recurso de Fala habilitado para BYOS (Bring Your Own Storage). Os logs serão removidos após 30 dias. Adicionado na versão 1.7.0.
enableDictation()	Habilitar ditado. Compatível apenas com o reconhecimento contínuo de fala. Adicionado na versão 1.7.0.
getProperty(string, string)	Retorna o valor atual de uma propriedade arbitrária.
requestWordLevelTimestamps()	Inclui carimbos de data/hora no nível da palavra. Adicionado na versão 1.7.0.
setProfanity(ProfanityOption)	Define a opção de conteúdo ofensivo. Adicionado na versão 1.7.0.
setProxy(string, number)	Define a configuração de proxy. Relevante apenas em ambientes Node.js. Adicionado na versão 1.4.0.
setProxy(string, number, string, string)	Define a configuração de proxy. Relevante apenas em ambientes Node.js. Adicionado na versão 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Define um valor de propriedade que será passado para o serviço usando o canal especificado. Adicionado na versão 1.7.0.

Detalhes da propriedade

authorizationToken

Obtém/define o token de autorização. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo chamando esse setter com um novo token válido.

void authorizationToken

Valor da propriedade

void

endpointId

Obtém a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.

string endpointId

Valor da propriedade

string

A ID do ponto de extremidade

outputFormat

Obtém o formato de saída de reconhecimento de fala (simples ou detalhado). Observação: esse formato de saída é para o resultado do reconhecimento de fala, use [SpeechConfig.speechSynthesisOutputFormat] para obter o formato de saída de áudio sintetizado.

OutputFormat outputFormat

Valor da propriedade

OutputFormat

Retorna o formato de saída.

region

string region

Valor da propriedade

string

A região definida na configuração.

speechRecognitionLanguage

Obtém/define o idioma de reconhecimento de fala.

void speechRecognitionLanguage

Valor da propriedade

void

speechSynthesisLanguage

Obtém o idioma do sintetizador de fala. Adicionado na versão 1.11.0.

string speechSynthesisLanguage

Valor da propriedade

string

Retorna a linguagem de síntese de fala.

speechSynthesisOutputFormat

Obtém o formato de saída de síntese de fala. Adicionado na versão 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Valor da propriedade

SpeechSynthesisOutputFormat

Retorna o formato de saída de síntese de fala

speechSynthesisVoiceName

Obtém a voz do sintetizador de fala. Adicionado na versão 1.11.0.

string speechSynthesisVoiceName

Valor da propriedade

string

Retorna a voz de síntese de fala.

subscriptionKey

string subscriptionKey

Valor da propriedade

string

A chave de assinatura definida na configuração.

targetLanguages

Obtém o idioma de destino (texto) para traduzir.

string[] targetLanguages

Valor da propriedade

string[]

voiceName

Obtém o nome de voz selecionado.

string voiceName

Valor da propriedade

string

O nome da voz.

Detalhes do método

addTargetLanguage(string)

Adicione um idioma de destino (texto) para traduzir.

function addTargetLanguage(value: string)

Parâmetros

value

string

O idioma, como de-DE

close()

Descarte os recursos associados.

function close()

fromAuthorizationToken(string, string)

Instância estática de SpeechTranslationConfig retornada passando o token de autorização e a região de serviço. Observação: o chamador precisa garantir que o token de autorização seja válido. Antes que o token de autorização expire, o chamador precisa atualizá-lo definindo a propriedade authorizationToken com um novo token válido. Caso contrário, todos os reconhecedores criados por essa instância speechTranslationConfig encontrarão erros durante o reconhecimento. À medida que os valores de configuração são copiados ao criar um novo reconhecedor, o novo valor de token não se aplicará aos reconhecedores que já foram criados. Para reconhecedores que foram criados antes, você precisa definir o token de autorização do reconhecedor correspondente para atualizar o token. Caso contrário, os reconhecedores encontrarão erros durante o reconhecimento.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

Parâmetros

authorizationToken

string

O token de autorização.

region

string

O nome da região (consulte a página da região).

Retornos

SpeechTranslationConfig

A configuração de tradução de fala.

fromEndpoint(URL, string)

Cria uma instância da configuração de tradução de fala com o ponto de extremidade e a chave de assinatura especificados. Esse método destina-se apenas a usuários que usam um ponto de extremidade de serviço ou parâmetros não padrão. Observação: as propriedades de consulta especificadas na URL do ponto de extremidade não são alteradas, mesmo que sejam definidas por outras APIs. Por exemplo, se a linguagem for definida no URI como o parâmetro de consulta "language=de-DE" e também definida pela propriedade speechRecognitionLanguage, a configuração de idioma no URI terá precedência e o idioma efetivo será "de-DE". Somente as propriedades que não são especificadas na URL do ponto de extremidade podem ser definidas por outras APIs. Observação: para usar o token de autorização com fromEndpoint, passe uma cadeia de caracteres vazia para subscriptionKey no método fromEndpoint e defina authorizationToken="token" na instância speechConfig criada para usar o token de autorização.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

Parâmetros

endpoint

URL

O ponto de extremidade de serviço ao qual se conectar.

subscriptionKey

string

A chave de assinatura.

Retornos

SpeechTranslationConfig

Uma instância de configuração de fala.

fromHost(URL, string)

Cria uma instância da configuração de fala com a chave de assinatura e host especificada. Esse método destina-se apenas a usuários que usam um host de serviço não padrão. O caminho do recurso padrão será assumido. Para serviços com um caminho de recurso não padrão ou nenhum caminho, use fromEndpoint. Observação: os parâmetros de consulta não são permitidos no URI do host e devem ser definidos por outras APIs. Observação: para usar um token de autorização com fromHost, use fromHost(URL) e defina a propriedade AuthorizationToken na instância speechConfig criada. Observação: adicionado na versão 1.9.0.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

Parâmetros

hostName

URL

subscriptionKey

string

A chave de assinatura. Se uma chave de assinatura não for especificada, um token de autorização deverá ser definido.

Retornos

SpeechConfig

Uma instância de fábrica de fala.

fromSubscription(string, string)

Instância estática de SpeechTranslationConfig retornada passando uma chave de assinatura e uma região de serviço.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

Parâmetros

subscriptionKey

string

A chave de assinatura.

region

string

O nome da região (consulte a página da região).

Retornos

SpeechTranslationConfig

A configuração de tradução de fala.

setProperty(string | PropertyId, string)

Define uma propriedade nomeada como valor

function setProperty(name: string | PropertyId, value: string)

Parâmetros

name

string | PropertyId

O nome da propriedade a ser definida.

value

string

O novo valor da propriedade.

Detalhes do método herdado

enableAudioLogging()

Habilitar o log de áudio no serviço. Os logs de áudio e conteúdo são armazenados no armazenamento de propriedade da Microsoft ou em sua própria conta de armazenamento vinculada à sua assinatura dos Serviços Cognitivos (recurso de Fala habilitado para BYOS (Bring Your Own Storage). Os logs serão removidos após 30 dias. Adicionado na versão 1.7.0.

function enableAudioLogging()

Herdado deSpeechConfig.enableAudioLogging

enableDictation()

Habilitar ditado. Compatível apenas com o reconhecimento contínuo de fala. Adicionado na versão 1.7.0.

function enableDictation()

Herdado deSpeechConfig.enableDictation

getProperty(string, string)

Retorna o valor atual de uma propriedade arbitrária.

function getProperty(name: string, def?: string): string

Parâmetros

name

string

O nome da propriedade a ser consultada.

def

string

O valor a ser retornado caso a propriedade não seja conhecida.

Retornos

string

O valor atual, ou padrão fornecido, da propriedade fornecida.

Herdado deSpeechConfig.getProperty

requestWordLevelTimestamps()

Inclui carimbos de data/hora no nível da palavra. Adicionado na versão 1.7.0.

function requestWordLevelTimestamps()

Herdado deSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Define a opção de conteúdo ofensivo. Adicionado na versão 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parâmetros

profanity

ProfanityOption

Herdado deSpeechConfig.setProfanity

setProxy(string, number)

Define a configuração de proxy. Relevante apenas em ambientes Node.js. Adicionado na versão 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parâmetros

proxyHostName

string

O nome do host do servidor proxy.

proxyPort

number

O número da porta do servidor proxy.

Herdado deSpeechConfig.setProxy

setProxy(string, number, string, string)

Define a configuração de proxy. Relevante apenas em ambientes Node.js. Adicionado na versão 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Parâmetros

proxyHostName

string

O nome do host do servidor proxy, sem o esquema de protocolo (http://)

proxyPort

number

O número da porta do servidor proxy.

proxyUserName

string

O nome de usuário do servidor proxy.

proxyPassword

string

A senha do servidor proxy.

Herdado deSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Define um valor de propriedade que será passado para o serviço usando o canal especificado. Adicionado na versão 1.7.0.

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

Parâmetros

name

string

value

string

channel

UriQueryParameter

Herdado deSpeechConfig.setServiceProperty