| 套件 | flash.net |
| 類別 | public class NetworkInfo |
| 繼承 | NetworkInfo  EventDispatcher Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 2 |
AIR 描述檔支援：所有桌上型電腦作業系統與 AIR for TV 裝置都支援此項功能，但所有行動裝置都不支援。您可以使用 NetworkInfo.isSupported 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。
NetworkInfo 物件為 Singleton。若要取得單一 NetworkInfo 物件，請使用靜態 NetworkInfo.networkInfo 屬性。不要呼叫類別建構函式 new NetworkInfo()。
大部份的電腦有一個或多個介面，例如有線及無線網路介面。額外的介面例如 VPN、迴路，或虛擬介面也可能存在。
當可用介面變更，NetworkInfo 物件會傳送 change 事件。呼叫 findInterfaces() 方法判斷最新的網路資訊。
注意： NativeApplication 物件也會傳送網路變更事件。
詳細資訊
相關 API 元素
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| isSupported : Boolean [靜態] [唯讀]
指出用戶端系統是否支援存取網路介面資訊。 | NetworkInfo | ||
| networkInfo : NetworkInfo [靜態] [唯讀]
NetworkInfo 物件的 Singleton 實體。 | NetworkInfo | ||
| permissionStatus : String [靜態] [唯讀]
判斷應用程式是否已獲得存取 NetworkInfo 的權限。 | NetworkInfo | ||
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
會將事件傳送到事件流程。 | EventDispatcher | |
傳回與這個電腦關聯的網路介面清單。 | NetworkInfo | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
事件
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
| [廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | ||
| [廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | ||
| 當網路介面已經變更時傳送。 | NetworkInfo | |||
屬性詳細資訊
isSupported | 屬性 |
networkInfo | 屬性 |
networkInfo:NetworkInfo [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 2 |
NetworkInfo 物件的 Singleton 實體。
實作
public static function get networkInfo():NetworkInfo擲回值
SecurityError — 如果在 AIR 應用程式之外執行內容，安全執行程序會存取此屬性。
|
permissionStatus | 屬性 |
方法詳細資訊
findInterfaces | () | 方法 |
public function findInterfaces():Vector.<NetworkInterface>| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 2 |
傳回與這個電腦關聯的網路介面清單。
傳回值Vector.<NetworkInterface> — NetworkInterface 物件陣列
|
事件詳細資訊
networkChange | 事件 |
事件物件類型:
屬性 Event.type =
flash.events.Event屬性 Event.type =
flash.events.Event.NETWORK_CHANGE| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 2 |
當網路介面已經變更時傳送。
Event.NETWORK_CHANGE 常數會定義 networkChange 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | NativeApplication 物件。 |
Tue Jun 12 2018, 03:47 PM Z