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.sensors 

DeviceRotation  - AS3

Paketflash.sensors
Klassepublic class DeviceRotation
VererbungDeviceRotation Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 26.0

Die DeviceRotations-Klasse setzt Ereignisse ab, die auf einer von den Beschleunigungs- und Gyroskopsensoren des Geräts erkannten Aktivität basieren. Diese Daten repräsentieren die roll-, pitch-, yaw- und quaternion-Werte des Geräts. Wenn sich das Gerät dreht, erkennen die Sensoren die Drehung und geben diese Daten zurück. Die DeviceRotation-Klasse bietet Methoden zum Abfragen, ob die Verarbeitung von Gerätedrehungsereignissen unterstützt wird, und zum Festlegen der Rate, mit der Gerätedrehungsereignisse abgesetzt werden.

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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert von
  
    DeviceRotation()
Erstellt eine neue DeviceRotation-Instanz.
DeviceRotation
 Inherited
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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 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
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
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
 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
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  
    status
Wird abgesetzt, wenn sich der Status von DeviceRotation ändert.DeviceRotation
  
    update
Das update-Ereignis wird abgesetzt, wenn das Gerät als Reaktion auf Aktualisierungen der kombinierten Werte der Beschleunigungs- und Gyroskopsensoren gedreht wird.DeviceRotation
Eigenschaftendetails
    

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 )
Im folgenden Beispiel wird die Eigenschaft „DeviceRotation.isSupported“ verwendet, um die DeviceRotation-Unterstützung zur Laufzeit zu prüfen. Wenn die aktuelle Umgebung die DeviceRotation-Funktion unterstützt, wird dem DeviceRotation-Objekt ein Ereignis-Listener hinzugefügt und der zugehörige Handler füllt das Textfeld mit dem Zeitstempel und den Werten des Beschleunigungssensors aus. Andernfalls gibt das Textfeld an, dass die Funktion in der aktuellen Umgebung nicht unterstützt wird.
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

Konstruktordetails
    

DeviceRotation

()Konstruktor
public function DeviceRotation()

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 26.0

Erstellt eine neue DeviceRotation-Instanz.

Methodendetails

    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.
Ereignisdetails
    

status

Ereignis
Ereignisobjekttyp: 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 Eigenschaft type eines status-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
codeEine Beschreibung des Objektstatus.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
EbeneDie Kategorie der Meldung, z. B. "status", "warning" oder "error".
targetDas Objekt, dessen Status gemeldet wird.
    

update

Ereignis  
Ereignisobjekttyp: 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).

Definiert den Wert der type-Eigenschaft eines DeviceRotationEvent-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
timestampDer Zeitstempel der DeviceRotation-Aktualisierung.
rollDer roll-Wert in Grad.
pitchDer pitch-Wert in Grad.
yawDer yaw-Wert in Grad.
quaternion Die quaternion-Daten im Format „[w, x, y, z]“.




[ 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.