IAgentCharacterEx::SetTTSModeID

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

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

Define o ID de 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 de modo do mecanismo TTS para o personagem.

Observação

IAgentCharacterEx:SetTTSModeID pode 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 preferido para a saída TTS falada de um personagem. O ID de modo para um mecanismo TTS (text-to-speech) é 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 Microsoft Speech SDK.

Se você definir um ID de modo TTS, ele substituirá a tentativa do servidor de corresponder a um mecanismo de fala com base no ID de modo TTS compilado do caractere, no ID de idioma do sistema atual e no ID de 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 um ID de modo de mecanismo TTS para o caractere, o servidor definirá um mecanismo que corresponda à configuração de idioma do caractere (usando interfaces da API de Fala da Microsoft). A configuração dessa propriedade carregará o mecanismo associado se ele ainda não estiver carregado.

Esta propriedade aplica-se apenas ao uso do caractere pelo seu aplicativo cliente; A configuração não afeta outros clientes do caractere ou outros caracteres do seu aplicativo cliente.

Os requisitos do mecanismo de fala do Microsoft Agent são baseados na API de fala da Microsoft. Os mecanismos que suportam os requisitos SAPI do Microsoft Agent podem ser instalados e usados com o Agent.

Ver também

IAgentCharacterEx:GetTTSModeID