Paket | flash.sensors |
Klass | public class DeviceRotation |
Arv | DeviceRotation EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Obs! Använd egenskapen DeviceRotation.isSupported
om du vill testa att funktionen kan användas i körningsmiljön. Trots att klassen DeviceRotation och dess medlemmar är tillgängliga för flera olika plattformar och enheter innebär det inte att hanteraren alltid stöds i körningsmiljön. Det finns tillfällen, till exempel i vissa Android-versioner, då hanteraren inte stöds. Därför måste du kontrollera att hanteraren stöds genom att använda egenskapen DeviceRotation.isSupported
. Om DeviceRotation.isSupported
är true
vid körningen stöds DeviceRotation.
Stöd för AIR-profiler: Den här funktionen stöds bara på mobilenheter. Den stöds inte på klientdatorer eller enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
isSupported : Boolean [statisk] [skrivskyddad]
Egenskapen isSupported är true om accelerometern och gyroskopsensorerna är tillgängliga på enheten, i annat fall är värdet false. | DeviceRotation | ||
muted : Boolean [skrivskyddad]
Anger om användaren har nekat åtkomst till data om enhetsrotation (true) eller tillåtit åtkomst (false). | DeviceRotation |
Metod | Definieras med | ||
---|---|---|---|
Skapar en ny DeviceRotation-instans. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Metoden setRequestedUpdateInterval används för att ange önskat tidsintervall för uppdateringar. | DeviceRotation | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher |
Händelse | Sammanfattning | Definieras med | ||
---|---|---|---|---|
[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Skickas när status för enhetsrotation ändras. | DeviceRotation | |||
Händelsen update skickas när enheten roteras som svar på uppdateringar från de kombinerade avläsningarna från accelerometern och gyroskopsensorerna. | DeviceRotation |
isSupported | egenskap |
isSupported:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Egenskapen isSupported
är true
om accelerometern och gyroskopsensorerna är tillgängliga på enheten, i annat fall är värdet false
.
Implementering
public static function get isSupported():Boolean
Exempel ( Så här använder du exemplet )
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 | egenskap |
muted:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Anger om användaren har nekat åtkomst till data om enhetsrotation (true
) eller tillåtit åtkomst (false
). Om det här värdet ändras skickas en status
-händelse.
Implementering
public function get muted():Boolean
Relaterade API-element
DeviceRotation | () | Konstruktor |
public function DeviceRotation()
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Skapar en ny DeviceRotation-instans.
setRequestedUpdateInterval | () | metod |
public function setRequestedUpdateInterval(interval:Number):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Metoden setRequestedUpdateInterval
används för att ange önskat tidsintervall för uppdateringar. Tidsintervallet mäts i millisekunder. Uppdateringsintervallet används bara som ett tips för att spara på batteriet. Den faktiska tiden mellan uppdateringar av enhetsrotationsvektorer kan vara längre eller kortare än det här värdet. Förändringar av uppdateringsintervallet påverkar alla registrerade avlyssnare. Du kan använda klassen DeviceRotation utan att anropa metoden setRequestedUpdateInterval()
. I det här fallet tar programmet emot uppdateringar baserat på enhetens standardintervall.
Parametrar
interval:Number — Det begärda uppdateringsintervallet. Om interval anges som 0 används det minsta uppdateringsintervall som stöds.
|
Utlöser
ArgumentError — Angivet interval är mindre än noll.
|
status | Händelse |
flash.events.StatusEvent
egenskap StatusEvent.type =
flash.events.StatusEvent.STATUS
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Skickas när status för enhetsrotation ändras.
Definierar värdet för ettstatus
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
kod | En beskrivning av objektets status. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
nivå | Meddelandets kategori, till exempel "status" , "warning" eller "error" . |
target | Objektet rapporterar status. |
update | Händelse |
flash.events.DeviceRotationEvent
egenskap DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 26.0 |
Händelsen update
skickas när enheten roteras som svar på uppdateringar från de kombinerade avläsningarna från accelerometern och gyroskopsensorerna. Händelsen skickas under följande förhållanden:
- När en ny avlyssnarfunktion kopplas via
addEventListener()
skickas händelsen en gång till alla registrerade avlyssnare för att leverera det aktuella värdet för enhetsrotationsvektorn när det gäller rullning, lutning och kvaternioner. - När uppdateringar om enhetsrotation tas emot från plattformen med de intervall som enheten anger.
- När programmet missar en förändring i enhetens rotation (till exempel om miljön återaktiveras efter inaktivitet).
type
-egenskapen hos ett DeviceRotationEvent
-objekt.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
timestamp | Tidsstämpeln för DeviceRotation-uppdateringen. |
roll | Rullningsvärdet i grader. |
pitch | Lutningsvärdet i grader. |
yaw | Girningsvärdet i grader. |
quaternion | Kvaterniondata i formatet [w, x, y, z]. |
Tue Jun 12 2018, 01:40 PM Z