| Package | flash.profiler |
| Classe | public final class Telemetry |
| Héritage | Telemetry  Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11.4, AIR 3.4 |
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| connected : Boolean [statique] [lecture seule]
Indique si Telemetry est connecté à un serveur
| Telemetry | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| spanMarker : Number [statique] [lecture seule]
Renvoie un marqueur en vue de l’utiliser avec Telemetry.sendSpanMetric.
| Telemetry | ||
| Méthode | Défini par | ||
|---|---|---|---|
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
[statique]
Enregistre une fonction pouvant être appelée en envoyant une commande sur un socket. Renvoie true si l’enregistrement aboutit. | Telemetry | ||
[statique]
Sollicite auprès de Telemetry une mesure personnalisée. | Telemetry | ||
[statique]
Sollicite auprès de Telemetry une plage de mesures personnalisée. Utilisez Telemetry.spanMarker pour obtenir un marqueur au début de la fonction à profiler et appelez Telemetry.sendSpanMetric à la fin de la fonction avec le marqueur. | Telemetry | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
[statique] | Telemetry | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
connected | propriété |
spanMarker | propriété |
registerCommandHandler | () | méthode |
public static function registerCommandHandler(commandName:String, handler:Function):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11.4, AIR 3.4 |
Enregistre une fonction qui peut être appelée en exécutant une commande sur un socket.
Renvoie la valeur true si l’enregistrement réussit. Si l’enregistrement échoue, il existe déjà un gestionnaire enregistré pour la commande utilisée (ou le nom de la commande, qui est réservé à l’usage interne du lecteur, commence par « . »). Il est possible d’annuler l’enregistrement des gestionnaires déjà enregistrés en utilisant unregisterCommandHandler avant d’enregistrer un autre gestionnaire.
La valeur de renvoi de la fonction du gestionnaire est envoyée comme résultat de la commande (tlm-response.result). La fonction du gestionnaire peut renvoyer une erreur, si elle souhaite envoyer une réponse d’erreur. Dans ce cas,Error.message et Error.id seraient envoyés comme tlm-response.tlm-error.message et tlm-response.tlm-error.code, respectivement. (tlm-response.result et tlm-response.tlm-error.data sont envoyés comme null)
Paramètres
commandName:String — Chaîne spécifiant un nom unique (la commande sur le socket doit spécifier cette chaîne comme nom de la méthode). Il est conseillé de suivre la notation DNS inverse, qui permet d’éviter les collisions d’espaces de noms. Par ailleurs, et les noms commençant par . réservés à une utilisation native.
| |
handler:Function — Fonction à appeler lors de la réception d’une commande provenant de Telemetry sur le socket avec le nom de la méthode, tel que spécifié dans l’argument functionId. Le gestionnaire doit accepter un seul argument de type Array (comme défini par tlm-method.params dans le protocole Telemetry), qui doit être envoyé par le serveur Telemetry avec le nom de la méthode.
|
Boolean |
sendMetric | () | méthode |
public static function sendMetric(metric:String, value:*):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11.4, AIR 3.4 |
Sollicite auprès de Telemetry une mesure personnalisée. Le nom et l’objet de la mesure sont envoyés selon le format du protocole Telemetry.
Pour les espaces de noms de mesure personnalisés, il est conseillé de suivre la notation DNS inverse, qui permet d’éviter les collisions d’espaces de noms.
Paramètres
metric:String — Nom de la mesure
| |
value:* — Toute valeur ou tout objet primitif contenant les détails de la mesure
|
Valeur émise
ArgumentError — Si la mesure utilise des espaces de noms réservés, tels que l’espace de noms natif flash (c’est-à-dire, si le nom de la mesure commence par « . »)
|
sendSpanMetric | () | méthode |
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11.4, AIR 3.4 |
Sollicite auprès de Telemetry une plage de mesures personnalisée.
Utilisez Telemetry.spanMarker pour obtenir un marqueur au début de la fonction à profiler et appelez Telemetry.sendSpanMetric à la fin de la fonction avec le marqueur. Telemetry envoie le nom, le marqueur de début et la durée de la fonction, ainsi que la valeur facultative conformément au protocole Telemetry.
Pour les espaces de noms de mesure personnalisés, il est conseillé de suivre la notation DNS inverse, qui permet d’éviter les collisions d’espaces de noms.
Une plage de mesures pour des durées inférieures à un seuil spécifique, qui pourrait être contrôlée à partir du serveur Telemetry via le protocole Telemetry, serait ignorée par Telemetry (ne sera pas envoyée au serveur Telemetry).
Paramètres
metric:String — Nom de la mesure
| |
startSpanMarker:Number — Marqueur de début.
| |
value:* (default = null) |
Valeur émise
ArgumentError — Si la mesure fait appel à des espaces de noms réservés tels que l’espace de noms natif de flash (c’est-à-dire si le nom de la mesure commence par « . »)
|
Eléments de l’API associés
unregisterCommandHandler | () | méthode |
Tue Jun 12 2018, 09:30 AM Z