| Pakiet | flash.profiler |
| Klasa | public final class Telemetry |
| Dziedziczenie | Telemetry  Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11.4, AIR 3.4 |
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| connected : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy oprogramowanie Telemetry jest połączone z serwerem
| Telemetry | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| spanMarker : Number [statyczny] [tylko do odczytu]
Zwraca marker do użycia z metodą Telemetry.sendSpanMetric
| Telemetry | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
[statyczny]
Rejestruje funkcję, która może zostać wywołana przez wydanie polecenia za pośrednictwem gniazda. Zwraca wartość true, jeśli rejestracja się powiedzie. | Telemetry | ||
[statyczny]
Żąda własnego pomiaru od funkcji Telemetry. | Telemetry | ||
[statyczny]
Żąda własnego pomiaru zakresu od funkcji Telemetry. Właściwość Telemetry.spanMarker pozwala uzyskać marker na początku profilowanej funkcji, tak aby na końcu funkcji z markerem wywołać metodę Telemetry.sendSpanMetric. | Telemetry | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
[statyczny] | Telemetry | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
connected | właściwość |
spanMarker | właściwość |
registerCommandHandler | () | metoda |
public static function registerCommandHandler(commandName:String, handler:Function):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11.4, AIR 3.4 |
Rejestruje funkcję, którą można wywołać, wydając polecenie przez gniazdo.
Zwraca wartość true w przypadku pomyślnej rejestracji. Niepowodzenie rejestracji oznacza, że jest już zarejestrowany moduł obsługi dla użytego polecenia (lub nazwa polecenia zaczyna się od kropki, czyli jest zarezerwowana do użytku wewnętrznego przez odtwarzacz). Zarejestrowany moduł obsługi można wyrejestrować za pomocą metody unregisterCommandHandler przed zarejestrowaniem innego modułu.
Wartość zwracana przez funkcję modułu obsługi jest wysyłana jako wynik polecenia (tlm-response.result). Funkcja modułu obsługi może generować wyjątki Error, aby wysłać odpowiedzi informujące o błędach. W takiej sytuacji wartości Error.message i Error.id są wysyłane odpowiednio jako elementy tlm-response.tlm-error.message i tlm-response.tlm-error.code. (Elementy tlm-response.result i tlm-response.tlm-error.data są wysyłane z wartością null).
Parametry
commandName:String — Ciąg określający niepowtarzalną nazwę. (Polecenie wydane przez gniazdo powinno określać ten ciąg jako nazwę metody). Zaleca się korzystanie z odwróconej notacji DNS, co pomaga uniknąć kolizji przestrzeni nazw. Dodatkowo nazwy rozpoczynające się od kropki (.) są zarezerwowane do użytku natywnie.
| |
handler:Function — Funkcja, która powinna zostać wywołana po otrzymaniu polecenia przez funkcję Telemetry za pośrednictwem gniazda, zawierająca nazwę metody zgodnie z definicją w argumencie functionId. Moduł obsługi powinien akceptować tylko jeden argument typu Array (zgodnie z definicją w tlm-method.params w protokole Telemetry), który musi zostać przesłany przez oprogramowanie Telemetry Server razem z nazwą metody.
|
Boolean |
sendMetric | () | metoda |
public static function sendMetric(metric:String, value:*):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11.4, AIR 3.4 |
Żąda własnego pomiaru od funkcji Telemetry. Nazwa i obiekt pomiaru są wysyłane zgodnie z formatem protokołu Telemetry.
W przypadku własnych przestrzeni nazw pomiarów zalecane jest stosowanie odwrotnej notacji DNS, co pomaga uniknąć kolizji przestrzeni nazw.
Parametry
metric:String — Nazwa pomiaru.
| |
value:* — Dowolna wartość pierwotna lub dowolny obiekt pierwotny ze szczegółami pomiaru.
|
Zgłasza
ArgumentError — Jeśli pomiar używa zarezerwowanej przestrzeni nazw, takiej jak natywna przestrzeń nazw oprogramowania Flash (gdy na przykład nazwa pomiaru zaczyna się od kropki).
|
sendSpanMetric | () | metoda |
public static function sendSpanMetric(metric:String, startSpanMarker:Number, value:* = null):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11.4, AIR 3.4 |
Żąda własnego pomiaru zakresu od funkcji Telemetry
Właściwość Telemetry.spanMarker pozwala uzyskać marker na początku profilowanej funkcji, tak aby na końcu funkcji z markerem wywołać metodę Telemetry.sendSpanMetric. Funkcja Telemetry wysyła nazwę, marker początkowy i czas trwania funkcji oraz wartość opcjonalną — zgodnie z protokołem Telemetry.
W przypadku własnych przestrzeni nazw pomiarów zalecane jest stosowanie odwrotnej notacji DNS, co pomaga uniknąć kolizji przestrzeni nazw.
Pomiary zakresów w przypadku czasu trwania krótszego niż określony próg, którymi może sterować oprogramowanie Telemetry Server przy użyciu protokołu Telemetry, są ignorowane przez oprogramowanie Telemetry (nie są wysyłane do oprogramowania Telemetry Server).
Parametry
metric:String — Nazwa pomiaru.
| |
startSpanMarker:Number — Uruchomienie znacznika.
| |
value:* (default = null) |
Zgłasza
ArgumentError — Jeśli pomiar używa zarezerwowanej przestrzeni nazw, na przykład natywnej przestrzeni nazw oprogramowania Flash (tzn. nazwa pomiaru zaczyna się od kropki).
|
Powiązane elementy interfejsu API
unregisterCommandHandler | () | metoda |
Tue Jun 12 2018, 12:06 PM Z