classe SpeechConfig

Classe que define configurações para reconhecimento de fala 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 usado para obter o valor do identificador subjacente.

Devoluções

Uma alça.

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.

Devoluções

A linguagem de reconhecimento de fala.

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 síntese da fala.

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 da voz da 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 o 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.

Devoluções

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

GetEndpointId

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

Obtém a ID do ponto de extremidade de Fala 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 se conectar ao serviço. Nota: 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

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

Devoluções

O token de autorização.

GetSubscriptionKey

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

Obtém a chave de subscrição que é usada para criar o Reconhecedor de Fala, o Reconhecedor de Tradução ou o Sintetizador de Fala.

Devoluções

A chave de subscrição.

GetRegion

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

Obtém a chave de região que foi usada para criar o Reconhecedor de Fala, o Reconhecido de Tradução ou o Sintetizador de Fala.

Devoluções

Região.

GetOutputFormat

Sintaxe: public inline OutputFormat GetOutputFormat ( ) const;

Obtém o formato de saída de reconhecimento de fala (simples ou detalhado). Nota: Este formato de saída é para o resultado de reconhecimento de fala, use SpeechConfig::GetSpeechSynthesisOutputFormat para obter o formato de saída de áudio sintetizado.

Devoluções

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). Nota: Este formato de saída é para o resultado de 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

SetProfanidade

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 de palavrões.

EnableAudioLogging

Sintaxe: public inline void EnableAudioLogging ( );

Habilita o registro 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 de Serviços Cognitivos (recurso de fala habilitado para Bring Your Own Storage (BYOS)).

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 ( );

Ativa o modo de ditado. Suportado apenas 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 Adicionado na versão 1.1.0.

Nota: A funcionalidade de proxy não está disponível no macOS. Esta 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 do imóvel.

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 do imóvel.

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 do imóvel.

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 do imóvel.

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 do imóvel.

• 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 subscrição.

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

Devoluções

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 token de autorização e região especificados. Nota: 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).

Devoluções

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 ponto de extremidade e assinatura especificados. Esse método destina-se apenas a usuários que usam um ponto de extremidade de serviço não padrão. Nota: Os parâmetros de consulta especificados no URI do ponto de extremidade não são alterados, mesmo que sejam definidos por quaisquer outras APIs. Por exemplo, se o idioma de reconhecimento é definido no URI como parâmetro de consulta "language=de-DE", e também definido por SetSpeechRecognitionLanguage("en-US"), a configuração de idioma no URI tem precedência, e o idioma efetivo é "de-DE". Somente os parâmetros que não são especificados no URI do ponto de extremidade podem ser definidos por outras APIs. Nota: 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 do serviço ao qual se conectar.

• subscription A chave de subscrição.

Devoluções

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 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. Nota: Os parâmetros de consulta especificados no URI do ponto de extremidade não são alterados, mesmo que sejam definidos por quaisquer outras APIs. Se um parâmetro de consulta específico é suportado ou não, depende do ponto de extremidade e do cenário. Por exemplo, se o idioma de reconhecimento é definido no URI como parâmetro de consulta "language=de-DE", e também definido por SetSpeechRecognitionLanguage("en-US"), a configuração de idioma no URI tem precedência, e o idioma efetivo é "de-DE". O exemplo só se aplica quando a combinação de ponto de extremidade e cenário oferece 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. Nota: 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. Nota: Adicionado na versão 1.5.0.

Parâmetros

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

Devoluções

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 host e assinatura especificados. Esse método destina-se apenas a usuários que usam um host de serviço não padrão. O caminho de recurso padrão será assumido. Para serviços com um caminho de recurso não padrão ou nenhum caminho, use FromEndpoint em vez disso. Nota: Os parâmetros de consulta não são permitidos no URI do host e devem ser definidos por outras APIs. Nota: Para usar um token de autorização com FromHost, use FromHost(const SPXSTRING&) e chame SetAuthorizationToken() na instância SpeechConfig criada. Nota: Adicionado na versão 1.8.0.

Parâmetros

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

• subscription A chave de subscrição.

Devoluções

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 host especificado. Esse método destina-se apenas a usuários que usam um host de serviço não padrão. O caminho de recurso padrão será assumido. Para serviços com um caminho de recurso não padrão ou nenhum caminho, use FromEndpoint em vez disso. Nota: Os parâmetros de consulta não são permitidos no URI do host e devem ser definidos por outras APIs. Nota: 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. Nota: 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" onde ":p ort" é opcional.

Devoluções

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