Get 方法

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

描述

擷取指定字元的指定動畫資料。

語法

agent**。字元 (「CharacterID」) 。Get** Type， Name， [Queue]

部分	描述
類型	必要。 字串值，表示要載入的動畫資料類型。 「動畫」字元的動畫資料。 「State」 字元的狀態資料。 「WaveFile」 語音輸出) 檔案的字元音訊 (。
名稱	必要。 表示動畫類型名稱的字串。 「name」 動畫或狀態的名稱。 對於動畫，名稱是以使用 Microsoft 代理程式字元編輯器儲存時為字元定義的名稱為基礎。 針對狀態，可以使用下列值： 「Gesturing」 取得所有 Gesturing 狀態動畫。 「GesturingDown」 取得 GesturingDown 動畫。 「GesturingLeft」 取得 GesturingLeft 動畫。 「GesturingRight」 取得 GesturingRight 動畫。 「GesturingUp」 取得 GesturingUp 動畫。 「隱藏」取得 隱藏 狀態動畫。 「聽覺」取得 聽覺 狀態動畫。 「Idling」取得所有 Idling 狀態動畫。 「IdlingLevel1」 取得所有 IdlingLevel1 動畫。 「IdlingLevel2」 取得所有 IdlingLevel2 動畫。 「IdlingLevel3」 取得所有 IdlingLevel3 動畫。 「接聽」取得 接聽 狀態動畫。 「移動」取得所有 移動 狀態動畫。 「MovingDown」 取得 MovingDown 動畫。 「MovingLeft」 取得 MovingLeft 動畫。 「MovingRight」 取得 MovingRight 動畫。 「MovingUp」 取得 MovingUp 動畫。 「顯示」取得 顯示 狀態動畫。 「說話」取得 說話 狀態動畫。 您可以使用逗號分隔多個動畫和狀態。 不過，您無法在相同的 Get 語句中混合類型。 「URL 或filespec」 音效的規格 (。WAV 或 。LWV) 檔案。 如果規格未完成，則會解譯為相對於 Load 方法中使用的規格。
佇列	選擇性。 布林運算式，指定伺服器是否將 Get 要求排入佇列。 True (預設) 佇列取得 要求。 任何遵循 取得 要求 (相同字元的動畫要求，) 會等到載入動畫資料為止。 假 不會將 Get 要求排入佇列。

備註

如果您使用 HTTP 通訊協定載入字元， (。ACF 檔案) ，您必須先使用 Get 方法來擷取動畫資料，才能播放動畫。 如果您使用 UNC 通訊協定載入字元，則不會使用此方法 (。ACS 檔案) 。 如果您使用 UNC 通訊協定載入該字元，則也無法使用 Get 擷取字元的 HTTP 資料 (。ACS 字元檔案) 。

如果您宣告物件參考，並將其設定為此方法，則會傳回 Request 物件。 如果相關聯的動畫無法載入，伺服器會將 Request 物件的 Status 屬性設定為「失敗」，並顯示適當的錯誤號碼。 您可以使用 RequestComplete 事件來檢查狀態，並判斷要採取的動作。

使用 Get 方法擷取的動畫或音效資料會儲存在瀏覽器的快取中。 後續的呼叫會檢查快取，如果動畫資料已經存在，控制項就會直接從快取載入資料。 載入之後，即可使用 Play 或 Speak 方法播放動畫或音效資料。

另請參閱

載入方法