SpeechTranslationConfig class

Pacote:

microsoft-cognitiveservices-speech-sdk

Configuração da tradução de voz.

Extends

SpeechConfig

Propriedades

authorizationToken	Obtém/Define o token de autorização. Nota: o autor da chamada tem de garantir que o token de autorização é válido. Antes de o token de autorização expirar, o autor da chamada tem de o atualizar ao chamar este setter com um novo token válido.
endpointId	Obtém o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz.
outputFormat	Obtém o formato de saída do reconhecimento de voz (simples ou detalhado). Nota: este formato de saída destina-se ao resultado do reconhecimento de voz, utilize [SpeechConfig.speechSynthesisOutputFormat] para obter o formato de saída de áudio sintetizado.
region
speechRecognitionLanguage	Obtém/Define o idioma de reconhecimento de voz.
speechSynthesisLanguage	Obtém a linguagem do sintetizador de voz. Adicionado na versão 1.11.0.
speechSynthesisOutputFormat	Obtém o formato de saída da sintetização de voz. Adicionado na versão 1.11.0.
speechSynthesisVoiceName	Obtém a voz do sintetizador de voz. 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()	Eliminar recursos associados.
fromAuthorizationToken(string, string)	Instância estática de SpeechTranslationConfig devolvida ao transmitir o token de autorização e a região do serviço. Nota: o autor da chamada tem de garantir que o token de autorização é válido. Antes de o token de autorização expirar, o autor da chamada tem de o atualizar ao definir a propriedade authorizationToken com um novo token válido. Caso contrário, todos os reconhecedores criados por esta 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 será aplicado aos reconhecedores que já tenham sido criados. Para os reconhecedores que foram criados anteriormente, tem de 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 voz com o ponto final especificado e a chave de subscrição. Este método destina-se apenas a utilizadores que utilizam um ponto final de serviço ou parâmetros não padrão. Nota: as propriedades de consulta especificadas no URL do ponto final 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 definição de idioma no uri tem precedência e o idioma em vigor é "de-DE". Apenas as propriedades que não estão especificadas no URL do ponto final podem ser definidas por outras APIs. Nota: para utilizar o token de autorização com fromEndpoint, transmita uma cadeia vazia para subscriptionKey no método fromEndpoint e, em seguida, defina authorizationToken="token" na instância SpeechConfig criada para utilizar o token de autorização.
fromHost(URL, string)	Cria uma instância da configuração de voz com o anfitrião e a chave de subscrição especificados. Este método destina-se apenas a utilizadores que utilizam um anfitrião de serviço não predefinido. Será assumido o caminho de recurso padrão. Para serviços com um caminho de recurso não padrão ou nenhum caminho, utilize fromEndpoint como alternativa. Nota: os parâmetros de consulta não são permitidos no URI do anfitrião e têm de ser definidos por outras APIs. Nota: para utilizar um token de autorização com fromHost, utilize fromHost(URL) e, em seguida, defina a propriedade AuthorizationToken na instância SpeechConfig criada. Nota: adicionado na versão 1.9.0.
fromSubscription(string, string)	Instância estática de SpeechTranslationConfig devolvida ao transmitir uma chave de subscrição e uma região de serviço.
setProperty(string | PropertyId, string)	Define uma propriedade com nome como valor

Métodos Herdados

