Metodo Play (funzionalità dell'ambiente Windows legacy)

  • Articolo

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Descrizione

Riproduce l'animazione specificata per il carattere specificato.

Sintassi

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

Parte Descrizione
AnimationName Obbligatorio. Stringa che specifica il nome di una sequenza di animazione.

 

Commenti

Il nome di un'animazione viene definito quando il carattere viene compilato con l'editor di caratteri di Microsoft Agent. Prima di riprodurre l'animazione specificata, il server tenta di riprodurre l'animazione Return per l'animazione precedente, se è stata assegnata.

Quando si accede alle animazioni di un carattere usando un protocollo di file convenzionale, è sufficiente usare il metodo Play specificando il nome dell'animazione. Tuttavia, se si usa il protocollo HTTP per accedere ai dati dell'animazione dei caratteri, usare il metodo Get per caricare l'animazione prima di chiamare il metodo Play .

Per altre informazioni, vedere il metodo Get .

Per semplificare la sintassi, è possibile dichiarare un riferimento a un oggetto e impostarlo per fare riferimento all'oggetto Character nell'insieme Character e usare il riferimento come parte delle istruzioni 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 si dichiara un riferimento all'oggetto e lo si imposta su questo metodo, restituisce un oggetto Request . Inoltre, se si specifica un'animazione non caricata o se il carattere non è stato caricato correttamente, il server imposta la proprietà Status dell'oggetto Request su "failed" con un numero di errore appropriato. Tuttavia, se l'animazione non esiste e i dati del carattere sono già stati caricati correttamente, il server genera un errore.

Il metodo Play non rende visibile il carattere. Se il carattere non è visibile, il server esegue l'animazione invisibly e imposta la proprietà Status dell'oggetto Request .