Compartilhar via

IAgentCharacterEx::GetTTSModeID

  • Artigo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

Recupera a ID do modo do mecanismo TTS definido para o caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

pbszModeID

Endereço de um BSTR que recebe a configuração de ID do modo do mecanismo TTS para o caractere.

Essa configuração retorna a ID do modo de mecanismo TTS (conversão de texto em fala) para a saída falada de um caractere. A ID do modo para um mecanismo TTS é uma representação de cadeia de caracteres do GUID (formatada com chaves e traços) definida pelo fornecedor de fala que identifica exclusivamente o mecanismo. Para obter mais informações, consulte a documentação do SDK de Fala da Microsoft. Consultar essa propriedade carregará o mecanismo associado se ele ainda não estiver carregado.

Se você não definir uma ID do modo de mecanismo TTS para o caractere, o servidor tentará retornar um mecanismo que corresponda (usando interfaces da API de Fala da Microsoft) a configuração de TTS compilada do caractere e a configuração de idioma atual do caractere. Se forem diferentes, a configuração de idioma do caractere substituirá sua configuração de modo criado. Se você não tiver definido a configuração de idioma do caractere, o idioma do caractere será a ID de idioma padrão do usuário e o servidor tentará a correspondência com base nessa ID de idioma.

Essa função não falhará se iAgentAudioObjectProperties::GetEnabled retornar False.

Essa propriedade se aplica somente ao uso do caractere pelo aplicativo cliente; a configuração não afeta outros clientes do caractere ou outros caracteres do aplicativo cliente.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de Fala da Microsoft. Os mecanismos que dão suporte aos requisitos sapi do Microsoft Agent podem ser instalados e usados com o Agent.

Consulte Também

IAgentCharacterEx::SetTTSModeID