Get 方法

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

Description

检索指定字符的指定动画数据。

语法

agent**。字符 (“CharacterID”) 。获取** 类型、 名称、[队列]

组成部分	描述
Type	必需。 一个字符串值，指示要加载的动画数据类型。 “动画” 角色的动画数据。 “State”字符的状态数据。 “WaveFile”用于语音输出) 文件的字符音频 (。
名称	必需。 一个字符串，指示动画类型的名称。 “name”动画或状态的名称。 对于动画，名称基于使用 Microsoft 代理字符编辑器保存时为字符定义的名称。 对于状态，可以使用以下值： “手势”获取所有 手势 状态动画。 “GesturingDown”获取 GesturingDown 动画。 “GesturingLeft”获取 GesturingLeft 动画。 “GesturingRight”获取 GesturingRight 动画。 “GesturingUp”获取 GesturingUp 动画。 “隐藏”获取 隐藏 状态动画。 “听力”获取 听力 状态动画。 “闲着”获取所有 “闲” 状态动画。 “IdlingLevel1”获取所有 IdlingLevel1 动画。 “IdlingLevel2”获取所有 IdlingLevel2 动画。 “IdlingLevel3”获取所有 IdlingLevel3 动画。 “正在侦听”获取 侦听 状态动画。 “移动”获取所有 移动 状态动画。 “MovingDown”获取 MovingDown 动画。 “MovingLeft”获取 MovingLeft 动画。 “MovingRight”获取 MovingRight 动画。 “MovingUp”获取 MovingUp 动画。 “显示”获取 显示 状态动画。 “Speaking”获取 朗语 状态动画。 可以通过用逗号分隔多个动画和状态来指定它们。 但是，不能在同一 Get 语句中混合使用类型。 “URL 或filespec”声音 (规范。WAV 或 。LWV) 文件。 如果规范不完整，则会将其解释为相对于 Load 方法中使用的规范。
队列	可选。 一个布尔表达式，指定服务器是否将 Get 请求排队。 True (默认) 将 获取 请求排队。 对于相同字符) ， 遵循 Get 请求 (的任何动画请求将等到动画数据加载完成。 假 不对 Get 请求进行排队。

备注

如果使用 HTTP 协议加载字符， (。ACF 文件) ，必须先使用 Get 方法检索动画数据，然后才能播放动画。 如果使用 UNC 协议 (加载字符，则不使用此方法。ACS 文件) 。 如果使用 UNC 协议 (加载字符，则也无法使用 Get 检索字符的 HTTP 数据。ACS 字符文件) 。

如果声明对象引用并将其设置为此方法，它将返回 Request 对象。 如果无法加载关联的动画，服务器会将 Request 对象的 Status 属性设置为“failed”，并带有相应的错误号。 可以使用 RequestComplete 事件检查状态并确定要执行的操作。

使用 Get 方法检索的动画或声音数据存储在浏览器的缓存中。 后续调用将检查缓存，如果动画数据已经存在，控件将直接从缓存加载数据。 加载后，可以使用 Play 或 Speak 方法播放动画或声音数据。

另请参阅

Load 方法