DeviceRotation

Pakket	flash.sensors
Klasse	public class DeviceRotation
Overerving	DeviceRotation EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 26.0

De DeviceRotation-klasse verzendt gebeurtenissen op basis van de activiteit die door de versnellingsmeter en de gyroscoopsensoren van het apparaat wordt gedetecteerd. Deze gegevens vertegenwoordigen de rol, instelhoek, rotatie rond de y-as en viertallen van het apparaat. Wanneer het apparaat draait, detecteren de sensoren deze rotatie en worden deze gegevens geretourneerd. De DeviceRotation-klasse biedt methoden om met een query na te gaan of de gebeurtenishandler voor DeviceRotation al dan niet wordt ondersteund, en om de snelheid in te stellen waarmee deze gebeurtenissen worden verzonden.

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

isSupported
flash.events.DeviceRotationEvent

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	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

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		DeviceRotation() 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
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		setRequestedUpdateInterval(interval:Number):void De methode setRequestedUpdateInterval wordt gebruikt om het tijdsinterval voor updates in te stellen.	DeviceRotation
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
status	Wordt verzonden wanneer de status van de apparaatrotatie verandert.	DeviceRotation
update	De update-gebeurtenis wordt verzonden wanneer het apparaat wordt gedraaid zoals gedetecteerd door de gecombineerde lezingen van de versnellingsmeter en gyroscoopsensoren.	DeviceRotation

Eigenschapdetails

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 )

In het volgende voorbeeld wordt de DeviceRotation.isSupported-eigenschap gebruikt om te testen op DeviceRotation-ondersteuning tijdens runtime. Als de huidige omgeving ondersteuning biedt voor de functie DeviceRotation, wordt er een gebeurtenislistener toegevoegd aan het DeviceRotation-object en vult de hieraan gekoppelde handler het tekstveld met de tijdstempel en de waarden voor de rol, de instelhoek en de rotatie rond de y-as. Als dit niet het geval is, geeft het tekstveld aan dat de huidige omgeving geen ondersteuning biedt voor de functie.

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

status

Constructordetails

()

Constructor

public function DeviceRotation()

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 26.0

Maakt een nieuwe DeviceRotation-instantie.

Methodedetails

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.

Gebeurtenisdetails

status

Gebeurtenis

Type gebeurtenisobject: 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 eigenschap type 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

Type gebeurtenisobject: 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).

Definieert de waarde van de eigenschap 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]

Juridische kennisgeving | Online privacybeleid

DeviceRotation - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.sensors

isSupported

muted

DeviceRotation

setRequestedUpdateInterval

status

update