다음을 통해 공유


Get 메서드

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

설명

지정된 문자에 대해 지정된 애니메이션 데이터를 검색합니다.

Syntax

agent**. 문자("CharacterID"). Get** 형식, 이름, []

요소 설명
Type 필수입니다. 로드할 애니메이션 데이터 형식을 나타내는 문자열 값입니다. "애니메이션" 문자의 애니메이션 데이터입니다.
"상태" 문자의 상태 데이터입니다.
"WaveFile" 문자의 오디오(음성 출력용) 파일입니다.
이름 필수입니다. 애니메이션 형식의 이름을 나타내는 문자열입니다. "name" 애니메이션 또는 상태의 이름입니다.
애니메이션의 경우 이름은 Microsoft 에이전트 문자 편집기를 사용하여 저장할 때 문자에 대해 정의된 이름을 기반으로 합니다.
상태의 경우 다음 값을 사용할 수 있습니다.
"제스처" 모든 제스처 상태 애니메이션을 가져옵니다.
"GesturingDown" GesturingDown 애니메이션을 가져옵니다.
"GesturingLeft" GesturingLeft 애니메이션을 가져옵니다.
"GesturingRight" GesturingRight 애니메이션을 가져옵니다.
"GesturingUp" GesturingUp 애니메이션을 가져옵니다.
"숨기기" 상태 애니메이션을 가져옵니다.
"청각" 청각 상태 애니메이션을 가져옵니다.
"유휴" 모든 유휴 상태 애니메이션을 가져옵니다.
"IdlingLevel1" 모든 IdlingLevel1 애니메이션을 가져오려면
"IdlingLevel2" 모든 IdlingLevel2 애니메이션을 가져오려면
"IdlingLevel3" 모든 IdlingLevel3 애니메이션을 가져오려면
"수신 대기" 수신 상태 애니메이션을 가져옵니다.
"이동" 모든 이동 상태 애니메이션을 가져옵니다.
"MovingDown" MovingDown 애니메이션을 가져옵니다.
"MovingLeft" MovingLeft 애니메이션을 가져옵니다.
"MovingRight" MovingRight 애니메이션을 가져옵니다.
"MovingUp" 이동 애니메이션가져옵니다.
"표시 중" 상태 표시 애니메이션을 가져옵니다.
"말하기" 말하기 상태 애니메이션을 가져옵니다.
여러 애니메이션과 상태를 쉼표로 구분하여 지정할 수 있습니다. 그러나 동일한 Get 문에서는 형식을 혼합할 수 없습니다.
"URL 또는 filespec" 소리에 대한 사양입니다(. WAV 또는 . LWV) 파일. 사양이 완료되지 않은 경우 Load 메서드에 사용된 사양을 기준으로 해석됩니다.
선택 사항. 서버가 Get 요청을 큐에 대기하는지 여부를 지정하는 부울 식입니다. True(기본값)는 Get 요청을 큐에 대기합니다. Get 요청(동일한 문자에 대한) 뒤에 있는 모든 애니메이션 요청은 애니메이션 데이터가 로드될 때까지 대기합니다.
False는 Get 요청을 큐에 대기하지 않습니다.

설명

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

개체 참조를 선언하고 이 메서드로 설정하면 Request 개체가 반환됩니다. 연결된 애니메이션이 로드되지 않으면 서버는 요청 개체의 Status 속성을 적절한 오류 번호로 "실패"로 설정합니다. RequestComplete 이벤트를 사용하여 상태를 확인하고 수행할 작업을 결정할 수 있습니다.

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

참고 항목

Load 메서드