Paquete | flash.sensors |
Clase | public class DeviceRotation |
Herencia | DeviceRotation EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
Nota: utilice la propiedad DeviceRotation.isSupported
para probar si el entorno del motor de ejecución tiene capacidad para usar esta función. A pesar de que se puede acceder a la clase DeviceRotation y a sus miembros desde varios dispositivos y plataformas de tiempo de ejecución, esto no implica que siempre admitan el controlador en tiempo de ejecución. Hay algunos casos, como la versión de Android, en los que no se admite este controlador, por lo que se debe comprobar la compatibilidad de este con la propiedad DeviceRotation.isSupported
. Si DeviceRotation.isSupported
es true
en tiempo de ejecución, se admite DeviceRotation.
Compatibilidad con perfil de AIR: esta función sólo se admite en dispositivos móviles. No se admite en dispositivos de escritorio ni de AIR para TV. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
isSupported : Boolean [estática] [solo lectura]
La propiedad isSupported se establece en true si los sensores del acelerómetro y el giroscopio están disponibles en el dispositivo; en caso contrario, se establece en false. | DeviceRotation | ||
muted : Boolean [solo lectura]
Especifica si el usuario ha denegado el acceso a los datos de rotación del dispositivo (true) o lo ha autorizado (false). | DeviceRotation |
Método | Definido por | ||
---|---|---|---|
Crea una nueva instancia de DeviceRotation. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
El método setRequestedUpdateInterval se utiliza para definir el intervalo de tiempo deseado de las actualizaciones. | DeviceRotation | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Se distribuye cuando la rotación de dispositivo cambia de estado. | DeviceRotation | |||
Se distribuye el evento update cuando el dispositivo gira como respuesta a las actualizaciones de las lecturas combinadas de los sensores del acelerómetro y el giroscopio. | DeviceRotation |
isSupported | propiedad |
isSupported:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
La propiedad isSupported
se establece en true
si los sensores del acelerómetro y el giroscopio están disponibles en el dispositivo; en caso contrario, se establece en false
.
Implementación
public static function get isSupported():Boolean
Ejemplo ( Cómo utilizar este ejemplo )
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 | propiedad |
muted:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
Especifica si el usuario ha denegado el acceso a los datos de rotación del dispositivo (true
) o lo ha autorizado (false
). Cuando cambia este valor, se distribuye un evento status
.
Implementación
public function get muted():Boolean
Elementos de API relacionados
DeviceRotation | () | Información sobre |
public function DeviceRotation()
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
Crea una nueva instancia de DeviceRotation.
setRequestedUpdateInterval | () | método |
public function setRequestedUpdateInterval(interval:Number):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
El método setRequestedUpdateInterval
se utiliza para definir el intervalo de tiempo deseado de las actualizaciones. El intervalo de tiempo se mide en milisegundos. El intervalo de actualización sólo se utiliza como sugerencia para conservar la batería. El tiempo real entre las actualizaciones del vector de rotación del dispositivo puede ser mayor o menor que este valor. Cualquier cambio en el intervalo de actualización afecta a todos los detectores registrados. Puede utilizar la clase DeviceRotation sin llamar al método setRequestedUpdateInterval()
. En este caso, la aplicación recibe actualizaciones en función del intervalo predeterminado del dispositivo.
Parámetros
interval:Number — El intervalo de actualización solicitado. Si interval se establece en 0, se utiliza el mínimo intervalo de actualización admitido.
|
Emite
ArgumentError — El intervalo especificado es menor que cero.
|
status | Evento |
flash.events.StatusEvent
propiedad StatusEvent.type =
flash.events.StatusEvent.STATUS
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
Se distribuye cuando la rotación de dispositivo cambia de estado.
Define el valor de la propiedadtype
de un objeto de evento status
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
code | Descripción del estado del objeto. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
level | La categoría del mensaje, por ejemplo, "status" , "warning" o "error" . |
target | El objeto que informa sobre su estado. |
update | Evento |
flash.events.DeviceRotationEvent
propiedad DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 26.0 |
Se distribuye el evento update
cuando el dispositivo gira como respuesta a las actualizaciones de las lecturas combinadas de los sensores del acelerómetro y el giroscopio. El evento se distribuye en las circunstancias siguientes:
- Cuando se conecta una nueva función de detector mediante
addEventListener()
, este evento se envía una vez a todos los detectores registrados para proporcionar el valor actual del vector de la rotación del dispositivo en términos de roll, tono y cuaterniones. - Siempre que se obtienen actualizaciones de la rotación del dispositivo en la plataforma a intervalos determinados del dispositivo.
- Siempre que la aplicación omite un cambio en la rotación del dispositivo (por ejemplo, el motor de ejecución se reanuda después de estar inactivo).
type
para un objeto de evento DeviceRotationEvent
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
timestamp | La marca de fecha de la actualización de DeviceRotation. |
roll | El valor roll en grados. |
tono | El valor tono en grados. |
reenvío | El valor reenvío en grados. |
cuaternión | Los datos de cuaternión en formato [w, x, y, z]. |
Tue Jun 12 2018, 02:12 PM Z