Play 方法 (舊版 Windows 環境功能)

[Microsoft 代理程式在 Windows 7 中已被取代，且在後續版本的 Windows 中可能無法使用。]

描述

播放指定字元的指定動畫。

語法

agent**。字元 (「CharacterID」) 。Play** 「AnimationName」

部分	描述
AnimationName	必要。 指定動畫序列名稱的字串。

 

備註

使用 Microsoft 代理程式字元編輯器編譯字元時，會定義動畫的名稱。 在播放指定的動畫之前，如果已指派傳回動畫，伺服器會嘗試播放上一個動畫的 Return 動畫。

使用傳統檔案通訊協定存取字元的動畫時，您可以直接使用 Play 方法來指定動畫的名稱。 不過，如果您使用 HTTP 通訊協定來存取字元動畫資料，請先使用 Get 方法來載入動畫，再呼叫 Play 方法。

如需詳細資訊，請參閱 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屬性。