Pacchetto | flash.profiler |
Classe | public final class Telemetry |
Ereditarietà | Telemetry Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 11.4, AIR 3.4 |
Proprietà | Definito da | ||
---|---|---|---|
connected : Boolean [statico] [sola lettura]
Indica se Telemetry è connesso a un server.
| Telemetry | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
spanMarker : Number [statico] [sola lettura]
Restituisce un marcatore da utilizzare con Telemetry.sendSpanMetric.
| Telemetry |
Metodo | Definito da | ||
---|---|---|---|
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
[statico]
Registra una funzione che può essere chiamata inviando un comando tramite socket. Restituisce true se la registrazione ha esito positivo. | Telemetry | ||
[statico]
Richiede una metrica personalizzata da Telemetry. | Telemetry | ||
[statico]
Richiede una metrica di span personalizzata da Telemetry. Utilizzate Telemetry.spanMarker per inserire un marcatore all’inizio della funzione di cui eseguire il profilo e chiamate Telemetry.sendSpanMetric alla fine della funzione con il marcatore. | Telemetry | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
[statico] | Telemetry | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
connected | proprietà |
spanMarker | proprietà |
registerCommandHandler | () | metodo |
public static function registerCommandHandler(commandName:String, handler:Function):Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 11.4, AIR 3.4 |
Registra una funzione che può essere chiamata inviando un comando tramite socket.
Restituisce true se la registrazione ha esito positivo. Se la registrazione fallisce, è già presente un gestore registrato per il comando utilizzato (oppure il nome del comando inizia con “.”, che è riservato per l’uso interno del lettore). I gestori già registrati possono essere deregistrati utilizzando unregisterCommandHandler prima della registrazione di un altro gestore.
Il valore restituito dalla funzione gestore viene inviato come risultato del comando (tlm-response.result
). La funzione gestore può generare un errore allo scopo di inviare una risposta che segnala un errore. In questo caso, Error.message
e Error.id
vengono inviati rispettivamente come tlm-response.tlm-error.message
e tlm-response.tlm-error.code
. (tlm-response.result
e tlm-response.tlm-error.data
vengono inviati come null.)
Parametri
commandName:String — Stringa che specifica un nome univoco (il comando inviato tramite socket deve specificare questa stringa come nome del metodo). È consigliabile utilizzare la notazione DNS inversa allo scopo di evitare conflitti con gli spazi dei nomi. Inoltre, i nomi che iniziano con . sono riservati per l’uso nativo.
| |
handler:Function — Funzione da chiamare quando viene ricevuto un comando da Telemetry tramite il socket con il nome del metodo specificato nell’argomento functionId. Il gestore di argomenti deve accettare un solo argomento di tipo Array (così come definito da tlm-method.params nel protocollo Telemetry), che deve essere inviato dal server Telemetry insieme al nome del metodo.
|
Boolean |
sendMetric | () | metodo |
public static function sendMetric(metric:String, value:*):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 11.4, AIR 3.4 |
Richiede una metrica personalizzata da Telemetry. Il nome della metrica e l’oggetto vengono inviati in base al formato del protocollo Telemetry.
È consigliabile utilizzare la notazione DNS inversa allo scopo di evitare conflitti con gli spazi dei nomi.
Parametri
metric:String — Nome della metrica.
| |
value:* — Qualsiasi valore/oggetto primitivo contenente i dettagli della metrica.
|
Genera
ArgumentError — Generato se la metrica utilizza spazi dei nomi riservati come quelli nativi di Flash (ad esempio se il nome della metrica inizia con ’.’).
|
sendSpanMetric | () | metodo |
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 11.4, AIR 3.4 |
Richiede una metrica di span personalizzata da Telemetry.
Utilizzate Telemetry.spanMarker
per inserire un marcatore all’inizio della funzione di cui eseguire il profilo e chiamate sendSpanMetric
alla fine della funzione con il marcatore. Telemetry invia il nome, il marcatore iniziale e la durata della funzione, più il valore opzionale in base al protocollo Telemetry.
È consigliabile utilizzare la notazione DNS inversa allo scopo di evitare conflitti con gli spazi dei nomi.
Le metriche span relative a durate inferiori a una soglia specificata, che può essere controllata dal server Telemetry utilizzando il protocollo Telemetry, vengono ignorate da Telemetry (non vengono inviate al server Telemetry).
Parametri
metric:String — Nome della metrica.
| |
startSpanMarker:Number — Marcatore iniziale.
| |
value:* (default = null ) — Parametro opzionale. Qualsiasi valore/oggetto primitivo da inviare insieme a nome, marcatore e durata.
|
Genera
ArgumentError — Generato se la metrica utilizza spazi dei nomi riservati come quelli nativi di Flash (ovvero se il nome della metrica inizia con '.').
|
Elementi API correlati
unregisterCommandHandler | () | metodo |
Tue Jun 12 2018, 02:44 PM Z