Share via

IAgentCharacter::Hide

  • [アーティクル]

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの 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