admob.show()

类型 函数
返回值 无
修订 2024.3703 版
关键词 广告、广告投放、AdMob、show
另请参阅 admob.hide()
admob.load()
admob.isLoaded()
admob.*

概述

显示之前通过 admob.load() 加载的 AdMob 插页式广告、横幅广告、激励式插页式广告或激励式视频广告。

重要

在尝试显示广告之前，你必须首先通过 admob.load() 加载广告并确认它已准备好显示。有关基本用法详情，请参见下方的 示例。

语法

admob.show( adType [, params] )
adType (必需)

字符串。 以下值之一

  • “interstitial”
  • “banner”
  • “rewardedVideo”
  • “rewardedInterstitial”
  • “appOpen”
params (可选)

表。 包含针对指定广告类型的附加参数的表 — 有关详情，请参见下一部分。

参数参考

params 表包含针对指定广告类型的参数。

y (可选)

字符串 或 数字。 仅适用于横幅广告，指定横幅在屏幕上的 y 轴位置。如果你提供 字符串，有效位置值为 “top” 或 “bottom”。或者，你可以通过在内容坐标系中指定 数字 来设置自定义 y 轴位置，其中 0 表示屏幕顶部边缘，或负值表示从屏幕底边缘到横幅底边缘的偏移量。默认值为 “bottom”。

bgColor (可选)

字符串。 仅适用于横幅广告，指定智能横幅的背景色。该值必须是十六进制 RGB 或 ARGB 值，指定为 “#RRGGBB” 或 “#AARRGGBB”。默认值为 nil，它会将背景渲染为透明。

示例

local admob = require( "plugin.admob" )

-- AdMob listener function
local function adListener( event )

    if ( event.phase == "init" ) then  -- Successful initialization
        -- Load an AdMob interstitial ad
        admob.load( "interstitial", { adUnitId="YOUR_ADMOB_AD_UNIT_ID" } )
    end
end

-- Initialize the AdMob plugin
admob.init( adListener, { appId="YOUR_ADMOB_APP_ID" } )

-- Sometime later, show the interstitial ad
if ( admob.isLoaded( "interstitial" ) ) then
    admob.show( "interstitial" )
end