ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.profiler 

Telemetry  - AS3

Paketflash.profiler
Klassepublic final class Telemetry
VererbungTelemetry Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Mit der Telemetrie-Klasse kann eine Anwendung ActionScript-Code profilieren und Prozeduren für Befehle registrieren.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  connected : Boolean
[statisch] [schreibgeschützt] Gibt an, ob die Telemetrie mit einem Server verbunden ist
Telemetry
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  spanMarker : Number
[statisch] [schreibgeschützt] Gibt eine Markierung zurück, die mit Telemetry.sendSpanMetric verwendet werden kann
Telemetry
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
[statisch] Registriert eine Funktion, die aufgerufen werden kann, indem Sie einen Befehl über ein Socket ausgeben. Gibt „true“ zurück, wenn die Registrierung erfolgreich ist.
Telemetry
  
sendMetric(metric:String, value:*):void
[statisch] Fordert eine benutzerdefinierte Metrik von der Telemetrie an.
Telemetry
  
sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void
[statisch] Fordert eine benutzerdefinierte Span-Metrik von der Telemetrie an. Verwenden Sie Telemetry.spanMarker, damit am Beginn der Funktion eine Markierung profiliert wird, und rufen Sie Telemetry.sendSpanMetric am Ende der Funktion mit der Markierung auf.
Telemetry
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
[statisch]
Telemetry
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

connected

Eigenschaft
connected:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Gibt an, ob die Telemetrie mit einem Server verbunden ist



Implementierung
    public static function get connected():Boolean

spanMarker

Eigenschaft 
spanMarker:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Gibt eine Markierung zurück, die mit Telemetry.sendSpanMetric verwendet werden kann



Implementierung
    public static function get spanMarker():Number

Verwandte API-Elemente

Methodendetails

registerCommandHandler

()Methode
public static function registerCommandHandler(commandName:String, handler:Function):Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Registrieren Sie eine Funktion, die durch die Ausgabe eines Befehls über ein Socket aufgerufen werden kann

Gibt „true“ zurück, wenn die Registrierung erfolgreich ist. Wenn die Registrierung fehlschlägt, gibt es bereits eine Prozedur, die für den verwendeten Befehl registriert wurde (oder der Befehlsname beginnt mit „.“, was für die interne Verwendung im Player reserviert ist). Die Registrierung bereits registrierter Prozeduren kann mit „unregisterCommandHandler“ aufgehoben werden, bevor eine andere Prozedur registriert wird.

Der Rückgabewert der Prozedurfunktion wird als Ergebnis des Befehls gesendet (tlm-response.result). Die Prozedurfunktion kann Error ausgeben, wenn eine Fehlerantwort gesendet werden soll. In diesem Fall werden Error.message und Error.id als tlm-response.tlm-error.message bzw. tlm-response.tlm-error.code gesendet. (tlm-response.result und tlm-response.tlm-error.data werden als null gesendet)

Parameter

commandName:String — String, der einen eindeutigen Namens angibt (Der Befehl über das Socket sollte diesen String als Methodenname angeben). Als Richtlinie sollte der umgekehrten DNS-Schreibung gefolgt werden, um Namespacekonflikte leichter zu vermeiden. Zusätzlich und Namen, die beginnen mit . beginnen, sind für die native Verwendung reserviert.
 
handler:Function — Funktion, die aufgerufen wird, wenn ein Befehl aus Telemetrie über das Socket mit dem Methodennamen empfangen wird, wie im functionId-Argument angegeben. Die Prozedur sollte nur ein Argument des Typs Array akzeptieren (wie durch tlm-method.params im Telemetrie-Protokoll definiert), das vom Telemetrieserver zusammen mit Methodennamen gesendet werden muss.

Rückgabewerte
Boolean

sendMetric

()Methode 
public static function sendMetric(metric:String, value:*):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Fordert eine benutzerdefinierte Metrik von der Telemetrie an. Der Name der Metrik und das Objekt werden gemäß dem Telemetrieprotokollformat gesendet.

Als Richtlinie für benutzerdefinierte Metrik-Namespaces sollte der umgekehrten DNS-Schreibung gefolgt werden, um Namespacekonflikte leichter zu vermeiden.

Parameter

metric:String — Name der Metrik
 
value:* — Ein beliebiges Wert/Objekt-Paar, das die Metrikdetails enthält


Auslöser
ArgumentError — Falls die Metrik reservierte Namespaces wie native Flash-Namespaces verwendet (z. B. wenn der Metrikname mit „.“ beginnt).

sendSpanMetric

()Methode 
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.4, AIR 3.4

Fordert eine benutzerdefinierte Span-Metrik von der Telemetrie an

Verwenden Sie Telemetry.spanMarker, damit am Beginn der Funktion eine Markierung profiliert wird, und rufen Sie Telemetry.sendSpanMetric am Ende der Funktion mit der Markierung auf. Die Telemetrie sendet den Namen, die Startmarkierung und die Dauer der Funktion sowie den optionalen Wert gemäß dem Telemetrieprotokoll.

Als Richtlinie für benutzerdefinierte Metrik-Namespaces sollte der umgekehrten DNS-Schreibung gefolgt werden, um Namespacekonflikte leichter zu vermeiden.

Span-Metriken mit einer Dauer unter einem festgelegten Schwellenwert, die mithilfe des Telemetrieprotokolls vom Telemetrieserver kontrolliert werden könnten, würden von der Telemetrie ignoriert (nicht an den Telemetrieserver gesendet).

Parameter

metric:String — Name der Metrik
 
startSpanMarker:Number — Startmarkierung.
 
value:* (default = null) — Optionaler Parameter. Ein beliebiges Wert/Objekt-Paar, das zusammen mit dem Namen, der Markierung und der Dauer gesendet wird


Auslöser
ArgumentError — Falls die Metrik reservierte Namespaces wie native Flash-Namespaces verwendet (z. B. wenn der Metrikname mit „.“ beginnt).

Verwandte API-Elemente

unregisterCommandHandler

()Methode 
public static function unregisterCommandHandler(commandName:String):Boolean

Parameter

commandName:String

Rückgabewerte
Boolean




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.