Freigeben über

Play-Methode (Legacy-Windows-Umgebungsfeatures)

  • Artikel

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

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

Syntax

agent**. Zeichen ("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-Zeichen-Editor kompiliert wird. Vor der Wiedergabe der angegebenen Animation versucht der Server, die Rückgabeanimation für die vorherige Animation wiederzugeben, sofern eine zugewiesen wurde.

Wenn Sie mithilfe eines herkömmlichen Dateiprotokolls auf animationen eines Zeichens zugreifen, können Sie einfach die Play-Methode verwenden, um den Namen der Animation anzugeben. Wenn Sie jedoch das HTTP-Protokoll für den Zugriff auf Zeichenanimationsdaten verwenden, verwenden Sie die Get-Methode , um die Animation vor dem Aufrufen der Play-Methode zu laden.

Weitere Informationen finden Sie in der Get-Methode .

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

   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 außerdem eine Animation angeben, die nicht geladen wird oder wenn das Zeichen nicht erfolgreich geladen wurde, legt der Server die Status-Eigenschaft des Request-Objekts 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, spielt der Server die Animation unsichtbar ab und legt die Status-Eigenschaft des Request-Objekts fest.