Play 方法 (旧版 Windows 环境功能)

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]

Description

播放指定字符的指定动画。

语法

agent**。字符 (“CharacterID”) 。播放** “AnimationName”

组成部分	说明
AnimationName	必需。 一个指定动画序列名称的字符串。

 

备注

使用 Microsoft 代理字符编辑器编译字符时，将定义动画的名称。 在播放指定的动画之前，服务器会尝试为上一个动画播放 返回 动画（如果已分配动画）。

使用传统文件协议访问角色的动画时，只需使用指定动画名称的 Play 方法即可。 但是，如果使用 HTTP 协议访问角色动画数据，请在调用 Play 方法之前使用 Get 方法加载动画。

有关详细信息，请参阅 Get 方法。

若要简化语法，可以声明对象引用，并将其设置为引用 Characters 集合中的 Character 对象，并将该引用用作 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."

如果声明对象引用并将其设置为此方法，它将返回 Request 对象。 此外，如果指定未加载的动画或字符尚未成功加载，则服务器会将 Request 对象的 Status 属性设置为“failed”，并带有相应的错误号。 但是，如果动画不存在，并且角色的数据已成功加载，则服务器将引发错误。

Play 方法不使字符可见。 如果角色不可见，服务器将播放动画，并设置 Request 对象的 Status 属性。