Propriedade TTSModeID
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
-
Descrição
-
Retorna ou define o modo de mecanismo TTS usado para o caractere.
-
Sintaxe
-
agent**. Caracteres ("CharacterID"). TTSModeID** [ = ModeID]
Parte Descrição ModeID Uma expressão de cadeia de caracteres que corresponde à ID de modo de um mecanismo de fala.
Comentários
Essa propriedade determina 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 cadeia de caracteres formatada definida pelo fornecedor de fala que identifica exclusivamente o modo do mecanismo. Para obter mais informações, consulte Acessando um mecanismo de fala em seu código.
Definir essa propriedade substitui a tentativa do servidor de carregar um mecanismo com base na configuração de TTS compilada do caractere e na configuração languageID atual do caractere. No entanto, se você especificar uma ID de modo para um mecanismo que não está instalado ou se o usuário tiver desabilitado a saída de fala na folha de propriedades do Microsoft Agent (AudioOutput.Enabled = False), o servidor gerará um erro.
Se você não (ou não tiver definido com êxito) uma ID de modo TTS para o caractere, o servidor verificará se a configuração do modo TTS compilado do caractere corresponde à configuração LanguageID do caractere e se o mecanismo TTS associado está instalado. Nesse caso, o modo TTS usado pelo caractere para saída falada e essa propriedade retornará essa ID de modo. Caso contrário, o servidor solicita um mecanismo de fala SAPI compatível que corresponda à LanguageID do caractere, bem como o gênero e a idade definidos para a ID do modo compilado do caractere. Se você não definiu o LanguageID do caractere, seu LanguageID é o idioma do usuário atual. Se nenhum mecanismo correspondente puder ser encontrado, a consulta para essa propriedade retornará uma cadeia de caracteres vazia para a ID do modo do mecanismo. Da mesma forma, se você consultar essa propriedade quando o usuário tiver desabilitado a saída de fala na folha de propriedades do Microsoft Agent (AudioOutput.Enabled = False), o valor será uma cadeia de caracteres vazia.
Consultar ou definir essa propriedade carregará o mecanismo associado (se ele ainda não estiver carregado). No entanto, se o mecanismo especificado na configuração de TTS compilada do caractere estiver instalado e corresponder à configuração da ID do idioma do caractere, o mecanismo será carregado quando o caractere for carregado.
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.
Observação
Essa propriedade também retornará a cadeia de caracteres vazia se você não tiver suporte de som compatível instalado em seu sistema.
Observação
A configuração do TTSModeID poderá falhar se Speech.dll não estiver instalado e o mecanismo especificado não corresponder à configuração do modo TTS compilado do caractere.
Observação
A consulta dessa propriedade normalmente não retorna um erro. No entanto, se o mecanismo de fala levar um tempo anormalmente longo para ser carregado, você poderá receber um erro indicando que a consulta atingiu o tempo limite.
Consulte Também