IAgentCharacter::Hide

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

HRESULT Hide(
   long bFast,      // play Hiding state animation flag
   long * pdwReqID  // address of request ID
);

隐藏字符。

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

bFast

隐藏 状态动画标志。 如果此参数为 True,则 隐藏 动画在隐藏字符帧之前不会播放;如果 为 False,则播放动画。

pdwReqID

接收 Hide 请求 ID 的变量的地址。

服务器将与字符队列中的 Hide 方法关联的动画排队。 这使你可以使用它隐藏其他动画序列后面的字符。 在调用 Hide 方法之前,可以使用 Stop 方法立即播放操作。

使用 HTTP 协议访问字符和动画数据时,请使用 Prepare 方法确保在调用此方法之前 隐藏 状态动画的可用性。

隐藏字符还可能导致触发另一个可见字符的 IAgentNotifySink::ActivateInputState 事件。

隐藏字符无法访问音频通道。 如果生成动画请求并且隐藏了字符,服务器将在 RequestComplete 事件中传递失败状态。

另请参阅

IAgentCharacter::Show