Paket | flash.sensors |
Klasse | public class Accelerometer |
Vererbung | Accelerometer EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Hinweis: Verwenden Sie die Accelerometer.isSupported
-Eigenschaft, um zu testen, ob die Laufzeitumgebung die Verwendung dieses Features unterstützt. Während die Accelerometer-Klasse und ihre Mitglieder für die Laufzeitumgebungen, die für jeden API-Eintrag aufgeführt sind, zugänglich sind, bestimmt die aktuelle Umgebung für die Laufzeit die Verfügbarkeit dieser Funktion. Sie können zum Beispiel Code mit den Eigenschaften der Accelerometer-Klasse für Flash Player 10.1 kompilieren, Sie müssen jedoch die Accelerometer.isSupported
-Eigenschaft verwenden, um die Verfügbarkeit der Accelerometer-Funktion in der aktuellen Entwicklungsumgebung für die Flash Player-Laufzeitumgebung zu testen. Wenn Accelerometer.isSupported
zur Laufzeit den Wert true
hat, wird Accelerometer 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.
Weitere Informationen
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 der Beschleunigungssensor im Gerät verfügbar ist, andernfalls hat sie den Wert „false“. | Accelerometer | ||
muted : Boolean [schreibgeschützt]
Gibt an, ob der Benutzer den Zugriff auf den Beschleunigungssensor verweigert (true) oder gewährt hat (false). | Accelerometer |
Methode | Definiert von | ||
---|---|---|---|
Erstellt eine neue Accelerometer-Instanz. | Accelerometer | ||
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. | Accelerometer | ||
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 ein Beschleunigungssensor seinen Status ändert. | Accelerometer | |||
Das update-Ereignis wird in Reaktion auf Updates vom Beschleunigungssensor abgesetzt. | Accelerometer |
isSupported | Eigenschaft |
isSupported:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Die isSupported
-Eigenschaft ist auf true
gesetzt, wenn der Beschleunigungssensor im Gerät verfügbar ist, andernfalls hat sie den Wert false
.
Implementierung
public static function get isSupported():Boolean
Beispiel ( Verwendung dieses Beispiels )
Accelerometer.isSupported
-Eigenschaft getestet, ob Accelerometer zur Laufzeit unterstützt wird. Wenn die aktuelle Umgebung die Accelerometer-Funktion unterstützt, wird dem Accelerometer-Objekt ein Ereignis-Listener hinzugefügt und die dazugehörige Prozedur 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 acc1:Accelerometer = new Accelerometer(); var isSupported:Boolean = Accelerometer.isSupported; checksupport(); function checksupport():void { if (isSupported) { myTextField.text = "Accelerometer feature supported"; acc1.addEventListener(AccelerometerEvent.UPDATE, updateHandler); } else { myTextField.text = "Accelerometer feature not supported"; } } function updateHandler(evt:AccelerometerEvent):void { myTextField.text = String("at: " + evt.timestamp + "\n" + "acceleration X: " + evt.accelerationX + "\n" + "acceleration Y: " + evt.accelerationY + "\n" + "acceleration Z: " + evt.accelerationZ); }
muted | Eigenschaft |
muted:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1 |
Gibt an, ob der Benutzer den Zugriff auf den Beschleunigungssensor 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
Accelerometer | () | Konstruktor |
public function Accelerometer()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Erstellt eine neue Accelerometer-Instanz.
setRequestedUpdateInterval | () | Methode |
public function setRequestedUpdateInterval(interval:Number):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1, Flash Lite 4 |
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 Beschleunigungsaktualisierungen kann größer oder kleiner als dieser Wert sein. Änderungen am Aktualisierungsintervall betreffen alle registrierten Listener. Sie können die Accelerometer-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 2, Flash Player 10.1, Flash Lite 4 |
Wird abgesetzt, wenn ein Beschleunigungssensor seinen Status ändert.
Hinweis: Bei einigen Geräten ist der Beschleunigungssensor immer verfügbar. Bei derartigen Geräten setzt ein Accelerometer-Objekt niemals status
-Ereignisse ab.
type
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.AccelerometerEvent
Eigenschaft AccelerometerEvent.type =
flash.events.AccelerometerEvent.UPDATE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2, Flash Player 10.1, Flash Lite 4 |
Das update
-Ereignis wird in Reaktion auf Updates vom Beschleunigungssensor abgesetzt. 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 Beschleunigungssensors zugestellt. - Wenn Aktualisierungen vom Beschleunigungssensor in vom Gerät bestimmten Intervallen von der Plattform empfangen werden.
- Wenn die Anwendung eine Änderung des Beschleunigungssensors verpasst (zum Beispiel die Wiederaufnahme der Laufzeitumgebung nach einer Zeit der Inaktivität).
type
-Eigenschaft eines AccelerometerEvent
-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 Accelerometer-Aktualisierung. |
accelerationX | Der Beschleunigungswert in G (9,8m/s/s) entlang der x-Achse. |
accelerationY | Der Beschleunigungswert in G (9,8m/s/s) entlang der y-Achse. |
accelerationZ | Der Beschleunigungswert in G (9,8m/s/s) entlang der z-Achse. |
update
-Ereignissen für den Beschleunigungssensor. Die update
-Ereignisse des Beschleunigungssensors zeigen die Bewegung des Geräts an.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; import flash.events.AccelerometerEvent; import flash.sensors.Accelerometer; public class AccelerometerTest extends Sprite { private var ball:Sprite; private var accelerometer:Accelerometer; private var xSpeed:Number = 0; private var ySpeed:Number = 0; private const RADIUS = 20; public final function AccelerometerTest() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; createBall(); if (Accelerometer.isSupported) { accelerometer = new Accelerometer(); accelerometer.addEventListener(AccelerometerEvent.UPDATE, accUpdateHandler); stage.addEventListener(Event.ENTER_FRAME, enterFrameHandler); } } private final function createBall():void { ball = new Sprite(); ball.graphics.beginFill(0xFF0000); ball.graphics.drawCircle(0, 0, RADIUS); ball.cacheAsBitmap = true; ball.x = stage.stageWidth / 2; ball.y = stage.stageHeight / 2; addChild(ball); } private final function enterFrameHandler(event:Event):void { event.stopPropagation(); moveBall(); } private final function moveBall():void { var newX:Number = ball.x + xSpeed; var newY:Number = ball.y + ySpeed; if (newX < 20) { ball.x = RADIUS; xSpeed = 0; } else if (newX > stage.stageWidth - RADIUS) { ball.x = stage.stageWidth - RADIUS; xSpeed = 0; } else { ball.x += xSpeed; } if (newY < RADIUS) { ball.y = RADIUS; ySpeed = 0; } else if (newY > stage.stageHeight - RADIUS) { ball.y = stage.stageHeight - RADIUS; ySpeed = 0; } else { ball.y += ySpeed; } } private final function accUpdateHandler(event:AccelerometerEvent):void { xSpeed -= event.accelerationX * 2; ySpeed += event.accelerationY * 2; } } }
Tue Jun 12 2018, 10:04 AM Z