Partilhar via

Classe SpeechConfig

  • Artigo

Classe que define configurações para reconhecimento de voz/intenção ou síntese de voz.

Membros

EmbeddedSpeechConfig

Sintaxe: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sintaxe: public friend HybridSpeechConfig;

operador SPXSPEECHCONFIGHANDLE

Sintaxe: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Operador interno utilizado para obter o valor do identificador subjacente.

Devoluções

Um identificador.

SetSpeechRecognitionLanguage

Sintaxe: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );

Defina o idioma de entrada para o reconhecedor de voz.

Parâmetros

  • lang Especifica o nome do idioma falado a ser reconhecido no formato BCP-47.

GetSpeechRecognitionLanguage

Sintaxe: public inline std::string GetSpeechRecognitionLanguage ( ) const;

Obtém o idioma de entrada para o reconhecimento de voz. O idioma é especificado no formato BCP-47.

Devoluções

O idioma de reconhecimento de voz.

SetSpeechSynthesisLanguage

Sintaxe: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

Define o idioma do sintetizador de voz. Adicionado na versão 1.4.0.

Parâmetros

  • lang Especifica o nome do idioma (por exemplo, en-US)

GetSpeechSynthesisLanguage

Sintaxe: public inline std::string GetSpeechSynthesisLanguage ( ) const;

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

Devoluções

A linguagem de sintetização de voz.

SetSpeechSynthesisVoiceName

Sintaxe: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

Defina a voz do sintetizador de voz. Adicionado na versão 1.4.0.

Parâmetros

  • voiceName Especifica o nome da voz

GetSpeechSynthesisVoiceName

Sintaxe: public inline std::string GetSpeechSynthesisVoiceName ( ) const;

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

Devoluções

O nome de voz da sintetização de voz.

SetSpeechSynthesisOutputFormat

Sintaxe: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Define o formato de saída da sintetização de voz (por exemplo, Riff16Khz16BitMonoPcm). Adicionado na versão 1.4.0.

Parâmetros

  • formatId Especifica o ID do formato de saída

GetSpeechSynthesisOutputFormat

Sintaxe: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

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

Devoluções

O formato de saída da sintetização de voz.

SetEndpointId

Sintaxe: public inline void SetEndpointId ( const std::string & endpointId );

Define o ID de ponto final de Voz Personalizada ou Voz Personalizada.

Parâmetros

  • endpointId ID do ponto final.

GetEndpointId

Sintaxe: public inline std::string GetEndpointId ( ) const;

Obtém o ID de ponto final de Voz Personalizada ou Voz Personalizada.

Devoluções

ID do ponto final.

SetAuthorizationToken

Sintaxe: public inline void SetAuthorizationToken ( const std::string & token );

Define o token de autorização para ligar ao 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 chamar este setter com um novo token válido. À 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.

Parâmetros

  • token O token de autorização.

GetAuthorizationToken

Sintaxe: public inline std::string GetAuthorizationToken ( ) const;

Obtém o token de autorização para ligar ao serviço.

Devoluções

O token de autorização.

GetSubscriptionKey

Sintaxe: public inline std::string GetSubscriptionKey ( ) const;

Obtém a chave de subscrição utilizada para criar o Reconhecedor de Voz, o Reconhecedor de Intenções, o Reconhecedor de Tradução ou o Sintetizador de Voz.

Devoluções

A chave de subscrição.

GetRegion

Sintaxe: public inline std::string GetRegion ( ) const;

Obtém a chave de região que utilizou para criar o Reconhecedor de Voz, o Reconhecedor de Intenções, o Reconhecedor de Tradução ou o Sintetizador de Voz.

Devoluções

Região.

GetOutputFormat

Sintaxe: public inline OutputFormat GetOutputFormat ( ) const;

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::GetSpeechSynthesisOutputFormat para obter o formato de saída de áudio sintetizado.

Devoluções

Formato de saída do reconhecimento de voz.

SetOutputFormat

Sintaxe: public inline void SetOutputFormat ( OutputFormat format );

Define 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::SetSpeechSynthesisOutputFormat para definir o formato de saída de áudio sintetizado.

Parâmetros

  • format Formato de saída do reconhecimento de voz

SetProfanity

Sintaxe: public inline void SetProfanity ( ProfanityOption profanity );

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

Parâmetros

  • profanity Valor da opção de profanidade.

EnableAudioLogging

Sintaxe: public inline void EnableAudioLogging ( );

Ativa o registo de áudio no serviço. Adicionado na versão 1.5.0.

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).

RequestWordLevelTimestamps

Sintaxe: public inline void RequestWordLevelTimestamps ( );

Inclui carimbos de data/hora ao nível da palavra no resultado da resposta. Adicionado na versão 1.5.0.

EnableDictation

Sintaxe: public inline void EnableDictation ( );

Ativa o modo de ditado. Apenas suportado no reconhecimento contínuo de voz. Adicionado na versão 1.5.0.

SetProxy

Sintaxe: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );

Define a configuração do proxy Adicionada na versão 1.1.0.

Nota: a funcionalidade Proxy não está disponível no macOS. Esta função não terá qualquer efeito nesta plataforma.

