Play 메서드(레거시 Windows 환경 기능)

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

Description

지정된 문자에 대해 지정된 애니메이션을 재생합니다.

Syntax

agent**. 문자("CharacterID"). Play** "AnimationName"

부분	Description
AnimationName	필수 사항입니다. 애니메이션 시퀀스의 이름을 지정하는 문자열입니다.

 

설명

애니메이션의 이름은 문자가 Microsoft 에이전트 문자 편집기를 사용하여 컴파일될 때 정의됩니다. 지정된 애니메이션을 재생하기 전에 서버는 이전 애니메이션에 대한 반환 애니메이션(할당된 경우)을 재생하려고 시도합니다.

기존 파일 프로토콜을 사용하여 캐릭터의 애니메이션에 액세스할 때 애니메이션 이름을 지정하는 Play 메서드를 사용하면 됩니다. 그러나 HTTP 프로토콜을 사용하여 문자 애니메이션 데이터에 액세스하는 경우 Play 메서드를 호출하기 전에 Get 메서드를 사용하여 애니메이션을 로드합니다.

자세한 내용은 Get 메서드를 참조하세요.

구문을 단순화하기 위해 개체 참조를 선언하고 Characters 컬렉션의 Character 개체를 참조하도록 설정하고 Play 문의 일부로 참조를 사용할 수 있습니다.

   Dim Genie   
   Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"

   Set Genie = Agent1.Characters ("Genie")
   
   Genie.Get "state", "Showing"
   Genie.Show

   Genie.Get "animation", "Greet, GreetReturn"
   Genie.Play "Greet"
   Genie.Speak "Hello."

개체 참조를 선언하고 이 메서드로 설정하면 Request 개체가 반환됩니다. 또한 로드되지 않은 애니메이션을 지정하거나 문자가 성공적으로 로드되지 않은 경우 서버는 Request 개체의 Status 속성을 적절한 오류 번호로 "실패"로 설정합니다. 그러나 애니메이션이 존재하지 않고 캐릭터의 데이터가 이미 성공적으로 로드된 경우 서버에서 오류가 발생합니다.

Play 메서드는 문자를 표시하지 않습니다. 문자가 표시되지 않으면 서버는 애니메이션을 보이지 않게 재생하고 Request 개체의 Status 속성을 설정합니다.