A phonegap/cordova plugin for locking the orientation
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead of cogitor:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/com/plugin/phonegap
www
LICENSE.md
README.md
package.json
plugin.xml

README.md

OrientationLock

Android Cordova plugin for locking/unlocking the screen orientation from Javascript

Calling the plugin

From your JavaScript code call window.plugins.orientationLock.unlock() to unlock orientation, window.plugins.orientationLock.lock("portrait") or window.plugins.orientationLock.lock("landscape") to lock your screen to the specified orientation.

To start your Cordova application pre-locked place setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT); or setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE); in the onCreate() of your Cordova activity.

Once unlocked, you can track orientation changes with the regular orientationchange event:

window.addEventListener("orientationchange", function() {
   alert(window.orientation);
});

Adding the Plugin to your project

Using this plugin requires Apache Cordova for Android. Within your project, run the following command:

cordova plugin add https://github.com/cogitor/PhoneGap-OrientationLock.git