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

요청 ID 숨기기를 수신하는 변수의 주소입니다.

서버는 문자 큐에서 Hide 메서드와 연결된 애니메이션을 큐에 대기합니다. 이렇게 하면 다른 애니메이션 시퀀스 뒤에 문자를 숨기는 데 사용할 수 있습니다. Hide 메서드를 호출하기 전에 Stop 메서드를 사용하여 작업을 즉시 수행할 수 있습니다.

HTTP 프로토콜을 사용하여 문자 및 애니메이션 데이터에 액세스하는 경우 Prepare 메서드를 사용하여 이 메서드를 호출하기 전에 숨기기 상태 애니메이션의 가용성을 확인합니다.

문자를 숨기면 표시되는 다른 문자의 IAgentNotifySink::ActivateInputState 이벤트가 트리거될 수도 있습니다.

숨겨진 문자는 오디오 채널에 액세스할 수 없습니다. 애니메이션 요청을 생성하고 문자가 숨겨진 경우 서버는 RequestComplete 이벤트에서 오류 상태 전달합니다.

참고 항목

IAgentCharacter::Show