Marcas de Saída de Fala do Microsoft Agent
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
Os serviços do Microsoft Agent dão suporte à modificação da saída de fala por meio de marcas especiais inseridas na cadeia de caracteres de texto de fala. Essas marcas ajudam você a alterar as características da expressão de saída do caractere.
As marcas de saída de fala usam as seguintes regras de sintaxe:
- Todas as marcas começam e terminam com um caractere de barra invertida (\).
- O caractere de barra invertida única não está habilitado dentro de uma marca. Para incluir um caractere de barra invertida em um parâmetro de texto de uma marca, use uma barra invertida dupla (\\).
- As marcas não diferenciam maiúsculas de minúsculas. Por exemplo, \pit\ é o mesmo que \PIT\.
- As marcas dependem do espaço em branco. Por exemplo, \Rst\ não é o mesmo que \ Rst \.
A menos que seja especificado ou modificado por outra marca, a saída de fala mantém a característica definida pela marca dentro do texto especificado em um único método Speak . A saída de fala é redefinida automaticamente por meio dos parâmetros definidos pelo usuário após a conclusão de um método Speak .
Algumas marcas incluem cadeias de caracteres entre aspas. Para algumas linguagens de programação, como Visual Basic Scripting Edition (VBScript) e Visual Basic, isso significa que você pode ter que usar duas aspas para designar o parâmetro da marca ou concatenar um caractere de aspas duplas como parte da cadeia de caracteres. Este último é mostrado neste exemplo do Visual Basic:
Agent1.Characters("Genie").Speak "This is \map=" + chr(34) + "Spoken text" _
+ chr(34) + "=" + chr(34) + "Balloon text" + chr(34) + "\."
Para programação C, C++e Java™, preceda barras invertidas e aspas duplas com uma barra invertida. Por exemplo:
BSTR bszSpeak = SysAllocString(L"This is \\map=\"Spoken text\"=\"Balloon text\"\\");
pCharacter->Speak(bszSpeak, ......);
Para idiomas estrangeiros que dão suporte a caracteres DBCS (conjunto de caracteres de byte duplo), você pode usar caracteres de byte duplo para especificar parâmetros de cadeia de caracteres. No entanto, use caracteres de byte único para todos os outros parâmetros e caracteres usados para definir a marca, incluindo a própria marca.
Há suporte para as seguintes marcas:
As marcas são projetadas principalmente para ajustar a saída gerada por TTS (conversão de texto em fala). Somente as marcas Mrk e Map podem ser usadas com saída falada baseada em arquivo de som.
Observação
O Microsoft Agent não dá suporte a todas as marcas documentadas no SDK de Fala da Microsoft. Os parâmetros também podem variar dependendo do mecanismo TTS selecionado. Você pode definir um mecanismo TTS específico usando TTSModeID.