Paket | flash.sensors |
Klasse | public class DeviceRotation |
Vererbung | DeviceRotation EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Hinweis: Verwenden Sie die DeviceRotation.isSupported
-Eigenschaft, um zu testen, ob die Laufzeitumgebung die Verwendung dieses Features unterstützt. Auch wenn die DeviceRotation-Klasse und ihre Mitglieder für mehrere Laufzeitplattformen und -geräte zugänglich sind, wird die Prozedur nicht notwendigerweise zur Laufzeit unterstützt. Es gibt einige Fälle, beispielsweise bestimmte Android-Versionen usw., in denen diese Prozedur nicht unterstützt wird. Sie müssen die Unterstützung für diese Prozedur also mithilfe der DeviceRotation.isSupported
-Eigenschaft testen. Wenn DeviceRotation.isSupported
zur Laufzeit den Wert true
hat, wird DeviceRotation zurzeit unterstützt.
AIR-Profilunterstützung: Diese Funktion wird nur auf mobilen Geräten unterstützt. Auf Desktopgeräten oder Geräten mit AIR für TV wird sie nicht unterstützt. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
isSupported : Boolean [statisch] [schreibgeschützt]
Die „isSupported“-Eigenschaft ist auf „true“ gesetzt, wenn die Beschleunigungs- und Gyroskopsensoren im Gerät verfügbar sind, andernfalls hat sie den Wert „false“. | DeviceRotation | ||
muted : Boolean [schreibgeschützt]
Gibt an, ob der Benutzer den Zugriff auf die Gerätedrehungsdaten verweigert (true) oder gewährt hat (false). | DeviceRotation |
Methode | Definiert von | ||
---|---|---|---|
Erstellt eine neue DeviceRotation-Instanz. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Mit der setRequestedUpdateInterval-Methode wird das gewünschte Zeitintervall für Aktualisierungen festgelegt. | DeviceRotation | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird abgesetzt, wenn sich der Status von DeviceRotation ändert. | DeviceRotation | |||
Das update-Ereignis wird abgesetzt, wenn das Gerät als Reaktion auf Aktualisierungen der kombinierten Werte der Beschleunigungs- und Gyroskopsensoren gedreht wird. | DeviceRotation |
isSupported | Eigenschaft |
isSupported:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Die isSupported
-Eigenschaft ist auf true
gesetzt, wenn die Beschleunigungs- und Gyroskopsensoren im Gerät verfügbar sind, andernfalls hat sie den Wert false
.
Implementierung
public static function get isSupported():Boolean
Beispiel ( Verwendung dieses Beispiels )
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 | Eigenschaft |
muted:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Gibt an, ob der Benutzer den Zugriff auf die Gerätedrehungsdaten verweigert (true
) oder gewährt hat (false
). Wenn sich dieser Wert ändert, wird ein status
-Ereignis ausgelöst.
Implementierung
public function get muted():Boolean
Verwandte API-Elemente
DeviceRotation | () | Konstruktor |
public function DeviceRotation()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Erstellt eine neue DeviceRotation-Instanz.
setRequestedUpdateInterval | () | Methode |
public function setRequestedUpdateInterval(interval:Number):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Mit der setRequestedUpdateInterval
-Methode wird das gewünschte Zeitintervall für Aktualisierungen festgelegt. Das Zeitintervall wird in Millisekunden gemessen. Das Aktualisierungsintervall wird zur Schonung der Akkuenergie nur als Näherungswert verwendet. Die tatsächliche Zeitspanne zwischen Aktualisierungen des Gerätedrehungsvektors kann größer oder kleiner als dieser Wert sein. Änderungen am Aktualisierungsintervall betreffen alle registrierten Listener. Sie können die DeviceRotation-Klasse verwenden, ohne die setRequestedUpdateInterval()
-Methode aufzurufen. In diesem Fall empfängt die Anwendung Aktualisierungen entsprechend dem Standardintervall des Geräts.
Parameter
interval:Number — Das angeforderte Aktualisierungsintervall. Wenn interval auf 0 gesetzt ist, wird das unterstützte Mindestaktualisierungsintervall verwendet.
|
Auslöser
ArgumentError — Das angegebene interval ist kleiner als null.
|
status | Ereignis |
flash.events.StatusEvent
Eigenschaft StatusEvent.type =
flash.events.StatusEvent.STATUS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Wird abgesetzt, wenn sich der Status von DeviceRotation ändert.
Definiert den Wert der Eigenschafttype
eines status
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
code | Eine Beschreibung des Objektstatus. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
Ebene | Die Kategorie der Meldung, z. B. "status" , "warning" oder "error" . |
target | Das Objekt, dessen Status gemeldet wird. |
update | Ereignis |
flash.events.DeviceRotationEvent
Eigenschaft DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 26.0 |
Das update
-Ereignis wird ausgelöst, wenn das Gerät als Reaktion auf Aktualisierungen der kombinierten Werte der Beschleunigungs- und Gyroskopsensoren gedreht wird. Das Ereignis wird unter den folgenden Umständen abgesetzt:
- Wenn eine neue Listener-Funktion mit
addEventListener()
hinzugefügt wird, wird dieses Ereignis einmalig allen registrierten Listenern für die Bereitstellung des aktuellen Werts des Gerätedrehungsvektors hinsichtlich der roll-, pitch- und quaternion-Daten zugestellt. - Wenn Aktualisierungen der Gerätedrehung in vom Gerät bestimmten Intervallen von der Plattform empfangen werden.
- Wenn die Anwendung eine Änderung der Gerätedrehung verpasst (zum Beispiel die Wiederaufnahme der Laufzeitumgebung nach einer Zeit der Inaktivität).
type
-Eigenschaft eines DeviceRotationEvent
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
timestamp | Der Zeitstempel der DeviceRotation-Aktualisierung. |
roll | Der roll-Wert in Grad. |
pitch | Der pitch-Wert in Grad. |
yaw | Der yaw-Wert in Grad. |
quaternion | Die quaternion-Daten im Format „[w, x, y, z]“. |
Tue Jun 12 2018, 10:04 AM Z