enableAudioLogging()	Ativar o registo de áudio no serviço. Os registos de áudio e conteúdo são armazenados no armazenamento pertencente à Microsoft ou na sua própria conta de armazenamento associada à sua subscrição dos Serviços Cognitivos (recurso de Voz preparado para Bring Your Own Storage (BYOS). Os registos serão removidos após 30 dias. Adicionado na versão 1.7.0.
enableDictation()	Ativar ditado. Apenas suportado no reconhecimento contínuo de voz. Adicionado na versão 1.7.0.
getProperty(string, string)	Devolve o valor atual de uma propriedade arbitrária.
requestWordLevelTimestamps()	Inclui carimbos de data/hora ao nível da palavra. Adicionado na versão 1.7.0.
setProfanity(ProfanityOption)	Define a opção de palavras ofensivas. Adicionado na versão 1.7.0.
setProxy(string, number)	Define a configuração do proxy. Apenas relevante em ambientes Node.js. Adicionado na versão 1.4.0.
setProxy(string, number, string, string)	Define a configuração do proxy. Apenas relevante em ambientes Node.js. Adicionado na versão 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Define um valor de propriedade que será transmitido para o serviço com o canal especificado. Adicionado na versão 1.7.0.

Detalhes de Propriedade

authorizationToken

Obtém/Define o token de autorização. Nota: o autor da chamada tem de garantir que o token de autorização é válido. Antes de o token de autorização expirar, o autor da chamada tem de o atualizar ao chamar este setter com um novo token válido.

void authorizationToken

Valor de Propriedade

void

endpointId

Obtém o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz.

string endpointId

Valor de Propriedade

string

O ID do ponto final

outputFormat

Obtém o formato de saída do reconhecimento de voz (simples ou detalhado). Nota: este formato de saída destina-se ao resultado do reconhecimento de voz, utilize [SpeechConfig.speechSynthesisOutputFormat] para obter o formato de saída de áudio sintetizado.

OutputFormat outputFormat

Valor de Propriedade

OutputFormat

Devolve o formato de saída.

region

string region

Valor de Propriedade

string

A região definida na configuração.

speechRecognitionLanguage

Obtém/Define o idioma de reconhecimento de voz.

void speechRecognitionLanguage

Valor de Propriedade

void

speechSynthesisLanguage

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

string speechSynthesisLanguage

Valor de Propriedade

string

Devolve o idioma da sintetização de voz.

speechSynthesisOutputFormat

Obtém o formato de saída da sintetização de voz. Adicionado na versão 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Valor de Propriedade

SpeechSynthesisOutputFormat

Devolve o formato de saída da sintetização de voz

speechSynthesisVoiceName

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

string speechSynthesisVoiceName

Valor de Propriedade

string

Devolve a voz de sintetização de voz.

subscriptionKey

string subscriptionKey

Valor de Propriedade

string

A chave de subscrição definida na configuração.

targetLanguages

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

string[] targetLanguages

Valor de Propriedade

string[]

voiceName

Obtém o nome de voz selecionado.

string voiceName

Valor de Propriedade

string

O nome da voz.

Detalhes de 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()

Eliminar recursos associados.

function close()

fromAuthorizationToken(string, string)

Instância estática de SpeechTranslationConfig devolvida ao transmitir o token de autorização e a região do serviço. Nota: o autor da chamada tem de garantir que o token de autorização é válido. Antes de o token de autorização expirar, o autor da chamada tem de o atualizar ao definir a propriedade authorizationToken com um novo token válido. Caso contrário, todos os reconhecedores criados por esta 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 será aplicado aos reconhecedores que já tenham sido criados. Para os reconhecedores que foram criados anteriormente, tem de 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 (veja a página da região).

Devoluções

SpeechTranslationConfig

A configuração da tradução de voz.

fromEndpoint(URL, string)

Cria uma instância da configuração de tradução de voz com o ponto final especificado e a chave de subscrição. Este método destina-se apenas a utilizadores que utilizam um ponto final de serviço ou parâmetros não padrão. Nota: as propriedades de consulta especificadas no URL do ponto final 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 definição de idioma no uri tem precedência e o idioma em vigor é "de-DE". Apenas as propriedades que não estão especificadas no URL do ponto final podem ser definidas por outras APIs. Nota: para utilizar o token de autorização com fromEndpoint, transmita uma cadeia vazia para subscriptionKey no método fromEndpoint e, em seguida, defina authorizationToken="token" na instância SpeechConfig criada para utilizar o token de autorização.

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

Parâmetros

endpoint

URL

O ponto final de serviço ao qual ligar.

subscriptionKey

string

A chave de subscrição.

Devoluções

SpeechTranslationConfig

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

fromHost(URL, string)

Cria uma instância da configuração de voz com o anfitrião e a chave de subscrição especificados. Este método destina-se apenas a utilizadores que utilizam um anfitrião de serviço não predefinido. Será assumido o caminho de recurso padrão. Para serviços com um caminho de recurso não padrão ou nenhum caminho, utilize fromEndpoint como alternativa. Nota: os parâmetros de consulta não são permitidos no URI do anfitrião e têm de ser definidos por outras APIs. Nota: para utilizar um token de autorização com fromHost, utilize fromHost(URL) e, em seguida, defina a propriedade AuthorizationToken na instância SpeechConfig criada. Nota: adicionado na versão 1.9.0.

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

Parâmetros

hostName

URL

subscriptionKey

string

A chave de subscrição. Se não for especificada uma chave de subscrição, tem de ser definido um token de autorização.

Devoluções

SpeechConfig

Uma instância de fábrica de voz.

fromSubscription(string, string)

Instância estática de SpeechTranslationConfig devolvida ao transmitir uma chave de subscrição e uma região de serviço.

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

Parâmetros

subscriptionKey

string

A chave de subscrição.

region

string

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

Devoluções

SpeechTranslationConfig

A configuração da tradução de voz.

setProperty(string | PropertyId, string)

Define uma propriedade com nome como valor

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

Parâmetros

name

string | PropertyId

O nome da propriedade a definir.

value

string

O novo valor da propriedade .

Detalhes do Método Herdado

enableAudioLogging()

Ativar o registo de áudio no serviço. Os registos de áudio e conteúdo são armazenados no armazenamento pertencente à Microsoft ou na sua própria conta de armazenamento associada à sua subscrição dos Serviços Cognitivos (recurso de Voz preparado para Bring Your Own Storage (BYOS). Os registos serão removidos após 30 dias. Adicionado na versão 1.7.0.

function enableAudioLogging()

Herdado deSpeechConfig.enableAudioLogging

enableDictation()

Ativar ditado. Apenas suportado no reconhecimento contínuo de voz. Adicionado na versão 1.7.0.

function enableDictation()

Herdado deSpeechConfig.enableDictation

getProperty(string, string)

Devolve o valor atual de uma propriedade arbitrária.

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

Parâmetros

name

string

O nome da propriedade a consultar.

def

string

O valor a devolver caso a propriedade não seja conhecida.

Devoluções

string

O valor atual, ou predefinido, da propriedade especificada.

Herdado deSpeechConfig.getProperty

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

Herdado deSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Define a opção de palavras ofensivas. 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 do proxy. Apenas relevante em ambientes Node.js. Adicionado na versão 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parâmetros

proxyHostName

string

O nome do anfitrião do servidor proxy.

proxyPort

number

O número de porta do servidor proxy.

Herdado deSpeechConfig.setProxy

setProxy(string, number, string, string)

Define a configuração do proxy. Apenas relevante 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 anfitrião do servidor proxy, sem o esquema de protocolo (http://)

proxyPort

number

O número de porta do servidor proxy.

proxyUserName

string

O nome de utilizador do servidor proxy.

proxyPassword

string

A palavra-passe do servidor proxy.

Herdado deSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Define um valor de propriedade que será transmitido para o serviço com 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