Play-metod (äldre Windows-miljöfunktioner)

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

Beskrivning

Spelar upp den angivna animeringen för det angivna tecknet.

syntax

agent**. Tecken ("CharacterID"). Play** "AnimationName"

Del	Beskrivning
AnimationName	Krävs. En sträng som anger namnet på en animeringssekvens.

 

Anmärkningar

En animerings namn definieras när tecknet kompileras med Microsoft Agent Character Editor. Innan du spelar upp den angivna animeringen försöker servern spela upp animeringen Return för föregående animering, om en har tilldelats.

När du använder ett teckens animeringar med ett konventionellt filprotokoll kan du helt enkelt använda metoden Play som anger namnet på animeringen. Men om du använder HTTP-protokollet för att komma åt teckenanimeringsdata använder du metoden Get för att läsa in animeringen innan du anropar metoden Play.

Mer information finns i metoden Hämta.

För att förenkla syntaxen kan du deklarera en objektreferens och ange den som referens till objektet Character i samlingen Tecken och använda referensen som en del av Play-instruktioner:

   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."

Om du deklarerar en objektreferens och anger den till den här metoden returneras ett begärandeobjekt objekt. Om du anger en animering som inte har lästs in eller om tecknet inte har lästs in ställer servern dessutom in egenskapen Status för Request-objektet till "failed" med ett lämpligt felnummer. Men om animeringen inte finns och tecknets data redan har lästs in skapar servern ett fel.

Metoden Play gör inte tecknet synligt. Om tecknet inte visas spelar servern upp animeringen osynligt och anger egenskapen Status för objektet Request.