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屬性。