[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]
-
說明
-
擷取指定字元的指定動畫數據。
-
語法
-
agent**。字元 （“CharacterID” ）。Get** Type， Name， [Queue]
部分 描述 類型 必要。 字串值，表示要載入的動畫數據類型。 「動畫」字元的動畫數據。
“State” 字元的狀態數據。
“WaveFile” 字元的音訊 （適用於口語輸出） 檔案。名稱 必要。 字串，表示動畫類型的名稱。 “name” 動畫或狀態的名稱。
針對動畫，此名稱是以使用 Microsoft Agent 字元編輯器儲存時為字元定義的名稱為基礎。
針對狀態，可以使用下列值：
“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 要求排入佇列。 在 Get 要求之後的任何動畫要求（針對相同字元）會等到載入動畫數據為止。
False 不會將 Get 要求排入佇列。
備註
如果您使用 HTTP 通訊協定載入字元 （。ACF 檔案），您必須先使用 Get 方法來擷取動畫數據，才能播放動畫。 如果您使用 UNC 通訊協定載入字元，則不會使用這個方法（。ACS 檔案）。 如果您使用 UNC 通訊協定載入該字元，則也無法使用 Get 擷取字元的 HTTP 資料。ACS 字元檔案）。
如果您宣告對象參考，並將其設定為此方法，則會傳 回 Request 物件。 如果相關聯的動畫無法載入，伺服器會將 Request 物件的 Status 屬性設定為「失敗」，並顯示適當的錯誤號碼。 您可以使用 RequestComplete 事件來檢查狀態，並判斷要採取的動作。
使用 Get 方法擷取的動畫或音效數據會儲存在瀏覽器的快取中。 後續呼叫會檢查快取，如果動畫數據已經存在，控件會直接從快取載入數據。 載入之後，就可以使用 Play 或 Speak 方法播放動畫或音效數據。