vungle.show()

类型 函数
返回值 布尔值
版本 发行版 2024.3703
关键词 广告、Vungle
另请参见 vungle.init()
vungle.load()
vungle.*

概览

vungle.show() 开始播放横幅广告全屏视频广告（如果有缓存且可显示）。

此 API 返回布尔值 true 或 false，具体取决于是否有缓存视频广告。

语法

vungle.show( params )
params (要求)

表格。指定广告请求属性的表格 — 有关详细信息，请参见下一节。

参数参考

params 表格包括广告请求的属性。

placementID (要求)

字符串。要显示的广告的横幅 ID。

isAutoRotation (要求)

布尔值。如果为 true（默认值），视频广告将随设备的方向自动旋转。如果为 false，则将使用广告的首选方向。这仅适用于安卓，对于 iOS，它会查看 orientations 键。

orientation (可选)

编号。仅适用于 iOS，带有可能方向值的位掩码。默认值为 UIInterfaceOrientationMaskAll。

isSoundEnabled (可选)

布尔值。如果为 true（默认值），在视频广告播放期间声音将被启用，具体取决于设备的声音设置。如果为 false，视频播放将从静音开始。请注意，用户可以在播放期间静音或取消静音声音。

username (可选)

字符串。此参数仅适用于奖励广告单元类型。指定完成后您希望在服务器到服务器回调中接收的用户标识符，以便奖励用户观看完成的视频广告。

alertTitle, alertText, alertContinue (可选)

字符串。当用户试图在完成前关闭奖励视频时，您可以自定义向其显示的消息。请注意，此设置仅适用于标准 Vungle 广告。对于“动态模板”广告，Vungle 仪表板提供相同的自定义功能。

immersive (可选)

字符串。仅适用于安卓，在 KitKat+ 设备上启用或禁用沉浸模式。

large (可选)

字符串。仅适用于 iOS，绘制更大的按钮来控制广告功能，例如静音或关闭。

示例

local vungle = require( "plugin.vungle" )

local appID, placementID1, placementID2
if ( system.getInfo("platform") == "android" ) then
    appID = "YOUR_ANDROID_APP_ID"
    placementID1 = "YOUR_ANDROID_PLACEMENT_ID_1"
    placementID2 = "YOUR_ANDROID_PLACEMENT_ID_2"
else
    appID = "YOUR_IOS_APP_ID"
    placementID1 = "YOUR_IOS_PLACEMENT_ID_1"
    placementID2 = "YOUR_IOS_PLACEMENT_ID_2"
end

-- Vungle listener function
local function adListener( event )
 
    if ( event.type == "adInitialize" ) then  -- Successful initialization
        print( event.provider )
    end
end

-- Initialize the Vungle plugin
local initParams = appID .. "," .. placementID1 .. "," .. placementID2
vungle.init( "vungle", initParams, adListener )

local adShown = vungle.show( { placementId=placementID1, isSoundEnabled=true } )