Pakiet | flash.events |
Klasa | public class ThrottleEvent |
Dziedziczenie | ThrottleEvent Event Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE
.
Jest to zdarzenie typu broadcast, co oznacza, że jest wywoływane przez wszystkie obiekty EventDispatcher, których detektory są zarejestrowane dla tego zdarzenia. Więcej informacji o zdarzeniach broadcast zawiera opis klasy DisplayObject.
Uwaga: to zdarzenie nie zawiera fazy „przechwytywania” ani „propagacji”, co oznacza, że detektory zdarzeń muszą być dodawane bezpośrednio do każdego potencjalnego obiektu docelowego, niezależnie od tego, czy obiekt znajduje się na liście wyświetlania.
Program Flash Player może zmniejszyć przepustowość przez obniżenie liczby klatek na sekundę (zazwyczaj do wartości z zakresu od 2 do 8 kl./s). Przepustowość odtwarzania zawartości może zostać zmniejszona po ukryciu lub zminimalizowaniu karty z tą zawartością. W przypadku urządzenia przenośnego przepustowość odtwarzania zawartości może zostać zmniejszona po wyłączeniu podświetlenia lub włączeniu wygaszacza ekranu. Przed zmniejszeniem przepustowości odtwarzania zawartości jest wywoływane zdarzenie ThrottleEvent o właściwości ThrottleEvent.state=ThrottleType.THROTTLE
. Właściwość ThrottleEvent.targetFrameRate
zawiera wartość nowej docelowej szybkości odtwarzania.
Zawartość może uruchomić kod w detektorze zdarzeń w celu przygotowania się do zmniejszenia przepustowości odtwarzania. Stwarza to możliwość powiadomienia zawartości zewnętrznej o dłuższym czasie odpowiedzi zawartości, której przepustowość odtwarzania zostanie zmniejszona. Można na przykład anulować aktywną metodę FileReference.upload()
lub FileReference.download()
. Jeśli zawartość komunikuje się za pośrednictwem klasy LocalConnection z innym plikiem SWF, możliwe jest poinformowanie tego pliku o dłuższym czasie odpowiedzi tej zawartości. Zakończenie przez zawartość operacji asynchronicznych przed zmniejszeniem przepustowości jej odtwarzania może być niemożliwe. Przepustowość odtwarzania zawartości jest zmniejszana w momencie zakończenia działania detektora zdarzeń.
Odtwarzanie zawartości w programie Flash Player może zostać wstrzymane. Odtwarzanie zawartości można wstrzymać na przykład wtedy, gdy zawartość zostanie przewinięta poza obszar wyświetlany na ekranie podczas odtwarzania dźwięku lub wideo. Przed wstrzymywaniem odtwarzania zawartości zostanie wywołane zdarzenie ThrottleEvent o właściwościach ThrottleEvent.state=ThrottleType.PAUSE
i ThrottleEvent.targetFrameRate=0
. Podobnie, jak w przypadku wywołania zdarzenia ThrottleType.THROTTLE
, zawartość może uruchomić kod w detektorze zdarzeń w celu przygotowania się do wstrzymania. Po zakończeniu działania detektora zdarzeń następuje wstrzymanie odtwarzania zawartości. Wstrzymana zawartość nie reaguje na działania użytkownika, takie jak klikanie czy naciskanie klawiszy. Nadal są jednak odbierane zdarzenia sieciowe ActionScript.
Kiedy program Flash Player wznawia odtwarzanie zawartości po wstrzymaniu lub zmniejszeniu przepustowości, jest wywoływane zdarzenie ThrottleEvent o wartości ThrottleEvent.state=ThrottleType.RESUME.
Właściwość ThrottleEvent.targetFrameRate
określa szybkość odtwarzania i w normalnej sytuacji ma wartość taką samą jak właściwość Stage.frameRate
. Odtwarzanie zawartości może zostać wznowione, kiedy jakakolwiek część stołu montażowego stanie się widoczna na ekranie lub użytkownik zażąda wznowienia odtwarzania zawartości.
Platformy obecnie obsługujące zmniejszanie przepustowości i wstrzymywanie odtwarzania: program Flash Player dla komputerów Mac i z systemem Windows, środowisko AIR dla urządzeń przenośnych i program Flash Player dla systemu Android. Następujące platformy nie wywołują zdarzenia ThrottleEvent automatycznie, ponieważ nie obsługują obecnie wstrzymywania lub zmiany przepustowości: środowisko AIR dla urządzeń telewizyjnych, środowisko AIR dla komputerów oraz program Flash Player dla komputerów z systemem Linux.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | ||
cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | ||
eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | ||
state : String [tylko do odczytu]
Opisuje stan, do którego przechodzi odtwarzacz: ThrottleType.THROTTLE, ThrottleType.PAUSE lub ThrottleType.RESUME. | ThrottleEvent | ||
target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | ||
targetFrameRate : Number [tylko do odczytu]
Szybkość odtwarzania, jaką próbuje uzyskać program Flash Player lub środowisko AIR po wywołaniu zdarzenia ThrottleEvent. | ThrottleEvent | ||
type : String [tylko do odczytu]
Typ zdarzenia. | Event |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Tworzy obiekt Event zawierający informacje o klasie ThrottleEvent. | ThrottleEvent | ||
[przesłanianie]
Tworzy kopię obiektu ThrottleEvent i ustawia wartości wszystkich właściwości zgodnie z wartościami oryginalnego obiektu. | ThrottleEvent | ||
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
[przesłanianie]
Zwraca ciąg zawierający wszystkie właściwości obiektu ThrottleEvent. | ThrottleEvent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
THROTTLE : String = "throttle" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia ThrottleEvent. | ThrottleEvent |
state | właściwość |
state:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Opisuje stan, do którego przechodzi odtwarzacz: ThrottleType.THROTTLE
, ThrottleType.PAUSE
lub ThrottleType.RESUME
.
Implementacja
public function get state():String
Powiązane elementy interfejsu API
targetFrameRate | właściwość |
targetFrameRate:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Szybkość odtwarzania, jaką próbuje uzyskać program Flash Player lub środowisko AIR po wywołaniu zdarzenia ThrottleEvent.
Jeśli na przykład odtwarzanie zawartości zostało wstrzymane, właściwość targetFrameRate
ma wartość 0. Jeśli przepustowość odtwarzania zawartości została zmniejszona, właściwość targetFrameRate
przyjmuje zwykle wartość z zakresu od 2 do 8. Zależy to od platformy, na której została uruchomiona zawartość, odtwarzania dźwięku oraz innych czynników. Jeśli po wstrzymaniu lub zmniejszeniu przepustowości odtwarzania zawartości szybkość odtwarzania zostanie przywrócona do oczekiwanego poziomu, właściwość targetFrameRate
będzie miała taką samą wartość jak właściwość Stage.frameRate
.
Implementacja
public function get targetFrameRate():Number
Powiązane elementy interfejsu API
ThrottleEvent | () | Konstruktor |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Tworzy obiekt Event zawierający informacje o klasie ThrottleEvent. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type . Istnieje tylko jeden typ zdarzenia ThrottleEvent: ThrottleEvent.THROTTLE .
| |
bubbles:Boolean (default = false ) — Określa, czy obiekt Event uczestniczy w etapie propagacji przepływu zdarzeń. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości bubbles .
| |
cancelable:Boolean (default = false ) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable .
| |
state:String (default = null ) — ThrottleType.THROTTLE , ThrottleType.PAUSE lub ThrottleType.RESUME .
| |
targetFrameRate:Number (default = 0 ) — Opisuje docelową szybkość odtwarzania w programie Flash Player lub środowisku AIR po wywołaniu zdarzenia ThrottleEvent. Jeśli na przykład odtwarzanie zawartości zostało wstrzymane, właściwość targetFrameRate ma wartość 0. Jeśli przepustowość odtwarzania zawartości została zmniejszona, właściwość targetFrameRate przyjmuje zwykle wartość z zakresu od 2 do 8. Zależy to od platformy, na której została uruchomiona zawartość, odtwarzania dźwięku oraz innych czynników. Jeśli po wstrzymaniu lub zmniejszeniu przepustowości odtwarzania zawartości szybkość odtwarzania zostanie przywrócona do oczekiwanego poziomu, właściwość targetFrameRate będzie miała taką samą wartość jak właściwość Stage.frameRate .
|
Powiązane elementy interfejsu API
clone | () | metoda |
override public function clone():Event
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Tworzy kopię obiektu ThrottleEvent i ustawia wartości wszystkich właściwości zgodnie z wartościami oryginalnego obiektu.
ZwracaEvent — Nowy obiekt ThrottleEvent z wartościami właściwości odpowiadającymi wartościom oryginalnego obiektu.
|
toString | () | metoda |
override public function toString():String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Zwraca ciąg zawierający wszystkie właściwości obiektu ThrottleEvent. Format ciągu znaków jest następujący:
[ThrottleEvent type=wartosc bubbles=wartosc cancelable=wartosc state=wartosc targetFrameRate=wartosc]
String — Ciąg zawierający wszystkie właściwości obiektu ThrottleEvent.
|
THROTTLE | Stała |
public static const THROTTLE:String = "throttle"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.2 |
Definiuje wartość właściwości type
obiektu zdarzenia ThrottleEvent
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Dowolne wystąpienie klasy DisplayObject z detektorem zarejestrowanym dla zdarzenia zmniejszenia przepustowości odtwarzania. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE lub ThrottleType.RESUME. |
targetFrameRate | Opisuje docelową szybkość odtwarzania w programie Flash Player lub środowisku AIR po wygenerowaniu zdarzenia ThrottleEvent. Jeśli na przykład odtwarzanie zawartości zostało wstrzymane, właściwość targetFrameRate będzie miała wartość 0. Jeśli przepustowość odtwarzania zawartości została zmniejszona, właściwość targetFrameRate przyjmuje zwykle wartość z zakresu od 2 do 8. Zależy to od platformy, na której uruchomiona została zawartość, odtwarzania dźwięku oraz innych czynników. Jeśli po wstrzymaniu lub zmniejszeniu przepustowości odtwarzania zawartości szybkość odtwarzania zostanie przywrócona do oczekiwanego poziomu, właściwość targetFrameRate będzie miała taką samą wartość jak właściwość Stage.frameRate. |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z