Compartilhar via

Método Play (recursos herdados do ambiente do Windows)

  • Artigo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

Descrição

Reproduz a animação especificada para o caractere especificado.

Sintaxe

agent**. Caracteres ("CharacterID"). Reproduzir** "AnimationName"

Parte Descrição
AnimationName Obrigatórios. Uma cadeia de caracteres que especifica o nome de uma sequência de animação.

 

Comentários

O nome de uma animação é definido quando o caractere é compilado com o Editor de Caracteres do Microsoft Agent. Antes de reproduzir a animação especificada, o servidor tentará reproduzir a animação Return para a animação anterior, se uma tiver sido atribuída.

Ao acessar animações de um caractere usando um protocolo de arquivo convencional, você pode simplesmente usar o método Play especificando o nome da animação. No entanto, se você estiver usando o protocolo HTTP para acessar dados de animação de caractere, use o método Get para carregar a animação antes de chamar o método Play .

Para obter mais informações, consulte o método Get .

Para simplificar sua sintaxe, você pode declarar uma referência de objeto e defini-la para referenciar o objeto Character na coleção Characters e usar a referência como parte de suas instruções Play :

   Dim Genie   
   Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"

   Set Genie = Agent1.Characters ("Genie")
   
   Genie.Get "state", "Showing"
   Genie.Show

   Genie.Get "animation", "Greet, GreetReturn"
   Genie.Play "Greet"
   Genie.Speak "Hello."

Se você declarar uma referência de objeto e defini-la como esse método, ela retornará um objeto Request . Além disso, se você especificar uma animação que não foi carregada ou se o caractere não tiver sido carregado com êxito, o servidor definirá a propriedade Status do objeto Request como "falhou" com um número de erro apropriado. No entanto, se a animação não existir e os dados do caractere já tiverem sido carregados com êxito, o servidor gerará um erro.

O método Play não torna o caractere visível. Se o caractere não estiver visível, o servidor reproduzirá a animação de forma invisivelmente e definirá a propriedade Status do objeto Request .