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 属性。