Identification du format et de l’orientation actuels de la scène

L’orientation est indiquée relativement à la position normale du périphérique. Sur la plupart des périphériques, il existe une position verticale clairement identifiable. Cette position est considérée comme l’orientation par défaut. Les trois autres orientations possibles sont les suivantes : rotated left, rotated right et upside down. La classe StageOrientation intègre les constantes de type chaîne à utiliser lors de la définition ou de la comparaison de valeurs d’orientation.

La classe Stage définit deux propriétés qui indiquent l’orientation, à savoir :

  • Stage.deviceOrientation : indique l’orientation physique du périphérique par rapport à la position par défaut.

    Remarque : l’orientation du périphérique n’est pas toujours disponible si l’application vient de démarrer ou si le périphérique est posé à plat. Dans ces cas de figure, l’orientation indiquée du périphérique correspond à unknown.
  • Stage.orientation : indique l’orientation de la scène par rapport à la position par défaut. Si vous avez activé l’orientation automatique, la scène pivote dans la direction opposée à celle du périphérique pour demeurer verticale. Les positions droite et gauche indiquées par la propriété orientation représentent donc l’opposé des positions indiquées par la propriété deviceOrientation. Ainsi, si deviceRotation indique rotated right, orientation indique rotated left.

Pour identifier le format de la scène, il suffit de comparer la largeur et la hauteur actuelles de la scène :

var aspect:String = this.stage.stageWidth >= this.stage.stageHeight ? StageAspectRatio.LANDSCAPE : StageAspectRatio.PORTRAIT;