IAgentCharacter::Falar

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

HRESULT Speak(
   BSTR bszText,    // text to speak
   BSTR bszURL,     // URL of a file to speak
   long * pdwReqID  // address of a request ID
);

Fala o arquivo de texto ou som.

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

bszText

O texto que o personagem deve falar.

bszURL

O URL (ou especificação de arquivo) de um arquivo de som a ser usado para saída falada. Este pode ser um ficheiro de som padrão (. WAV) ou ficheiro de som melhorado linguisticamente (. LWV).

pdwReqID

Endereço de uma variável que recebe o ID de solicitação do Speak.

Para usar esse método com um caractere configurado para falar usando um mecanismo de conversão de texto em fala (TTS); basta fornecer o bszText parâmetro. Você pode incluir caracteres de barra vertical (|) no parâmetro bszText para designar cadeias de caracteres alternativas, de modo que cada vez que o servidor processa o método, ele escolhe aleatoriamente uma cadeia de caracteres diferente. O suporte de saída TTS é definido quando o caractere é compilado usando o Editor de Caracteres do Microsoft Agent.

Se você quiser usar a saída de arquivo de som para o caractere, especifique o local para o arquivo no parâmetro bszURL. Ao usar o protocolo HTTP para baixar um arquivo de som, use o método Prepare para garantir a disponibilidade do arquivo antes de usar esse método. Você pode usar o parâmetro bszText para especificar as palavras que aparecem no balão de palavras do caractere. Se especificar um ficheiro de som melhorado linguisticamente (. LWV) para o parâmetro bszURL e não especificar texto, o parâmetro bszText usa o texto armazenado no arquivo.

O método Speak usa a última animação reproduzida para determinar qual animação de fala deve ser reproduzida. Por exemplo, se você preceder o comando Speak com um IAgentCharacter::P lay "GestureRight", o servidor reproduzirá GestureRight e, em seguida, a animação GestureRight falando. Se a última animação reproduzida não tiver animação de fala, o Microsoft Agent reproduzirá a animação atribuída ao estado de de Fala do personagem.

Se você chamar Speak e o canal de áudio estiver ocupado, a saída de áudio do personagem não será ouvida, mas o texto será exibido no balão de palavras. A propriedade Enabled da palavra balão também deve estar True para que o texto seja exibido.

A quebra automática de palavras do Microsoft Agent no balão de palavras, quebra palavras usando caracteres de espaço em branco (por exemplo, espaço e tabulação). No entanto, pode quebrar uma palavra para caber no balão também. Em idiomas como japonês, chinês e tailandês, onde os espaços não são usados para quebrar palavras, insira um caractere de espaço de largura zero (0x200B) Unicode entre os caracteres para definir quebras de palavras lógicas.

Ver também

IAgentCharacter::P lay, IAgentBalloon::GetEnabled, IAgentCharacter::P repare