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 属性。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