Share via

IAgentCharacter::MoveTo

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT MoveTo(
   short x,         // x-coordinate of new location
   short y,         // y-coordinate of new location
   long lSpeed,     // speed to move the character
   long * pdwReqID  // address of request ID
);

연결된 이동 상태 애니메이션을 재생하고 문자 프레임을 지정된 위치로 이동합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다. 함수가 반환되면 이 변수에는 요청의 ID가 포함됩니다.

x

화면 원점(왼쪽 위)을 기준으로 새 위치의 x 좌표(픽셀)입니다. 문자의 위치는 애니메이션 프레임의 왼쪽 위 모서리를 기반으로 합니다.

y

화면 원점(왼쪽 위)을 기준으로 새 위치의 y 좌표(픽셀 단위)입니다. 문자의 위치는 애니메이션 프레임의 왼쪽 위 모서리를 기반으로 합니다.

lSpeed

문자의 프레임이 얼마나 빨리 이동하는지 밀리초 단위로 지정하는 매개 변수입니다. 권장되는 값은 1000입니다. 0을 지정하면 애니메이션을 재생하지 않고 프레임이 이동합니다.

pdwReqID

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

HTTP 프로토콜을 사용하여 문자 및 애니메이션 데이터에 액세스하는 경우 Prepare 메서드를 사용하여 이 메서드를 호출하기 전에 이동 상태 애니메이션의 가용성을 확인합니다. 애니메이션이 로드되지 않더라도 서버는 여전히 프레임을 이동합니다.

참고 항목

IAgentCharacter::SetPosition