Play 方法（旧版 Windows 环境功能）

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

说明

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

语法

代理**。字符（“CharacterID” ）。Play** “AnimationName”

部分	描述
AnimationName	必填。 一个指定动画序列名称的字符串。

 

言论

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

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

有关详细信息，请参阅 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 对象的 Status 属性设置为“失败”，并显示相应的错误号。 但是，如果动画不存在并且字符的数据已成功加载，服务器将引发错误。

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