| 套件 | flash.profiler |
| 類別 | public final class Telemetry |
| 繼承 | Telemetry  Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11.4, AIR 3.4 |
公用屬性
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| connected : Boolean [靜態] [唯讀]
指出遙測是否已連接到伺服器
| Telemetry | ||
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| spanMarker : Number [靜態] [唯讀]
傳回標記，以便與 Telemetry.sendSpanMetric 搭配使用
| Telemetry | ||
公用方法
| 方法 | 定義自 | ||
|---|---|---|---|
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
[靜態]
註冊函數，以便經由通訊端發出命令加以呼叫。如果註冊成功，則會傳回 true。 | Telemetry | ||
[靜態]
要求遙測中的自訂公制。 | Telemetry | ||
[靜態]
要求遙測中的自訂範圍公制。使用 Telemetry.spanMarker 可以取得位於要剖析之函數開頭的標記，並使用標記在函數結尾呼叫 Telemetry.sendSpanMetric。 | Telemetry | ||
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
[靜態] | Telemetry | ||
|
會傳回指定之物件的基本值。 | Object | |
屬性詳細資訊
connected | 屬性 |
spanMarker | 屬性 |
方法詳細資訊
registerCommandHandler | () | 方法 |
public static function registerCommandHandler(commandName:String, handler:Function):Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11.4, AIR 3.4 |
註冊函數，以便經由通訊端發出命令加以呼叫
如果註冊成功，則會傳回 true。如果註冊失敗，表示已經有處理常式註冊所使用的命令 (或者命令名稱以 '.' 開頭，以保留供播放程式內部使用)。在註冊其他處理常式之前，請使用 unregisterCommandHandler 將已註冊的處理常式取消註冊。
處理常式函數的傳回值是以命令的結果 (tlm-response.result) 形式傳回。處理常式函數若要傳送錯誤回應，則會擲回 Error。在這種情況下，Error.message 及 Error.id 會個別以 tlm-response.tlm-error.message 和 tlm-response.tlm-error.code 來傳送 (tlm-response.result 和 tlm-response.tlm-error.data 是以 null 傳送)。
參數
commandName:String — 指定唯一名稱的字串 (經由通訊端的命令應將這個字串指定為方法名稱)。原則是遵循反轉 DNS 標記法，以便有助於避免發生命名空間衝突。此外，保留以 . 為開頭的名稱，做為原生之用。
| |
handler:Function — 遙測使用如 functionId 引數中所指定的方法名稱，經由通訊端接收命令時要呼叫的函數。處理常式應只接受 Array 類型的一個引數 (如遙測通訊協定中的 tlm-method.params 所定義)，該引數必須與方法名稱一同由遙測伺服器傳送。
|
Boolean |
sendMetric | () | 方法 |
public static function sendMetric(metric:String, value:*):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11.4, AIR 3.4 |
要求遙測中的自訂公制。公制名稱和物件會以每個遙測通訊協定格式來傳送。
自訂公制命名空間的原則是，遵循反轉 DNS 標記法，以便有助於避免發生命名空間衝突。
參數
metric:String — 公制名稱
| |
value:* — 任何包含公制詳細資料的基本值/物件
|
擲回值
ArgumentError — 公制使用保留的命名空間，如 Flash 原生命名空間 (例如，公制名稱以「.」開頭)
|
sendSpanMetric | () | 方法 |
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11.4, AIR 3.4 |
要求遙測中的自訂範圍公制
使用 Telemetry.spanMarker 可以取得位於要剖析之函數開頭的標記，並使用標記在函數結尾呼叫 Telemetry.sendSpanMetric。遙測會依照每個遙測通訊協定，傳送名稱、函數開始標記與持續時間，以及選擇性值。
自訂公制命名空間的原則是，遵循反轉 DNS 標記法，以便有助於避免發生命名空間衝突。
若持續時間的範圍公制少於指定的臨界值 (可使用遙測通訊協定從遙測伺服器加以控制)，將遭到遙測忽略 (不會傳送給遙測伺服器)。
參數
metric:String — 公制名稱
| |
startSpanMarker:Number — 開始標記。
| |
value:* (default = null) |
擲回值
ArgumentError — 公制使用保留的命名空間，如 Flash 原生命名空間 (例如，公制名稱以 '.' 開頭)
|
相關 API 元素
unregisterCommandHandler | () | 方法 |
Tue Jun 12 2018, 03:47 PM Z