Afspeelmethode (verouderde Windows-omgevingsfuncties)

[Microsoft Agent is afgeschaft vanaf Windows 7 en is mogelijk niet beschikbaar in volgende versies van Windows.]

beschrijving

Hiermee wordt de opgegeven animatie voor het opgegeven teken afgespeeld.

syntaxis

agent**. Tekens ("CharacterID"). Afspelen** "AnimationName"

Deel	Beschrijving
AnimationName-	Vereist. Een tekenreeks die de naam van een animatiereeks aangeeft.

 

Opmerkingen

De naam van een animatie wordt gedefinieerd wanneer het teken wordt gecompileerd met de Microsoft Agent Character Editor. Voordat de opgegeven animatie wordt afgespeeld, probeert de server de Return animatie voor de vorige animatie af te spelen, als er een is toegewezen.

Wanneer u de animaties van een teken opent met behulp van een conventioneel bestandsprotocol, kunt u gewoon de methode Afspelen gebruiken om de naam van de animatie op te geven. Als u echter het HTTP-protocol gebruikt voor toegang tot tekenanimatiegegevens, gebruikt u de methode Get om de animatie te laden voordat u de methode Afspelen aanroept.

Zie de methode Get voor meer informatie.

Om de syntaxis te vereenvoudigen, kunt u een objectverwijzing declareren en instellen om te verwijzen naar het Object tekens in de verzameling Tekens tekens en de verwijzing gebruiken als onderdeel van uw Play-instructies:

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

Als u een objectverwijzing declareert en deze instelt op deze methode, wordt een Request-object geretourneerd. Als u bovendien een animatie opgeeft die niet is geladen of als het teken niet is geladen, stelt de server de eigenschap Status van Request-object in op 'mislukt' met het juiste foutnummer. Als de animatie echter niet bestaat en de gegevens van het teken al zijn geladen, treedt er een fout op op de server.

De methode Play maakt het teken niet zichtbaar. Als het teken niet zichtbaar is, speelt de server de animatie onzichtbaar af en stelt de eigenschap Status van het Request-object in.