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 イベントでエラー状態を返します。
参照