IAgentCharacter::P repare

[自 Windows 7 起弃用 Microsoft 代理,在后续版本的 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” 检索所有 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 方法检索的动画或声音数据存储在浏览器的缓存中。 后续调用将检查缓存,如果动画数据已存在,控件会直接从缓存加载数据。 加载后,可以使用 PlaySpeak 方法播放动画或声音数据。

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