設定載入 HTML 內容時所用的使用者代理程式

Adobe AIR 1.0 以及更新的版本

HTMLLoader 類別具有 userAgent 屬性,可以讓您設定 HTMLLoader 所用的使用者代理程式字串。請先設定 HTMLLoader 物件的 userAgent 屬性,然後再呼叫 load() 方法。如果您設定 HTMLLoader 實體的這項屬性,之後便「不會」使用傳遞至 load() 方法之 URLRequest 的 userAgent 屬性。

您可以藉由設定 URLRequestDefaults.userAgent 屬性,設定應用程式網域中所有 HTMLLoader 物件使用的預設使用者代理程式字串。對於所有 URLRequest 物件 (而非只有與 HTMLLoader 物件的 load() 方法搭配使用的 URLRequests),都會套用這些靜態 URLRequestDefaults 屬性做為預設值。如果設定 HTMLLoader 的 userAgent 屬性,便會覆寫預設的 URLRequestDefaults.userAgent 設定。

如果您未針對 HTMLLoader 物件的 userAgent 屬性或 URLRequestDefaults.userAgent 設定使用者代理程式值,則會使用預設的 AIR 使用者代理程式值。這個預設值會根據執行階段作業系統 (如 Mac OS 或 Windows)、執行階段語言和執行階段版本而有所不同,如下列兩個範例所示:

  • "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"

  • "Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"