Propriedade TTSModeID

[O Microsoft Agent é 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 (texto em fala) para a saída falada de um caractere. A ID de 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 Como acessar 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 desabilitou 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 solicitará 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 tiver definido o LanguageID do caractere, seu LanguageID será 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 de 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 ainda não estiver carregado). No entanto, se o mecanismo especificado na configuração de TTS compilada do caractere for 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 de 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 demorar um tempo anormalmente longo para ser carregado, você poderá receber um erro indicando que a consulta atingiu o tempo limite.

 

Consulte Também

Propriedade LanguageID