appnext.getPreferredOrientation()

Type Function
Return value String
Revision 2017.3060
Keywords ads, advertising, Appnext, getPreferredOrientation
See also appnext.setPreferredOrientation()
appnext.*

Overview

Relevant for full-screen and rewarded video ads only. Gets the preferred orientation for the ad.

Syntax

appnext.getPreferredOrientation( adKey )
adKey (required)

String. The ad key returned for a previously created ad.

Example

local appnext = require( "plugin.appnext" )

local function adListener( event )
    print( "Received " .. event.event .. " for " .. event.adKey .. " with message: " .. event.message )
end

-- Initialize the Appnext plugin
appnext.init( adListener )

-- Create your ads
local fullscreenPlacementID

local platform = system.getInfo( "platformName" )
if ( platform == "iPhone OS" ) then
    fullscreenPlacementID = "YOUR_IOS_FULLSCREEN_PLACEMENT_ID"
elseif ( platform == "Android" ) then
    fullscreenPlacementID = "YOUR_ANDROID_FULLSCREEN_PLACEMENT_ID"
end

local fullscreenAdKey = appnext.createAd( "fullscreen", fullscreenPlacementID )

appnext.setPreferredOrientation( fullscreenAdKey, "landscape" )

print( "Preferred Orientation: " .. appnext.getPreferredOrientation( fullscreenAdKey ) )