Play – metoda (starší verze funkcí prostředí Windows)

[Microsoft Agent je zastaralý jako Windows 7 a může být nedostupný v následujících verzích Windows.]

popis

Přehraje zadanou animaci pro zadaný znak.

syntaxe

agenta**. Znaky ("CharacterID"). Přehrát** "AnimationName"

Část	Popis
animationName	Požadovaný. Řetězec, který určuje název sekvence animace.

 

Poznámky

Název animace je definován při kompilaci znaku pomocí Editoru znaků aplikace Microsoft Agent. Než přehrajete zadanou animaci, server se pokusí přehrát animaci Return pro předchozí animaci, pokud byla přiřazena.

Při přístupu k animacím znaků pomocí konvenčního protokolu souborů můžete jednoduše použít metodu Přehrát zadáním názvu animace. Pokud však pro přístup k datům animace znaků používáte protokol HTTP, použijte metodu Get k načtení animace před voláním metody Play.

Další informace najdete v metodě Get.

Pokud chcete zjednodušit syntaxi, můžete deklarovat odkaz na objekt a nastavit ho tak, aby odkaz na objekt Znak v kolekci Characters a jako součást příkazů Play použijte odkaz:

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

Pokud deklarujete odkaz na objekt a nastavíte jej na tuto metodu, vrátí Request objektu. Kromě toho, pokud zadáte animaci, která není načtena nebo pokud znak nebyl úspěšně načten, server nastaví vlastnost StavPožadavek objekt "selhal" s odpovídajícím číslem chyby. Pokud však animace neexistuje a data znaku již byla úspěšně načtena, server vyvolá chybu.

Metoda Play nezviditelní znak. Pokud není znak viditelný, server přehraje animaci bez kontroly a nastaví vlastnost Status objektu Request.