IAgentCharacter::P repare

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

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

문자의 애니메이션 데이터를 검색합니다.

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

dwType

로드할 애니메이션 데이터 형식을 나타내는 값으로, 다음 중 하나여야 합니다.

값	Description
const unsigned shortPREPARE_ANIMATION = 0;	문자의 애니메이션 데이터입니다.
const unsigned shortPREPARE_STATE = 1;	문자의 상태 데이터입니다.
const unsigned shortPREPARE_WAVE = 2	문자의 사운드 파일(. WAV 또는 입니다. 음성 출력에 대한 LWV)

bszName

애니메이션 또는 상태의 이름입니다.

애니메이션 이름은 Microsoft 에이전트 문자 편집기를 사용하여 저장한 문자에 대해 정의된 를 기반으로 합니다.

상태의 경우 값은 다음 중 하나일 수 있습니다.

	Description
"몸짓"	모든 Gesturing 상태 애니메이션을 검색합니다.
"GesturingDown"	GesturingDown 애니메이션을 검색하려면
"GesturingLeft"	GesturingLeft 애니메이션을 검색하려면
"GesturingRight"	GesturingRight 애니메이션을 검색하려면
"GesturingUp"	GesturingUp 애니메이션을 검색하려면
"숨기기"	숨기기 상태 애니메이션을 검색하려면
"청각"	청각 상태 애니메이션을 검색합니다.
"유휴 상태"	모든 유휴 상태 애니메이션을 검색하려면
"IdlingLevel1"	모든 IdlingLevel1 애니메이션을 검색하려면
"IdlingLevel2"	모든 IdlingLevel2 애니메이션을 검색하려면
"IdlingLevel3"	모든 IdlingLevel3 애니메이션을 검색하려면
"듣기"	수신 대기 상태 애니메이션을 검색합니다.
"이동 중"	모든 이동 상태 애니메이션을 검색합니다.
"MovingDown"	모든 이동 애니메이션을 검색합니다.
"MovingLeft"	모든 MovingLeft 애니메이션을 검색합니다.
"MovingRight"	모든 MovingRight 애니메이션을 검색하려면
"MovingUp"	모든 MovingUp 애니메이션을 검색하려면
"표시 중"	상태 표시 애니메이션을 검색하려면
"말하기"	말하기 상태 애니메이션을 검색하려면

의 경우 WAV 파일은 bszName 을 의 URL 또는 파일 사양으로 설정합니다. WAV 파일. 사양이 완료되지 않은 경우 Load 메서드에 사용된 사양을 기준으로 해석됩니다.

bQueue

서버가 준비 요청을 큐에 대기하는지 여부를 지정하는 부울입니다. True 이면 요청이 큐에 대기하고 그 뒤에 있는 모든 애니메이션 요청이 지정한 애니메이션 데이터가 로드될 때까지 기다립니다. False 이면 애니메이션 데이터가 비동기적으로 검색됩니다.

pdwReqID

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

HTTP 프로토콜()을 사용하여 문자를 로드하는 경우 ACF 파일) 애니메이션을 재생하려면 먼저 Prepare 메서드를 사용하여 애니메이션 데이터를 검색해야 합니다. UNC 프로토콜()을 사용하여 문자를 로드한 경우에는 이 메서드를 사용할 수 없습니다. ACS 파일). UNC 프로토콜()을 사용하여 해당 문자를 로드한 경우 Prepare 를 사용하여 문자에 대한 HTTP 데이터를 검색할 수도 없습니다. ACS 문자 파일).

Prepare 메서드를 사용하여 검색된 애니메이션 또는 사운드 데이터는 브라우저의 캐시에 저장됩니다. 후속 호출은 캐시를 검사 애니메이션 데이터가 이미 있는 경우 컨트롤은 캐시에서 직접 데이터를 로드합니다. 로드되면 Play 또는 Speak 메서드를 사용하여 애니메이션 또는 사운드 데이터를 재생할 수 있습니다.

여러 애니메이션 및 상태를 쉼표로 구분하여 지정할 수 있습니다. 그러나 동일한 Prepare 문에는 형식을 혼합할 수 없습니다.