Freigeben über


Play-Methode (Legacy-Windows-Umgebungsfeatures)

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Beschreibung

Gibt die angegebene Animation für das angegebene Zeichen wieder.

Syntax

Agent**. Characters ("CharacterID"). Play** "AnimationName"

Teil Beschreibung
AnimationName- Erforderlich. Eine Zeichenfolge, die den Namen einer Animationssequenz angibt.

 

Bemerkungen

Der Name einer Animation wird definiert, wenn das Zeichen mit dem Microsoft Agent Character Editor kompiliert wird. Vor der Wiedergabe der angegebenen Animation versucht der Server, die -Animation für die vorherige Animation zurückzugeben, sofern eine zugewiesen wurde.

Beim Zugriff auf Animationen eines Zeichens mithilfe eines herkömmlichen Dateiprotokolls können Sie einfach die Play-Methode verwenden, die den Namen der Animation angibt. Wenn Sie jedoch das HTTP-Protokoll für den Zugriff auf Zeichenanimationsdaten verwenden, verwenden Sie die Get-Methode, um die Animation zu laden, bevor Sie die Play-Methode aufrufen.

Weitere Informationen finden Sie in der Get-Methode.

Um die Syntax zu vereinfachen, können Sie einen Objektverweis deklarieren und so festlegen, dass in der Characters-Auflistung auf das Character-Objekt verwiesen wird und der Verweis als Teil Ihrer Play-Anweisungen verwendet wird:

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

Wenn Sie einen Objektverweis deklarieren und auf diese Methode festlegen, wird ein Request-Objekt zurückgegeben. Wenn Sie eine Animation angeben, die nicht geladen wird oder das Zeichen nicht erfolgreich geladen wurde, legt der Server die eigenschaft Status eigenschaft von Request object auf "failed" mit einer entsprechenden Fehlernummer fest. Wenn die Animation jedoch nicht vorhanden ist und die Daten des Zeichens bereits erfolgreich geladen wurden, löst der Server einen Fehler aus.

Die Play-Methode macht das Zeichen nicht sichtbar. Wenn das Zeichen nicht sichtbar ist, gibt der Server die Animation unsichtbar wieder und legt die eigenschaft Status des objekts Request fest.