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