Get 方法
[自 Windows 7 起弃用 Microsoft Agent,在后续版本的 Windows 中可能不可用。]
-
描述
-
检索指定字符的指定动画数据。
-
语法
-
agent**.Characters ("CharacterID").Get** Type, Name, [Queue]
组成部分 说明 类型 必需。 一个字符串值,表示要加载的动画数据类型。 "Animation" 字符的动画数据。
"State" 字符的状态数据。
"WaveFile" 字符的音频(用于口语输出)文件。Name 必需。 表示动画类型名称的字符串。 "name" 动画或状态的名称。
对于动画,该名称基于使用 Microsoft 代理字符编辑器保存时为字符定义的名称。
对于状态,可以使用以下值:
"Gesturing" 获取所有 Gesturing 状态动画。
"GesturingDown" 获取 GesturingDown 动画。
"GesturingLeft" 获取 GesturingLeft 动画。
"GesturingRight" 获取 GesturingRight 动画。
"GesturingUp" 获取 GesturingUp 动画。
"隐藏" 获取隐藏状态动画。
"Hearing" 获取听力状态动画。
"Idling" 获取所有 Idling 状态动画。
“IdlingLevel1”获取所有 IdlingLevel1 动画。
"IdlingLevel2" 获取所有 IdlingLevel2 动画。
"IdlingLevel3" 获取所有 IdlingLevel3 动画。
"Listening" 获取 Listening 状态动画。
"Moving" 获取所有 Moving 状态动画。
"MovingDown" 获取 MovingDown 动画。
"MovingLeft" 获取 MovingLeft 动画。
"MovingRight" 获取 MovingRight 动画。
"MovingUp" 获取 MovingUp 动画。
"Showing" 获取 Showing 状态动画。
"Speaking" 获取 Speaking 状态动画。
您可以用逗号分隔动画和状态来指定多个动画和状态。 但是,不能在同一 Get 语句中混合类型。
"URL 或 filespec" 声音的规范 (.WAV or .LWV) 文件。 如果规范未完成,则会将其解释为相对于 Load 方法中使用的规范。队列 可选。 一个布尔表达式,指定服务器是否对 Get 请求进行排队。 True(默认值)对 Get 请求进行排队。 在 Get 请求之后的任何动画请求(对于同一个字符)都会等待,直到动画数据加载完毕。
False 不对 Get 请求进行排队。
如果使用 HTTP 协议加载字符(一个 .ACF 文件),必须先使用 Get 方法检索动画数据,然后才能播放动画。 如果使用 UNC 协议加载字符(a.ACS 文件),则不使用此方法。 如果使用 UNC 协议加载了该字符(.ACS 字符文件),也不能使用 Get 检索字符的 HTTP 数据。
如果声明一个对象引用并将其设置为此方法,则将返回一个 Request 对象。 如果关联的动画无法加载,服务器会将 Request 对象的 Status 属性设置为"failed",并显示相应的错误编号。 可以使用 RequestComplete 事件检查状态并确定要执行的操作。
使用 Get 方法检索的动画或声音数据存储在浏览器的缓存中。 后续调用将检查缓存,如果动画数据已存在,控件会直接从缓存中加载数据。 加载后,可以使用 Play 或 Speak 方法播放动画或声音数据。