DeviceRotation

Pacchetto	flash.sensors
Classe	public class DeviceRotation
Ereditarietà	DeviceRotation EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

La classe DeviceRotation invia eventi in base all'attività rilevata dai sensori dell'accelerometro e del giroscopio del dispositivo. Questi dati rappresentano i dati roll, pitch, yaw e quaternion del dispositivo. Quando il dispositivo viene ruotato, i sensori rilevano la rotazione e restituiscono i dati. La classe DeviceRotation fornisce i metodi per verificare se la gestione dell'evento rotazione del dispositivo è o meno supportata e inoltre per impostare la frequenza di invio degli eventi relativi alla rotazione.

Nota: utilizzate la proprietà DeviceRotation.isSupported per testare la capacità dell’ambiente runtime di utilizzare questa funzionalità. Anche se la classe di rotazione del dispositivo e i relativi membri sono accessibili per più piattaforme e dispositivi di runtime, ciò non implica che il gestore sia sempre supportato in fase di runtime. In alcuni casi, ad esempio la versione Android e così via, il gestore non è supportato, pertanto è necessario controllare il supporto di questo gestore mediante la proprietàDeviceRotation.isSupported. Se DeviceRotation.isSupported è true in fase runtime, il supporto DeviceRotation è presente.

Supporto profili AIR: questa funzionalità è supportata solo nei dispositivi mobili. Non è supportata nei dispositivi AIR per TV. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.

Elementi API correlati

isSupported
flash.events.DeviceRotationEvent

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		isSupported : Boolean [statico] [sola lettura] La proprietà isSupported è impostata su true se sul dispositivo sono disponibili i sensori dell’accelerometro e del giroscopio. In caso contrario è impostata su false.	DeviceRotation
		muted : Boolean [sola lettura] Specifica se l’utente ha negato (true) o consentito (false) l’accesso ai dati Device Rotation.	DeviceRotation

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		DeviceRotation() Crea una nuova istanza DeviceRotation.	DeviceRotation
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setRequestedUpdateInterval(interval:Number):void Il metodo setRequestedUpdateInterval viene utilizzato per impostare l'intervallo di tempo desiderato per gli aggiornamenti.	DeviceRotation
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
status	Inviato quando la rotazione del dispositivo cambia stato.	DeviceRotation
update	L'evento update viene inviato quando il dispositivo viene ruotato in risposta agli aggiornamenti dalle letture combinate dei sensori dell'accelerometro e del giroscopio.	DeviceRotation

Descrizione delle proprietà

isSupported

proprietà

isSupported:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

La proprietà isSupported è impostata su true se sul dispositivo sono disponibili i sensori dell’accelerometro e del giroscopio. In caso contrario è impostata su false.

Implementazione
public static function get isSupported():Boolean

Esempio ( Come utilizzare questo esempio )

Nell’esempio seguente la proprietà DeviceRotation.isSupported viene utilizzata per verificare se DeviceRotation in fase runtime è supportato. Se l’ambiente corrente supporta la funzionalità DeviceRotation, viene aggiunto un listener di eventi all’oggetto DeviceRotation e il gestore associato compila il campo di testo con i valori di indicazione temporale e di accelerazione. In caso contrario, il campo di testo indica che la funzionalità non è supportata nell'ambiente corrente.

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

proprietà

muted:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

Specifica se l’utente ha negato (true) o consentito (false) l’accesso ai dati Device Rotation. Quando questo valore cambia viene inviato un evento status.

Implementazione
public function get muted():Boolean

Elementi API correlati

status

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function DeviceRotation()

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

Crea una nuova istanza DeviceRotation.

Descrizione dei metodi

setRequestedUpdateInterval

()

metodo

public function setRequestedUpdateInterval(interval:Number):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

Il metodo setRequestedUpdateInterval viene utilizzato per impostare l'intervallo di tempo desiderato per gli aggiornamenti. L'intervallo di tempo viene misurato in millisecondi. L'intervallo di tempo viene utilizzato solo come suggerimento per risparmiare la carica della batteria. L'intervallo effettivo tra gli aggiornamenti del vettore di rotazione del dispositivo può essere maggiore o minore di questo valore. Qualsiasi modifica dell'intervallo di aggiornamento ha effetto su tutti i listener registrati. Potete utilizzare la classe DeviceRotation senza chiamare il metodo setRequestedUpdateInterval(). In questo caso, l'applicazione riceve gli aggiornamenti in base all'intervallo predefinito del dispositivo.

Parametri

interval:Number — L'intervallo di aggiornamento richiesto. Se interval è impostato su 0, viene utilizzato l'intervallo di aggiornamento minimo supportato.

Genera

ArgumentError — Il parametro interval specificato è minore di zero.

Descrizione degli eventi

status

Evento

Tipo di oggetto evento: flash.events.StatusEvent
proprietà StatusEvent.type = flash.events.StatusEvent.STATUS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

Inviato quando la rotazione del dispositivo cambia stato.

Definisce il valore della proprietà type di un oggetto evento status.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`code`	Una descrizione dello stato dell'oggetto.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`level`	La categoria del messaggio, ad esempio `"status"`, `"warning"` o `"error"`.
`target`	L'oggetto che riporta il proprio stato.

update

Evento

Tipo di oggetto evento: flash.events.DeviceRotationEvent
proprietà DeviceRotationEvent.type = flash.events.DeviceRotationEvent.UPDATE

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 26.0

L'evento update viene inviato quando il dispositivo viene ruotato in risposta agli aggiornamenti dalle letture combinate dei sensori dell'accelerometro e del giroscopio. L'evento viene inviato nelle seguenti circostanze:

Quando viene associata una nuova funzione listener tramite addEventListener(), questo evento viene inviato una volta a tutti i listener registrati per fornire il valore corrente del vettore di rotazione del dispositivo in termini di roll, pitch e quaternion.
Ogni volta che, a intervalli determinati dal dispositivo, vengono ottenuti aggiornamenti della rotazione del dispositivo dalla piattaforma.
Ogni volta che l'applicazione non rileva una modifica nella rotazione del dispositivo, ad esempio al ripristino del runtime dopo un'inattività.

Definisce il valore della proprietà type di un oggetto evento DeviceRotationEvent.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`timestamp`	L’indicatore orario dell’aggiornamento DeviceRotation.
`roll`	Il valore roll in gradi.
`pitch`	Il valore pitch in gradi.
`yaw`	Il valore yaw in pixel.
`quaternion`	I dati del quaternion nel formato [w, x, y, z]

Note legali | Informativa sulla privacy online

DeviceRotation - AS3

Classi x

isSupported

muted

DeviceRotation

setRequestedUpdateInterval

status

update