Pakket | flash.sensors |
Klasse | public class DeviceRotation |
Overerving | DeviceRotation EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
Opmerking: Gebruik de eigenschap DeviceRotation.isSupported
om te testen of de runtimeomgeving ondersteuning biedt voor deze functie. De DeviceRotation-klasse en de bijbehorende elementen zijn toegankelijk voor meerdere platformen en apparaten, maar dat betekent niet dat de handler bij uitvoering altijd wordt ondersteund. Er zijn enkele gevallen waar deze handler niet wordt ondersteund, zoals de Android-versie. Hier moet u de correcte functionaliteit dus controleren met gebruik van de eigenschap DeviceRotation.isSupported
. Als DeviceRotation.isSupported
in de runtime de waarde true
heeft, is er momenteel ondersteuning voor de deze functie.
AIR-profielondersteuning: deze functie wordt alleen ondersteund op mobiele apparaten. Deze functie wordt niet ondersteund op het bureaublad of bij AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
isSupported : Boolean [statisch] [alleen-lezen]
De eigenschap isSupported wordt ingesteld op true als de versnellingsmeter en gyroscoopsensoren beschikbaar zijn op het apparaat. Als dit niet het geval is, wordt de eigenschap ingesteld op false. | DeviceRotation | ||
muted : Boolean [alleen-lezen]
Geeft op of de gebruiker toegang tot de apparaatrotatiegegevens heeft geweigerd (true) of toegestaan (false). | DeviceRotation |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een nieuwe DeviceRotation-instantie. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
De methode setRequestedUpdateInterval wordt gebruikt om het tijdsinterval voor updates in te stellen. | DeviceRotation | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de status van de apparaatrotatie verandert. | DeviceRotation | |||
De update-gebeurtenis wordt verzonden wanneer het apparaat wordt gedraaid zoals gedetecteerd door de gecombineerde lezingen van de versnellingsmeter en gyroscoopsensoren. | DeviceRotation |
isSupported | eigenschap |
isSupported:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
De eigenschap isSupported
wordt ingesteld op true
als de versnellingsmeter en gyroscoopsensoren beschikbaar zijn op het apparaat. Als dit niet het geval is, wordt de eigenschap ingesteld op false
.
Implementatie
public static function get isSupported():Boolean
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | eigenschap |
muted:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
Geeft op of de gebruiker toegang tot de apparaatrotatiegegevens heeft geweigerd (true
) of toegestaan (false
). Wanneer deze waarde verandert, wordt een gebeurtenis status
verzonden.
Implementatie
public function get muted():Boolean
Verwante API-elementen
DeviceRotation | () | Constructor |
public function DeviceRotation()
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
Maakt een nieuwe DeviceRotation-instantie.
setRequestedUpdateInterval | () | methode |
public function setRequestedUpdateInterval(interval:Number):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
De methode setRequestedUpdateInterval
wordt gebruikt om het tijdsinterval voor updates in te stellen. Het tijdsinterval wordt gemeten in milliseconden. Het update-interval wordt alleen gebruikt als een hint om batterijvermogen te conserveren. De werkelijke tijd tussen vectorupdates voor apparaatrotatie kan groter of kleiner zijn dan deze waarde. Elke wijziging in de update-interval beïnvloedt alle geregistreerde listeners. U kunt de DeviceRotation-klasse gebruiken zonder de setRequestedUpdateInterval()
-methode op te roepen. In dat geval ontvangt de toepassing updates op basis van de standaardinterval van het apparaat.
Parameters
interval:Number — Het aangevraagde update-interval. Als de waarde voor interval is ingesteld op 0, wordt het minimaal ondersteunde bijwerkingsinterval gebruikt.
|
Gegenereerde uitzondering
ArgumentError — Het opgegeven interval is minder dan nul.
|
status | Gebeurtenis |
flash.events.StatusEvent
eigenschap StatusEvent.type =
flash.events.StatusEvent.STATUS
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
Wordt verzonden wanneer de status van de apparaatrotatie verandert.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject status
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
code | Beschrijving van de status van het object. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
level | De categorie van het bericht, zoals "status" , "warning" of "error" . |
target | Het object dat zijn status rapporteert. |
update | Gebeurtenis |
flash.events.DeviceRotationEvent
eigenschap DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 26.0 |
De update
-gebeurtenis wordt verzonden wanneer het apparaat wordt gedraaid zoals gedetecteerd door de gecombineerde lezingen van de versnellingsmeter en gyroscoopsensoren. De gebeurtenis wordt verzonden in de volgende omstandigheden:
- Wanneer een nieuwe listenerfunctie wordt gekoppeld via
addEventListener()
, wordt deze gebeurtenis eenmaal aan alle geregistreerde listeners geleverd om de huidige waarde van de apparaatrotatievector te bieden aan de hand van de rol, instelhoek en viertallen. - Wanneer updates van de apparaatrotatie worden verkregen via het platform op intervallen die door het apparaat zijn bepaald.
- Wanneer de toepassing een wijziging in de apparaatrotatie overslaat (bijvoorbeeld wanneer de uitvoering wordt hervat nadat deze inactief is geweest).
type
van een gebeurtenisobject DeviceRotationEvent
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
timestamp | Het tijdsstempel van de DeviceRotation-update. |
roll | De rolwaarde in graden. |
pitch | De waarde van de instelhoek in graden. |
yaw | De waarde van de rotatie rond de y-as in graden. |
quaternion | De viertalgegevens in de indeling [w, x, y, z] |
Wed Jun 13 2018, 11:42 AM Z