Name: mobileDeviceOrientation

Type: function

Syntax: mobileDeviceOrientation()

Summary: Returns the current device orientation.

Synonyms: iphoneDeviceOrientation

Introduced: 4.5.2

OS: ios,android

Platforms: mobile

Example:
put mobileDeviceOrientation() into theOrientation

Returns (enum): The <mobileDeviceOrientation> function returns one of:
- unknown : the orientation could not be determined
- portrait : the device is being held upward with the home button at the bottom
- portrait upside down : the device is being held upward with the home button at the top
- landscape left : the device is being held upward with the home button on the left
- landscape right : the device is being held upward with the home button on the right
- face up : the device is lying flat with the screen upward
- face down : the device is lying flat with the screen downward

Description:
Use the <mobileDeviceOrientation> function to find the current device orientation.

The <mobileDeviceOrientation> function returns the current orientation of the device.

>*Note:* Due to the limitation of the Android operating system, landscape left and portrait upside-down are only supported on Android 2.3 and later.

References: mobileSetAllowedOrientations (command), mobileLockOrientation (command), mobileUnlockOrientation (command), mobileAllowedOrientations (function), mobileOrientation (function), orientationChanged (message)
