Método Play (recursos herdados do ambiente Windows)

[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

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

Sintaxe

agente**. Personagens ("CharacterID"). Reproduzir** "AnimationName"

Peça	Descrição
AnimationName	Necessário. 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 tenta reproduzir a animação Return para a animação anterior, se uma tiver sido atribuída.

Ao acessar as animações de um personagem 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 caracteres, 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 fazer referência ao 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 para esse método, ele retornará um objetoRequest. Além disso, se você especificar uma animação que não seja carregada ou se o caractere não tiver sido carregado com êxito, o servidor definirá a propriedade Statusde objeto Request como "failed" com um número de erro apropriado. No entanto, se a animação não existir e os dados do personagem já tiverem sido carregados com êxito, o servidor gerará um erro.

O método Play não torna o personagem visível. Se o caractere não estiver visível, o servidor reproduz a animação invisivelmente e define a propriedade Statusdo objetoRequest.