IAgentCharacter::P repare

아티클
07/04/2024

[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

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

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

bszName

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

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

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

	설명
"몸짓"	모든 제스처 상태 애니메이션을 검색합니다.
"GesturingDown"	GesturingDown 애니메이션을 검색하려면
"GesturingLeft"	GesturingLeft 애니메이션을 검색하려면
"GesturingRight"	GesturingRight 애니메이션을 검색하려면
"GesturingUp"	GesturingUp 애니메이션을 검색하려면
"숨기기"	숨기기 상태 애니메이션을 검색하려면
"청각"	청각 상태 애니메이션을 검색하려면
"Idling"	모든 유휴 상태 애니메이션을 검색하려면
"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 문에서는 형식을 혼합할 수 없습니다.

다음을 통해 공유

IAgentCharacter::P repare

피드백

추가 리소스