SocketMonitor

套件	air.net
類別	public class SocketMonitor
繼承	SocketMonitor ServiceMonitor EventDispatcher Object
子類別	SecureSocketMonitor

執行階段版本:

AIR 1.0

SocketMonitor 物件會監視 TCP 端點的可用性。

此類別已包含在 aircore.swc 檔案中。當您針對 AIR 建立專案時，Flash Builder 會自動載入此類別。Flex SDK 也會包含此 aircore.swc 檔案。如果您是使用 Flex SDK，則編譯應用程式時就應該包含此檔案。

在 Adobe^® Flash^® Professional CS3 中，這個類別包含在 ServiceMonitorShim.swc 檔案中。若要使用 air.net 套件中的類別，您必須先從「組件」面板將 ServiceMonitorShim 組件拖曳到「元件庫」中，再將下列 import 陳述式加入 ActionScript 3.0 程式碼：

import air.net.*;

若要在 Adobe^® Flash^® Professional (CS4 或更新的版本) 中使用 air.net 套件：

選取「檔案 > 發佈設定」命令。
在 Flash 面板中，按一下 ActionScript 3.0 的「設定」按鈕，然後選取「元件庫路徑」。
按一下「瀏覽至 SWC 檔案」按鈕。瀏覽至 Adobe Flash Professional 安裝資料夾中的 Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc 檔案。
按一下「確定」按鈕。
將下列 import 陳述式加入您的 ActionScript 3.0 程式碼：import air.net.*;

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		available : Boolean 無論服務目前是否視為「可用」。除非狀態檢查將該屬性設定為 true 或該屬性已明確初始化為 true，否則初始值都是 false。一般來說，這個屬性是由子類別中的 checkStatus() 實作或專門物件所設定，但是假如應用程式具有服務可用性的相關獨立資訊 (例如，剛才成功或失敗的要求)，則可以明確設定屬性。	ServiceMonitor
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		host : String [唯讀] 受監視的主機。	SocketMonitor
		lastStatusUpdate : Date [唯讀] 最後一次狀態更新時間。	ServiceMonitor
		pollInterval : Number 輪詢伺服器的間隔 (單位為毫秒)。	ServiceMonitor
		port : int [唯讀] 受監視的通訊埠。	SocketMonitor
		running : Boolean [唯讀] 無論監視器是否已啟動。	ServiceMonitor

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		SocketMonitor(host:String, port:int) 針對指定的 TCP 端點建立 SocketMonitor 物件。	SocketMonitor
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		makeJavascriptSubclass(constructorFunction:Object):void [靜態] 將公用 ServiceMonitor 方法加入 JavaScript 建構函數的原型。	ServiceMonitor
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		start():void 啟動服務監視器。	ServiceMonitor
		stop():void 停止監視服務。	ServiceMonitor
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] 會傳回指定之物件的字串形式。	SocketMonitor
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

保護方法

	方法		定義自
		checkStatus():void [覆寫] 呼叫 SocketMonitor 物件的 checkStatus() 方法會導致應用程式嘗試連線至通訊端，以檢查是否有 connect 事件。	SocketMonitor
		createSocket():Socket 會建立 Socket 物件。	SocketMonitor

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
status	指出服務狀態已變更。	ServiceMonitor

屬性詳細資訊

host

屬性

host:String [唯讀]

執行階段版本:

AIR 1.0

受監視的主機。

實作
public function get host():String

port

屬性

port:int [唯讀]

執行階段版本:

AIR 1.0

受監視的通訊埠。

實作
public function get port():int

建構函式詳細資料

()

建構函式

public function SocketMonitor(host:String, port:int)

執行階段版本:

AIR 1.0

針對指定的 TCP 端點建立 SocketMonitor 物件。

建立 SocketMonitor 之後，呼叫端應該呼叫 start，開始監視服務的狀態。

和 Timer 物件一樣，呼叫端應該維護 SocketMonitor 物件的參考。否則，執行階段會刪除該物件和監視端。

參數

	`host:String` — 要監視的主機。

	`port:int` — 要監視的通訊埠。

方法詳細資訊

checkStatus

()

方法

override protected function checkStatus():void

執行階段版本:

AIR 1.0

呼叫 SocketMonitor 物件的 checkStatus() 方法會導致應用程式嘗試連線至通訊端，以檢查是否有 connect 事件。

createSocket

()

方法

protected function createSocket():Socket

執行階段版本:

AIR 1.0

會建立 Socket 物件。

傳回值

Socket — ：此 SocketMonitor 所使用的 Socket 物件。

toString

()

方法

override public function toString():String

執行階段版本:

AIR 1.0

會傳回指定之物件的字串形式。

注意： Object 類別的方法會在 Object 的原型上動態建立。若要重新定義 Object 之子類別中的這個方法，請勿使用 override 關鍵字。例如，Object 的子類別會實作 function toString():String，而非使用基底類別的覆寫。

傳回值

String — 物件的字串形式。

法律聲明 | 線上隱私權政策

SocketMonitor - AS3

類別 x

host

port

SocketMonitor

checkStatus

createSocket

toString