SpeechTranslationConfig class
Configuração da tradução de voz.
- Extends
Propriedades
authorization |
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. |
endpoint |
Obtém o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz. |
output |
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 | |
speech |
Obtém/Define o idioma de reconhecimento de voz. |
speech |
Obtém a linguagem do sintetizador de voz. Adicionado na versão 1.11.0. |
speech |
Obtém o formato de saída da sintetização de voz. Adicionado na versão 1.11.0. |
speech |
Obtém a voz do sintetizador de voz. Adicionado na versão 1.11.0. |
subscription |
|
target |
Obtém o idioma de destino (texto) para traduzir. |
voice |
Obtém o nome de voz selecionado. |
Métodos
add |
Adicione um idioma de destino (texto) para traduzir. |
close() | Eliminar recursos associados. |
from |
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. |
from |
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. |
from |
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. |
from |
Instância estática de SpeechTranslationConfig devolvida ao transmitir uma chave de subscrição e uma região de serviço. |
set |
Define uma propriedade com nome como valor |
Métodos Herdados
enable |
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. |
enable |
Ativar ditado. Apenas suportado no reconhecimento contínuo de voz. Adicionado na versão 1.7.0. |
get |
Devolve o valor atual de uma propriedade arbitrária. |
request |
Inclui carimbos de data/hora ao nível da palavra. Adicionado na versão 1.7.0. |
set |
Define a opção de palavras ofensivas. Adicionado na versão 1.7.0. |
set |
Define a configuração do proxy. Apenas relevante em ambientes Node.js. Adicionado na versão 1.4.0. |
set |
Define a configuração do proxy. Apenas relevante em ambientes Node.js. Adicionado na versão 1.4.0. |
set |
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
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
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
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
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
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
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