Parâmetros

  • proxyHostName O nome do anfitrião do servidor proxy, sem o esquema de protocolo ([http://](http://))

  • proxyPort O número de porta do servidor proxy

  • proxyUserName O nome de utilizador do servidor proxy

  • proxyPassword A palavra-passe do servidor proxy

SetProperty

Sintaxe: public inline void SetProperty ( const std::string & name , const std::string & value );

Define um valor de propriedade por nome.

Parâmetros

  • name O nome da propriedade.

  • value O valor da propriedade.

GetProperty

Sintaxe: public inline std::string GetProperty ( const std::string & name ) const;

Obtém um valor de propriedade por nome.

Parâmetros

  • name O nome do parâmetro.

Devoluções

O valor da propriedade.

GetProperty

Sintaxe: public inline std::string GetProperty ( PropertyId id ) const;

Obtém um valor de propriedade por ID.

Parâmetros

  • id O ID do parâmetro.

Devoluções

O valor da propriedade.

SetProperty

Sintaxe: public inline void SetProperty ( PropertyId id , const std::string & value );

Define um valor de propriedade por ID.

Parâmetros

  • id O ID da propriedade.

  • value O valor da propriedade.

SetServiceProperty

Sintaxe: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );

Define um valor de propriedade que será transmitido para o serviço com o canal especificado. Adicionado na versão 1.5.0.

Parâmetros

  • name O nome da propriedade.

  • value O valor da propriedade.

  • channel O canal utilizado para passar a propriedade especificada para o serviço.

~SpeechConfig

Sintaxe: public inline virtual ~SpeechConfig ( );

Desestrui o objeto.

FromSubscription

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );

Cria uma instância da configuração de voz com a chave de subscrição e a região especificadas.

Parâmetros

  • subscription A chave de subscrição.

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

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.

FromAuthorizationToken

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

Cria uma instância da configuração de voz com o token de autorização 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. À 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.

Parâmetros

  • authToken O token de autorização.

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

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.

FromEndpoint

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );

Cria uma instância da configuração de voz com o ponto final e a subscrição especificados. Este método destina-se apenas a utilizadores que utilizam um ponto final de serviço não padrão. Nota: os parâmetros de consulta especificados no URI do ponto final não são alterados, mesmo que sejam definidos por outras APIs. Por exemplo, se a linguagem de reconhecimento estiver definida no URI como o parâmetro de consulta "language=de-DE" e também for definida por SetSpeechRecognitionLanguage("en-US"), a definição de idioma no URI tem precedência e o idioma em vigor é "de-DE". Apenas os parâmetros que não estão especificados no URI do ponto final podem ser definidos por outras APIs. Nota: para utilizar um token de autorização com FromEndpoint, utilize FromEndpoint(const SPXSTRING&) e, em seguida, chame SetAuthorizationToken() na instância SpeechConfig criada.

Parâmetros

  • endpoint O ponto final de serviço ao qual ligar.

  • subscription A chave de subscrição.

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.

FromEndpoint

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );

Cria uma instância de SpeechConfig com o ponto final especificado. Este método destina-se apenas a utilizadores que utilizam um ponto final de serviço não padrão. Nota: os parâmetros de consulta especificados no URI do ponto final não são alterados, mesmo que sejam definidos por outras APIs. Se um parâmetro de consulta específico é suportado ou não, depende do ponto final e do cenário. Por exemplo, se a linguagem de reconhecimento estiver definida no URI como o parâmetro de consulta "language=de-DE" e também for definida por SetSpeechRecognitionLanguage("en-US"), a definição de idioma no URI tem precedência e o idioma em vigor é "de-DE". O exemplo só se aplica quando a combinação de pontos finais e cenários suporta a linguagem como parâmetro de consulta. Apenas os parâmetros que não estão especificados no URI do ponto final podem ser definidos por outras APIs. Nota: se o ponto final exigir uma chave de subscrição para autenticação, utilize FromEndpoint(const SPXSTRING&, const SPXSTRING&) para transmitir a chave de subscrição como parâmetro. Para utilizar um token de autorização com FromEndpoint, utilize este método para criar uma instância SpeechConfig e, em seguida, chame SetAuthorizationToken() na instância SpeechConfig criada. Nota: adicionado na versão 1.5.0.

Parâmetros

  • endpoint O URI do ponto final de serviço ao qual ligar.

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.

FromHost

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );

Cria uma instância da configuração de voz com o anfitrião e a 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(const SPXSTRING&) e, em seguida, chame SetAuthorizationToken() na instância SpeechConfig criada. Nota: adicionado na versão 1.8.0.

Parâmetros

  • host O anfitrião do serviço ao qual ligar. O formato é "protocol://host:port" em que ":p ort" é opcional.

  • subscription A chave de subscrição.

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.

FromHost

Sintaxe: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );

Cria uma instância de SpeechConfig com o anfitrião especificado. 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: se o anfitrião precisar de uma chave de subscrição para autenticação, utilize FromHost(const SPXSTRING&, const SPXSTRING&) para transmitir a chave de subscrição como parâmetro. Para utilizar um token de autorização com FromHost, utilize este método para criar uma instância SpeechConfig e, em seguida, chame SetAuthorizationToken() na instância SpeechConfig criada. Nota: adicionado na versão 1.8.0.

Parâmetros

  • host O URI do anfitrião do serviço ao qual ligar. O formato é "protocol://host:port" em que ":p ort" é opcional.

Devoluções

Um ponteiro partilhado para a nova instância de configuração de voz.