superawesome.show()

类型 函数
返回值 无
修订 版本 2024.3703
关键词 广告, SuperAwesome, show
另请参阅 superawesome.hide()
superawesome.init()
superawesome.load()
superawesome.isLoaded()
superawesome.*

概述

显示之前通过 superawesome.load() 加载的 SuperAwesome 广告。

语法

superawesome.show( placementID [, params] )
placementID (必填)

字符串. 广告的 placement ID，从 SuperAwesome 控制面板 获取。

params (可选)

表. 包含广告可选参数的表 — 详情请参阅下一节。

参数参考

params 表可以包含广告的属性

useParentalGate (可选)

布尔值. 指示在点击广告时是否显示家长控制门（简单的数学问题弹窗）。默认为 false。

showVideoCloseButton (可选)

布尔值. 仅适用于视频广告；指示广告在播放期间是否显示关闭按钮。默认为 true。

closeVideoAtEnd (可选)

布尔值. 仅适用于视频广告；指示广告在其播放完成后是否自动关闭。默认为 false。

useSmallClickZone (可选)

布尔值. 仅适用于视频广告；如果为 true，则在广告底部显示一个小的可点击文本元素，使广告的其余部分不可点击。如果为 false，则整个广告均可点击。默认为 false。

lockOrientation (可选)

字符串. 不适用于横幅广告；允许您锁定广告的方向。有效值为 "landscape"（横向）和 "portrait"（纵向）。默认情况下，广告将根据设备方向更改方向。

y (可选)

字符串 或 数字. 仅适用于横幅广告，指定横幅在屏幕上的 **y** 位置。如果您提供字符串，有效的 位置值为 "top"（顶部）、"center"（居中）和 "bottom"（底部）。或者，您可以通过在内容坐标中指定一个 数字 来设置自定义 **y** 位置，其中 0 表示屏幕的顶部边缘，负值表示从屏幕底部边缘到横幅底部边缘的偏移量。默认为 "bottom"。

示例

local superawesome = require( "plugin.superawesome" )

-- Pre-declare a placement ID
local myPlacementID = "YOUR_PLACEMENT_ID"

local function adListener( event )

    if ( event.phase == "init" ) then  -- Successful initialization
        -- Load a banner ad
        superawesome.load( "banner", { placementId=myPlacementID } )

    elseif ( event.phase == "loaded" ) then  -- The ad was successfully loaded
        print( event.type )
        print( event.placementId )

    elseif ( event.phase == "failed" ) then  -- The ad failed to load
        print( event.type )
        print( event.placementId )
        print( event.isError )
    end
end

-- Initialize the SuperAwesome plugin
superawesome.init( adListener, { testMode=true } )

-- Sometime later, show the ad
if ( superawesome.isLoaded( myPlacementID ) ) then
    superawesome.show( myPlacementID, { y="bottom" } )
end