Compartilhar via

classe SpeechConfig

  • Artigo

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

Membros

EmbeddedSpeechConfig

Sintaxe: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sintaxe: public friend HybridSpeechConfig;

operador SPXSPEECHCONFIGHANDLE

Sintaxe: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Operador interno usado para obter o valor do identificador subjacente.

Retornos

Um identificador.

SetSpeechRecognitionLanguage

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

Defina o idioma de entrada para o reconhecedor de fala.

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 fala. O idioma é especificado no formato BCP-47.

Retornos

O idioma de reconhecimento de fala.

SetSpeechSynthesisLanguage

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

Define o idioma do sintetizador de fala. 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 o idioma do sintetizador de fala. Adicionado na versão 1.4.0.

Retornos

A linguagem de síntese de fala.

SetSpeechSynthesisVoiceName

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

Defina a voz do sintetizador de fala. 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 fala. Adicionado na versão 1.4.0.

Retornos

O nome da voz de síntese de fala.

SetSpeechSynthesisOutputFormat

Sintaxe: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Define o formato de saída de síntese de fala (por exemplo, Riff16Khz16BitMonoPcm). Adicionado na versão 1.4.0.

Parâmetros

  • formatId Especifica a ID do formato de saída

GetSpeechSynthesisOutputFormat

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

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

Retornos

O formato de saída de síntese de fala.

SetEndpointId

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

Define a ID do ponto de extremidade de Fala Personalizada ou Voz Personalizada.

Parâmetros

  • endpointId ID do ponto de extremidade.

GetEndpointId

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

Obtém a ID do ponto de extremidade de Fala Personalizada ou Voz Personalizada.

Retornos

ID do ponto de extremidade.

SetAuthorizationToken

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

Define o token de autorização para se conectar ao 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 chamando esse 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 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.

Parâmetros

  • token O token de autorização.

GetAuthorizationToken

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

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

Retornos

O token de autorização.

GetSubscriptionKey

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

Obtém a chave de assinatura usada para criar o Reconhecimento de Fala ou o Reconhecimento de Intenções ou o Reconhecimento de Tradução ou o Sintetizador de Fala.

Retornos

A chave de assinatura.

GetRegion

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

Obtém a chave de região usada para criar o Reconhecimento de Fala ou o Reconhecimento de Intenções ou o Reconhecimento de Tradução ou o Sintetizador de Fala.

Retornos

Região.

GetOutputFormat

Sintaxe: public inline OutputFormat GetOutputFormat ( ) const;

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

Retornos

Formato de saída de reconhecimento de fala.

SetOutputFormat

Sintaxe: public inline void SetOutputFormat ( OutputFormat format );

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

Parâmetros

  • format Formato de saída de reconhecimento de fala

SetProfanity

Sintaxe: public inline void SetProfanity ( ProfanityOption profanity );

Define a opção de palavrões. Adicionado na versão 1.5.0.

Parâmetros

  • profanity Valor da opção profanidade.

EnableAudioLogging

Sintaxe: public inline void EnableAudioLogging ( );

Habilita o log de áudio no serviço. Adicionado na versão 1.5.0.

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

RequestWordLevelTimestamps

Sintaxe: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

Sintaxe: public inline void EnableDictation ( );

Habilita o modo de ditado. Só há suporte no reconhecimento contínuo de fala. 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 de proxy Adicionada na versão 1.1.0.

Observação: a funcionalidade de proxy não está disponível no macOS. Essa função não terá efeito nesta plataforma.

Parâmetros

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

  • proxyPort O número da porta do servidor proxy

  • proxyUserName O nome de usuário do servidor proxy

  • proxyPassword A senha 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.

Retornos

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 A ID do parâmetro.

Retornos

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 A 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á passado para o serviço usando 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 usado para passar a propriedade especificada para o serviço.

~SpeechConfig

Sintaxe: public inline virtual ~SpeechConfig ( );

Destrói 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 fala com a chave de assinatura e a região especificadas.

Parâmetros

  • subscription A chave de assinatura.

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

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.

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 fala com o token de autorização e a região especificados. 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. Como 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.

Parâmetros

  • authToken O token de autorização.

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

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.

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 fala com o ponto de extremidade e a assinatura especificados. Esse método destina-se apenas a usuários que usam um ponto de extremidade de serviço não padrão. Observação: os parâmetros de consulta especificados no URI do ponto de extremidade não são alterados, mesmo que sejam definidos por outras APIs. Por exemplo, se a linguagem de reconhecimento for definida no URI como o parâmetro de consulta "language=de-DE", e também definida por SetSpeechRecognitionLanguage("en-US"), a configuração de idioma no URI terá precedência e o idioma efetivo será "de-DE". Somente os parâmetros que não são especificados no URI do ponto de extremidade podem ser definidos por outras APIs. Observação: para usar um token de autorização com FromEndpoint, use FromEndpoint(const SPXSTRING&) e chame SetAuthorizationToken() na instância speechconfig criada.

Parâmetros

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

  • subscription A chave de assinatura.

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.

FromEndpoint

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

Cria uma instância de SpeechConfig com o ponto de extremidade especificado. Esse método destina-se apenas a usuários que usam um ponto de extremidade de serviço não padrão. Observação: os parâmetros de consulta especificados no URI do ponto de extremidade não são alterados, mesmo que sejam definidos por outras APIs. Se um parâmetro de consulta específico tem suporte ou não, depende do ponto de extremidade e do cenário. Por exemplo, se a linguagem de reconhecimento for definida no URI como o parâmetro de consulta "language=de-DE", e também definida por SetSpeechRecognitionLanguage("en-US"), a configuração de idioma no URI terá precedência e o idioma efetivo será "de-DE". O exemplo só se aplica quando a combinação de ponto de extremidade e cenário dá suporte à linguagem como um parâmetro de consulta. Somente os parâmetros que não são especificados no URI do ponto de extremidade podem ser definidos por outras APIs. Observação: se o ponto de extremidade exigir uma chave de assinatura para autenticação, use FromEndpoint(const SPXSTRING&, const SPXSTRING&) para passar a chave de assinatura como parâmetro. Para usar um token de autorização com FromEndpoint, use esse método para criar uma instância speechConfig e, em seguida, chame SetAuthorizationToken() na instância speechconfig criada. Observação: adicionado na versão 1.5.0.

Parâmetros

  • endpoint O URI do ponto de extremidade de serviço ao qual se conectar.

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.

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 fala com o host e a assinatura especificados. 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(const SPXSTRING&) e chame SetAuthorizationToken() na instância speechconfig criada. Observação: adicionado na versão 1.8.0.

Parâmetros

  • host O host de serviço ao qual se conectar. O formato é "protocol://host:port" em que ":p ort" é opcional.

  • subscription A chave de assinatura.

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.

FromHost

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

Cria uma instância de SpeechConfig com o host especificado. 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: se o host exigir uma chave de assinatura para autenticação, use FromHost(const SPXSTRING&, const SPXSTRING&) para passar a chave de assinatura como parâmetro. Para usar um token de autorização com FromHost, use esse método para criar uma instância speechConfig e, em seguida, chame SetAuthorizationToken() na instância speechconfig criada. Observação: adicionado na versão 1.8.0.

Parâmetros

  • host O URI do host de serviço ao qual se conectar. O formato é "protocol://host:port" em que ":p ort" é opcional.

Retornos

Um ponteiro compartilhado para a nova instância de configuração de fala.