Obter Método

[O Microsoft Agent foi preterido a partir do Windows 7 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

agente**. Personagens ("CharacterID"). Get** Tipo, Nome, [Fila]

Peça	Descrição
Tipo	Necessário. Um valor de cadeia de caracteres que indica o tipo de dados de animação a ser carregado. "Animation" Dados de animação de um personagem. "State" Dados de estado de um personagem. "WaveFile" Arquivo de áudio de um caractere (para saída falada).
Nome	Necessário. Uma cadeia de caracteres que indica o nome do tipo de animação. "nome" O nome da animação ou estado. Para animações, o nome é baseado no definido para o caractere quando salvo usando o Editor de Caracteres do Microsoft Agent. Para estados, os seguintes valores podem ser usados: "Gesturing" Para obter todas as Gesturing animações de estado. "GesturingDown" Para obter o GesturingDown animação. "GesturingLeft" Para obter o GesturingLeft animação. "GesturingRight" Para obter o GesturingRight animação. "GesturingUp" Para obter o GesturingUp animação. "Escondendo" Para obter o Escondendo animação de estado. "Hearing" Para obter o Hearing animação de estado. "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 o Listening animação de estado. "Moving" Para obter todas as animações estado Moving. "MovingDown" Para obter o MovingDown animação. "MovingLeft" Para obter a animação MovingLeft. "MovingRight" Para obter o MovingRight animação. "MovingUp" Para obter o MovingUp animação. "Mostrando" Para obter o Mostrando animação de estado. "Speaking" Para obter o Speaking animação de estado. Você pode especificar várias animações e estados separando-os por vírgulas. No entanto, não é possível misturar tipos no mesmo obter instrução. "URL oufilespec" A especificação para o som (. WAV ou . LWV). Se a especificação não estiver completa, ela será interpretada como sendo relativa à especificação usada no método Load.
Fila	Opcional. Uma expressão booleana que especifica se o servidor enfileira a solicitação Get. True (padrão) enfileira a solicitação Obter. Qualquer solicitação de animação que siga a solicitação Obter (para o mesmo caractere) aguarda até que os dados da animação sejam carregados. Falso Não enfileira a solicitação Obter.

Comentários

Se você carregar um caractere usando o protocolo HTTP (um arquivo . ACF), você deve usar o método Get para recuperar dados de animação antes de poder reproduzir a animação. Você não usa esse método se você carregou o caractere usando o protocolo UNC (um arquivo . ACS). Também não é possível recuperar dados HTTP para um caractere usando Get se você carregou esse caractere usando o protocolo UNC (. Arquivo de caracteres ACS).

Se você declarar uma referência de objeto e defini-la para esse método, ele retornará um objetoRequest. Se a animação associada falhar ao carregar, o servidor definirá a propriedade Status do objeto Request como "failed" com um número de erro apropriado. Você pode usar o evento RequestComplete para verificar o status e determinar qual ação tomar.

Os dados de animação ou som recuperados com o método Get são armazenados no cache do navegador. As chamadas subsequentes verificarão o cache e, se os dados de animação já estiverem lá, o controle carregará os dados diretamente do cache. Uma vez carregados, os dados de animação ou som podem ser reproduzidos com os métodos Play ou Speak.

Ver também

Método Load