Partager via

IAgentCharacter::Hide

  • Article

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

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

Masque le caractère.

  • Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction retourne, pdwReqID contient l’ID de la requête.

bFast

Masquage de l’indicateur d’animation d’état . Si ce paramètre a la valeur True, l’animation Masquage ne se lit pas avant que le cadre de caractère ne soit masqué ; si la valeur est False, l’animation est lue.

pdwReqID

Adresse d’une variable qui reçoit l’ID de requête Masquer .

Le serveur met en file d’attente l’animation associée à la méthode Hide dans la file d’attente du caractère. Cela vous permet de l’utiliser pour masquer le caractère après une séquence d’autres animations. Vous pouvez lire l’action immédiatement à l’aide de la méthode Stop avant d’appeler la méthode Hide .

Lorsque vous utilisez le protocole HTTP pour accéder aux données de caractères et d’animation, utilisez la méthode Prepare pour garantir la disponibilité de l’animation d’état de masquage avant d’appeler cette méthode.

Le masquage d’un caractère peut également entraîner le déclenchement de l’événement IAgentNotifySink::ActivateInputState d’un autre caractère visible.

Les caractères masqués ne peuvent pas accéder au canal audio. Le serveur transmet un échec status dans l’événement RequestComplete si vous générez une demande d’animation et que le caractère est masqué.

Voir aussi

IAgentCharacter::Show