IAgentCharacterEx::SetTTSModeID

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

HRESULT SetTTSModeID(
   BSTR bszModeID  // TTS engine ID
);

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

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

bszModeID

A configuração de ID do modo do mecanismo TTS para o caractere.

Observação

IAgentCharacterEx:SetTTSModeID poderá falhar se Speech.dll não estiver instalado e o mecanismo especificado não corresponder à configuração do modo TTS compilado do caractere.

 

Essa configuração determina o modo de mecanismo preferencial para a saída TTS falada de um caractere. A ID do modo para um mecanismo TTS (conversão de texto em fala) é o GUID definido pelo fornecedor de fala que identifica exclusivamente o modo do mecanismo (formatado com chaves e traços). Para obter mais informações, consulte a documentação do SDK de Fala da Microsoft.

Se você definir uma ID de modo TTS, ela substituirá a tentativa do servidor de corresponder a um mecanismo de fala com base na ID do modo TTS compilada do caractere, na ID do idioma atual do sistema e na ID do idioma atual do caractere. No entanto, se você tentar definir uma ID de modo quando o usuário tiver desabilitado a saída de fala na folha de propriedades do Microsoft Agent ou quando o mecanismo associado não estiver instalado, essa chamada falhará.

Se você não definir uma ID do modo de mecanismo TTS para o caractere, o servidor definirá um mecanismo que corresponde à configuração de linguagem do caractere (usando interfaces da API de Fala da Microsoft). Definir essa propriedade carregará o mecanismo associado se ele ainda não estiver carregado.

Essa propriedade se aplica apenas 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:GetTTSModeID