Partilhar via


SpeechConfig class

Configuração de voz.

Propriedades

authorizationToken

Obtém o token de autorização.

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

Devolve o idioma configurado.

speechSynthesisLanguage

Obtém o idioma 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

Métodos

close()

Fecha a configuração.

enableAudioLogging()

Ative o registo de áudio no serviço. Os registos de áudio e conteúdo são armazenados no armazenamento da Microsoft ou na sua própria conta de armazenamento ligada à sua subscrição dos Serviços Cognitivos (recurso de Voz ativado 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.

fromAuthorizationToken(string, string)

Cria uma instância da fábrica de voz com o token de autorização inicial e a região especificados. 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. Nota: utilize um token derivado da sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções. À 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 já 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 voz com o ponto final especificado e a chave de subscrição. Este método destina-se apenas a utilizadores que utilizem um ponto final de serviço ou parâmetros não padrão. Nota: utilize a sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções. Nota: os parâmetros de consulta especificados no URL do ponto final não são alterados, mesmo que sejam definidos por outras APIs. Por exemplo, se o idioma for definido no uri como parâmetro de consulta "language=de-DE" e também definido por SpeechConfig.speechRecognitionLanguage = "en-US", a definição de idioma no uri tem precedência e o idioma eficaz é "de-DE". Apenas os parâmetros que não estão especificados no URL do ponto final podem ser definidos por outras APIs. Nota: para utilizar o token de autorização com fromEndpoint, transmita uma cadeia vazia para a 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 aos 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. 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 SpeechConfig devolvida ao transmitir subscriptionKey e a região de serviço. Nota: utilize a sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções.

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 profanidade. Adicionado na versão 1.7.0.

setProperty(string | PropertyId, string)

Define uma propriedade arbitrária.

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 o token de autorização.

string authorizationToken

Valor de Propriedade

string

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

Devolve o idioma configurado.

string speechRecognitionLanguage

Valor de Propriedade

string

speechSynthesisLanguage

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

string speechSynthesisLanguage

Valor de Propriedade

string

Devolve o idioma de 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.

Detalhes de Método

close()

Fecha a configuração.

function close()

enableAudioLogging()

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

function enableAudioLogging()

enableDictation()

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

function enableDictation()

fromAuthorizationToken(string, string)

Cria uma instância da fábrica de voz com o token de autorização inicial e a região especificados. 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. Nota: utilize um token derivado da sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções. À 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 já 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): SpeechConfig

Parâmetros

authorizationToken

string

O token de autorização inicial.

region

string

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

Devoluções

Uma instância de fábrica de voz.

fromEndpoint(URL, string)

Cria uma instância da configuração de voz com o ponto final especificado e a chave de subscrição. Este método destina-se apenas a utilizadores que utilizem um ponto final de serviço ou parâmetros não padrão. Nota: utilize a sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções. Nota: os parâmetros de consulta especificados no URL do ponto final não são alterados, mesmo que sejam definidos por outras APIs. Por exemplo, se o idioma for definido no uri como parâmetro de consulta "language=de-DE" e também definido por SpeechConfig.speechRecognitionLanguage = "en-US", a definição de idioma no uri tem precedência e o idioma eficaz é "de-DE". Apenas os parâmetros que não estão especificados no URL do ponto final podem ser definidos por outras APIs. Nota: para utilizar o token de autorização com fromEndpoint, transmita uma cadeia vazia para a 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): SpeechConfig

Parâmetros

endpoint

URL

O ponto final de serviço ao qual se ligar.

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.

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 aos 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. 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 SpeechConfig devolvida ao transmitir subscriptionKey e a região de serviço. Nota: utilize a sua chave de subscrição LanguageUnderstanding caso pretenda utilizar o Reconhecedor de intenções.

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

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 fábrica de voz

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.

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

Define a opção de profanidade. Adicionado na versão 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parâmetros

profanity
ProfanityOption

setProperty(string | PropertyId, string)

Define uma propriedade arbitrária.

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.

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.

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.

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