Package | flash.sensors |
Classe | public class DeviceRotation |
Héritage | DeviceRotation EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
Remarque : Utilisez la propriété DeviceRotation.isSupported
pour vérifier si l’environnement d’exécution prend en charge cette fonctionnalité. Bien que la classe de rotation du périphérique et ses membres soient accessibles sur plusieurs plates-formes d’exécution et périphériques, cela ne signifie pas que le gestionnaire est toujours pris en charge lors de l’exécution. Dans certains cas (version d’Android, par exemple), ce gestionnaire n’est pas pris en charge. Vous devez donc vérifier sa prise en charge en utilisant la propriété DeviceRotation.isSupported.
Si la propriété DeviceRotation.isSupported
est définie sur true
au moment de l’exécution, la fonction DeviceRotation est prise en charge.
Prise en charge du profil AIR : cette fonctionnalité est prise en charge uniquement sur les périphériques mobiles. Elle n’est pas prise en charge sur les périphériques de bureau ou sur les périphériques AIR pour TV. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
isSupported : Boolean [statique] [lecture seule]
La propriété isSupported est définie sur « true » si les capteurs de l’accéléromètre et du gyroscope sont disponibles sur le périphérique ; dans le cas contraire, elle est définie sur « false ». | DeviceRotation | ||
muted : Boolean [lecture seule]
Indique si l’utilisateur a refusé (true) ou autorisé (false) l’accès aux données de rotation du périphérique. | DeviceRotation |
Méthode | Défini par | ||
---|---|---|---|
Crée une instance DeviceRotation. | DeviceRotation | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
La méthode setRequestedUpdateInterval est utilisée pour définir l’intervalle de mise à jour souhaité. | DeviceRotation | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
Evénement | Synthèse | Défini par | ||
---|---|---|---|---|
[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | |||
[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | |||
Distribué lors du changement d’état de rotation du périphérique. | DeviceRotation | |||
L’événement « update » est distribué lorsque le périphérique fait l’objet d’une rotation en réponse aux mises à jour des lectures combinées des capteurs de l’accéléromètre et du gyroscope. | DeviceRotation |
isSupported | propriété |
isSupported:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
La propriété isSupported
est définie sur true
si les capteurs de l’accéléromètre et du gyroscope sont disponibles sur le périphérique ; dans le cas contraire, elle est définie sur false
.
Implémentation
public static function get isSupported():Boolean
Exemple ( Comment utiliser cet exemple )
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 | propriété |
muted:Boolean
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
Indique si l’utilisateur a refusé (true
) ou autorisé (false
) l’accès aux données de rotation du périphérique. Lorsque cette valeur change, un événement status
est distribué.
Implémentation
public function get muted():Boolean
Eléments de l’API associés
DeviceRotation | () | Constructeur |
public function DeviceRotation()
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
Crée une instance DeviceRotation.
setRequestedUpdateInterval | () | méthode |
public function setRequestedUpdateInterval(interval:Number):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
La méthode setRequestedUpdateInterval
est utilisée pour définir l’intervalle de mise à jour souhaité. L’intervalle est mesuré en millisecondes. L’intervalle de mise à jour n’est qu’une suggestion pour préserver la charge de la batterie. L’intervalle réel entre les mises à jour du vecteur de rotation du périphérique peut être supérieur ou inférieur à cette valeur. Toute modification de l’intervalle de mise à jour affecte l’ensemble des écouteurs enregistrés. Vous pouvez utiliser la classe DeviceRotation sans appeler la méthode setRequestedUpdateInterval()
. Dans ce cas, l’application reçoit les mises à jour en fonction de l’intervalle par défaut spécifié sur le périphérique.
Paramètres
interval:Number — Intervalle de mise à jour spécifié. Si la propriété interval est définie sur 0, la prise en charge de l’intervalle minimal de mise à jour est utilisée.
|
Valeur émise
ArgumentError — La valeur spécifiée du paramètre interval est inférieure à zéro.
|
status | Evénement |
flash.events.StatusEvent
propriété StatusEvent.type =
flash.events.StatusEvent.STATUS
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
Distribué lors du changement d’état de rotation du périphérique.
Définit la valeur de la propriététype
d’un objet événement status
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
code | Description de l’état de l’objet. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
level | Catégorie du message, telle que "status" , "warning" ou "error" . |
target | Objet publiant son état. |
update | Evénement |
flash.events.DeviceRotationEvent
propriété DeviceRotationEvent.type =
flash.events.DeviceRotationEvent.UPDATE
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 26.0 |
L’événement update
est distribué lorsque le périphérique fait l’objet d’une rotation en réponse aux mises à jour des lectures combinées des capteurs de l’accéléromètre et du gyroscope. Cet événement est distribué dans les cas suivants :
- Lorsqu’une nouvelle fonction d’écouteur est associée via la méthode
addEventListener()
, cet événement est distribué une seule fois pour tous les écouteurs enregistrés afin de fournir la valeur actuelle du vecteur de rotation du périphérique sous la forme de quaternions, de roulis et de tangage. - Chaque fois que la plate-forme fournit des mises à jour de rotation du périphérique des intervalles déterminés par ce dernier.
- Chaque fois que l’application omet un changement dans la rotation du périphérique (notamment lorsque le moteur d’exécution reprend après une période d’inactivité).
type
d’un objet d’événement DeviceRotationEvent
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
timestamp | Horodatage de la mise à jour de DeviceRotation. |
roulis | Valeur de roulis en degrés. |
tangage | Valeur de tangage en degrés. |
lacet | Valeur de lacet en degrés. |
quaternion | Données de quaternion au format [w, x, y, z]. |
Tue Jun 12 2018, 09:30 AM Z