IAgentCharacter：:P repare

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

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

检索字符的动画数据。

• 返回指示操作成功的S_OK。 当函数返回时， pdwReqID 包含请求的 ID。

dwType

一个 值，该值指示要加载的动画数据类型，该数据类型必须是下列值之一：

值	说明
const unsigned shortPREPARE_ANIMATION = 0;	角色的动画数据。
const unsigned shortPREPARE_STATE = 1;	字符的状态数据。
const unsigned shortPREPARE_WAVE = 2	角色的声音文件 (。WAV 或 。用于语音输出的 LWV) 。

bszName

动画或状态的名称。

动画名称基于使用 Microsoft 代理字符编辑器保存时为字符定义的名称。

对于状态，该值可以是以下值之一：

	说明
“Gesturing”	检索所有 Gesturing 状态动画。
“GesturingDown”	检索 GesturingDown 动画。
“GesturingLeft”	检索 GesturingLeft 动画。
“GesturingRight”	检索 GesturingRight 动画。
“GesturingUp”	检索 GesturingUp 动画。
“隐藏”	检索 隐藏 状态动画。
“听力”	检索 “听觉 ”状态动画。
“Idling”	检索所有 闲动 状态动画。
“IdlingLevel1”	检索所有 IdlingLevel1 动画。
“IdlingLevel2”	检索所有 IdlingLevel2 动画。
“IdlingLevel3”	检索所有 IdlingLevel3 动画。
“侦听”	检索 侦听 状态动画。
“移动”	检索所有 移动 状态动画。
“MovingDown”	检索所有 移动 动画。
“MovingLeft”	检索所有 MovingLeft 动画。
“MovingRight”	检索所有 MovingRight 动画。
“MovingUp”	检索所有 MovingUp 动画。
“显示”	检索 显示 状态动画。
“说话”	检索 口语 状态动画。

对于 。WAV 文件，将 bszName 设置为 的 URL 或文件规范。WAV 文件。 如果规范不完整，则会将其解释为相对于 Load 方法中使用的规范。

bQueue

一个布尔值，指定服务器是否将 准备 请求排队。 True 会将请求排入队列，并导致其后跟的任何动画请求等待，直到加载它指定的动画数据。 False 异步检索动画数据。

pdwReqID

接收 准备 请求 ID 的变量的地址。

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

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

可以通过用逗号分隔多个动画和状态来指定它们。 但是，不能在同一 Prepare 语句中混合类型。