Over a million developers have joined DZone.

PhoneGap Tip: Temporarily Changing Orientation for Video in a Portrait Only Application

· Mobile Zone

Visually compose APIs with easy-to-use tooling. Learn how IBM API Connect provides near-universal access to data and services both on-premises and in the cloud, brought to you in partnership with IBM.

That's probably the longest title I ever used for a blog post. A PhoneGap user came to me recently with an interesting problem. His application was set to be portrait only. In case you weren't aware, you can lock orientation for an application using this config.xml value:

<preference name="orientation" value="portrait"/>

While this works well, he wanted to do videos in landscape mode instead. He had it working fine in iOS but nothing he tried would work for Android. I began by looking for a plugin to allow me to switch orientation dynamically. This one,http://plugins.cordova.io/#/package/net.yoik.cordova.plugins.screenorientation, worked great.

So at this point - I found the code in the application that fired off the video to go into full screen mode, and added the two simple lines of code to set orientation to landscape.

video.addEventListener('playing', function() {
     var so = cordova.plugins.screenorientation;
}, false);

This worked great. All in all this part took me 15 minutes. But then I had a problem - how to leave this mode. Turns out this was pretty difficult. When I looked at the set of events for media tags, none of them handled the case I needed - the user hitting the back button. I could listen for the video ending, but in theory the user may wish to watch the video twice. I couldn't find any way of noticing the user leaving the video. Then I looked back to the code I had originally modified - the one fired when the video began. The user had entered full screen mode like so:

if (video.webkitEnterFullScreen)
else if (video.webkitRequestFullScreen)
else if (video.requestFullscreen)

I did some digging and discovered you could listen for the user leaving full screen mode, which happened automatically when they hit their back button.

jQuery(document).on('webkitfullscreenchange', function(e) {       
    if(!e.currentTarget.webkitIsFullScreen) {
        var so = cordova.plugins.screenorientation;

In the example above we check to see if the device is currently in full screen, and if not, i.e. they were leaving it, we go back to portrait. In theory I could use this one event handler to handle switching it to landscape too.

Any way - I hope this helps others!

The Mobile Zone is brought to you in partnership with Strongloop and IBM.  Visually compose APIs with easy-to-use tooling. Learn how IBM API Connect provides near-universal access to data and services both on-premises and in the cloud.


Published at DZone with permission of Raymond Camden, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

The best of DZone straight to your inbox.

Please provide a valid email address.

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}