Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flash.profiler 

Telemetry  - AS3

Pacchettoflash.profiler
Classepublic final class Telemetry
EreditarietàTelemetry Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.4, AIR 3.4

La classe Telemetry definisce un codice ActionScript del profilo dell’applicazione e registra dei gestori per i comandi



Proprietà pubbliche
 ProprietàDefinito da
  connected : Boolean
[statico] [sola lettura] Indica se Telemetry è connesso a un server.
Telemetry
 Inheritedconstructor : 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
Metodi pubblici
 MetodoDefinito da
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
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
  
sendMetric(metric:String, value:*):void
[statico] Richiede una metrica personalizzata da Telemetry.
Telemetry
  
sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void
[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
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
  
[statico]
Telemetry
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà

connected

proprietà
connected:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.4, AIR 3.4

Indica se Telemetry è connesso a un server.



Implementazione
    public static function get connected():Boolean

spanMarker

proprietà 
spanMarker:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.4, AIR 3.4

Restituisce un marcatore da utilizzare con Telemetry.sendSpanMetric.



Implementazione
    public static function get spanMarker():Number

Elementi API correlati

Descrizione dei metodi

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.

Restituisce
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 
public static function unregisterCommandHandler(commandName:String):Boolean

Parametri

commandName:String

Restituisce
Boolean




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.