Pakiet | flash.sensors |
Klasa | public class DeviceRotation |
Dziedziczenie | DeviceRotation EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Uwaga: właściwośćDeviceRotation.isSupported
umożliwia sprawdzenie, czy ta funkcja jest dostępna w bieżącym środowisku wykonawczym. Klasa obrotu urządzenia i należące do niej elementy są dostępne dla wielu platform środowisk wykonawczych i urządzeń, jednak nie oznacza to, że narzędzie obsługi jest zawsze obsługiwane w danym środowisku wykonawczym. W kilku przypadkach, takich jak wersja systemu Android itp. to narzędzie obsługi nie jest obsługiwane, w związku z tym obsługę takiego narzędzia należy sprawdzić za pomocą właściwości DeviceRotation.isSupported
. Jeśli w danym środowisku wykonawczym właściwość DeviceRotation.isSupported
ma wartośćtrue
, oznacza to, że klasa DeviceRotation jest obsługiwana.
Obsługa profilów AIR: Ta funkcja jest obsługiwana tylko na urządzeniach przenośnych. Nie jest obsługiwana na komputerach stacjonarnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
isSupported : Boolean [statyczny] [tylko do odczytu]
Właściwość isSupported ma wartość true, jeśli w urządzeniu dostępne są czujniki przyspieszeniomierza i żyroskopu; w przeciwnym razie ma wartość false. | DeviceRotation | ||
muted : Boolean [tylko do odczytu]
Określa, czy użytkownik zabronił dostępu do danych o obrocie urządzenia (true), czy zezwolił na dostęp (false). | DeviceRotation |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy nową instancję klasy DeviceRotation. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
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 | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Metoda setRequestedUpdateInterval służy do ustawiania żądanej częstotliwości uaktualnień. | DeviceRotation | ||
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 | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Zdarzenie wywoływane w przypadku zmiany statusu obrotu urządzenia. | DeviceRotation | |||
Zdarzenie update jest wywoływane w odpowiedzi na aktualizacje danych z połączonych odczytów czujników przyspieszeniomierza i żyroskopu, gdy urządzenie zostanie obrócone. | DeviceRotation |
isSupported | właściwość |
isSupported:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Właściwość isSupported
ma wartość true
, jeśli w urządzeniu dostępne są czujniki przyspieszeniomierza i żyroskopu; w przeciwnym razie ma wartość false
.
Implementacja
public static function get isSupported():Boolean
Przykład ( Sposób korzystania z tego przykładu )
var myTextField:TextField = new TextField(); myTextField.width = 200; addChild(myTextField); var deviceRotation = new DeviceRotation(); var isSupported:Boolean = DeviceRotation.isSupported; checksupport(); function checksupport():void { if (isSupported) { myTextField.text = "DeviceRotation feature supported"; deviceRotation.addEventListener(DeviceRotationEvent.UPDATE,deviceRotUpdateHandler); } else { myTextField.text = "DeviceRotation feature not supported"; } } function deviceRotUpdateHandler(evt:DeviceRotationEvent):void { myTextField.text = String("at: " + evt.timestamp + "\n" + "Roll: " + evt.roll + "\n" + "Yaw: " + evt.yaw + "\n" + "Pitch: " + evt.pitch); }
muted | właściwość |
muted:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Określa, czy użytkownik zabronił dostępu do danych o obrocie urządzenia (true
), czy zezwolił na dostęp (false
). Jeśli wartość ulegnie zmianie, wywołane zostanie zdarzenie status
.
Implementacja
public function get muted():Boolean
Powiązane elementy interfejsu API
DeviceRotation | () | Konstruktor |
public function DeviceRotation()
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Tworzy nową instancję klasy DeviceRotation.
setRequestedUpdateInterval | () | metoda |
public function setRequestedUpdateInterval(interval:Number):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Metoda setRequestedUpdateInterval
służy do ustawiania żądanej częstotliwości uaktualnień. Odstęp czasu jest mierzony w milisekundach. Odstęp między aktualizacjami jest jedynie wartością orientacyjną, której uwzględnienie ma na celu ograniczenie zużycia energii. Rzeczywisty odstęp czasu między uaktualnieniami wektora obrotu urządzenia może być większy lub mniejszy od tej wartości. Dowolna zmiana w odstępie między uaktualnieniami wpływa na wszystkie zarejestrowane detektory zdarzeń. Klasę DeviceRotation można użyć bez wywoływania metody setRequestedUpdateInterval()
. W tym przypadku aplikacja odbierze uaktualnienia na podstawie domyślnego odstępu czasu dla urządzenia.
Parametry
interval:Number — Żądany odstęp między uaktualnieniami. Jeśli jest ustawiona wartość 0 właściwości interval , jest używany najmniejszy obsługiwany odstęp czasu aktualizacji.
|
Zgłasza
ArgumentError — Podana wartość odstępu (interval ) jest mniejsza od zera.
|
status | Zdarzenie |
flash.events.StatusEvent
właściwość StatusEvent.type =
flash.events.StatusEvent.STATUS
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Zdarzenie wywoływane w przypadku zmiany statusu obrotu urządzenia.
Definiuje wartość właściwościtype
obiektu zdarzenia status
.
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ć. |
code | Opis stanu obiektu. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
level | Kategoria komunikatu, np. "status" , "warning" lub "error" . |
target | Obiekt informujący o swoim stanie. |
update | Zdarzenie |
flash.events.DeviceRotationEvent
właściwość DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 26.0 |
Zdarzenie update
jest wywoływane w odpowiedzi na aktualizacje danych z połączonych odczytów czujników przyspieszeniomierza i żyroskopu, gdy urządzenie zostanie obrócone. Zdarzenie jest wywoływane w następujących okolicznościach:
- Gdy za pomocą metody
addEventListener()
zostanie podłączona nowa funkcja detektora zdarzeń, to zdarzenie jest kierowane jeden raz do wszystkich zarejestrowanych detektorów, przez co otrzymują one aktualną wartość wektora obrotu wyrażoną za pomocą obrotu, skoku i kwaternionów. - Za każdym razem, gdy z platformy odebrane zostanie uaktualnienie danych o obrocie urządzenia (odbywa się to z częstotliwością określoną przez urządzenie).
- Za każdym razem, gdy aplikacja pominie zmianę obrotu urządzenia (np. środowisko wykonawcze wznawia działanie po okresie bezczynności).
type
obiektu zdarzenia DeviceRotationEvent
.
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ń. |
timestamp | Znacznik czasowy aktualizacji klasy DeviceRotation. |
roll | Wartość obrotu wyrażona w stopniach. |
pitch | Wartość skoku wyrażona w stopniach. |
yaw | Wartość odchyłu wyrażona w stopniach. |
quaternion | Dane kwaternionu w formacie [w, x, y, z] |
Tue Jun 12 2018, 12:06 PM Z