Método Get
[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]
-
Descrição
-
Recupera dados de animação especificados para o caractere especificado.
-
Sintaxe
-
agent**.Characters ("CharacterID").Get** Type, Name, [Queue]
Parte Descrição Tipo Obrigatória. Um valor de cadeia de caracteres que indica o tipo de dados de animação a ser carregado. "Animation" Os dados de animação do caractere.
"State" Os dados de estado de um caractere.
"WaveFile" Um arquivo de áudio (para saída falada) de um caractere.Nome Obrigatórios. Uma cadeia de caracteres que indica o tipo de animação. "name" O nome da animação ou do estado.
Para animações, o nome é baseado naquele definido para o caractere quando salvo usando o editor de caracteres do Microsoft Agent.
Para os estados, os seguintes valores podem ser usados:
"Gesturing" Para obter todas as animações de estado Gesturing.
"GesturingDown" Para obter a animação GesturingDown.
"GesturingLeft" Para obter a animação GesturingLeft.
"GesturingRight" Para obter a animação GesturingRight.
"GesturingUp" Para obter a animação GesturingUp.
"Hiding" Para obter a animação de estado Hiding.
"Hearing" Para obter a animação de estado Hearing.
"Idling" Para obter todas as animações de estado Idling.
"IdlingLevel1" Para obter todas as animações IdlingLevel1.
"IdlingLevel2" Para obter todas as animações IdlingLevel2.
"IdlingLevel3" Para obter todas as animações IdlingLevel3.
"Listening" Para obter a animação de estado Listening.
"Moving" Para obter todas as animações de estado Moving.
"MovingDown" Para obter a animação MovingDown.
"MovingLeft" Para obter a animação MovingLeft.
"MovingRight" Para obter a animação MovingRight.
"MovingUp" Para obter a animação MovingUp.
"Showing" Para obter a animação de estado Showing.
"Speaking" Para obter a animação de estado Speaking.
Você pode especificar várias animações e estados separando-os com vírgulas. No entanto, não é possível misturar tipos na mesma instrução Get .
"URL or filespec" A especificação para do arquivo de áudio (.WAV ou .LWV). Se a especificação não estiver completa, ela será interpretada como relativa à especificação usada no método Load.Fila Opcional. Uma expressão booliana que especifica se o servidor enfileira a solicitação Get. True (Padrão) Enfileira a solicitação Get. Qualquer solicitação de animação que segue a solicitação Get (para o mesmo caractere) aguarda até que os dados de animação sejam carregados.
False Não enfileira a solicitação Get.
Comentários
Se você carregar um caractere usando o protocolo HTTP (um arquivo .ACF), deverá usar o método Get para recuperar dados de animação antes de poder reproduzir a animação. Você não usará esse método se tiver carregado o caractere usando o protocolo UNC (um arquivo .ACS). Você também não poderá recuperar dados HTTP para um caractere usando Get se tiver carregado o caractere usando o protocolo UNC (arquivo de caractere .ACS).
Se você declarar uma referência de objeto e configurá-la para esse método, ela retornará um objeto Request. Se a animação associada não for carregada, o servidor definirá o objeto Request e a propriedade Status como "failed" com um número de erro apropriado. Você pode usar o evento RequestComplete para verificar o status e determinar qual ação realizar.
Os dados de animação ou som recuperados com o método Get são armazenados no cache do navegador. As chamadas subsequentes farão a verificação do cache e, se os dados de animação já estiverem presentes, o controle carregará os dados diretamente do cache. Depois de carregados, os dados de animação ou som poderão ser reproduzidos com os métodos Play ou Speak.