跳转至

AdView

AdView 类负责创建、加载、定位和显示横幅广告。

Constructors

_init / AdView

初始化 AdView 类的新实例。

func _init(ad_unit_id: String, ad_size: AdSize, ad_position: AdPosition) -> void

用法： 

var ad_view := AdView.new("ca-app-pub-3940256099942544/6300978111", ad_size, ad_position)


public AdView(string adUnitId, AdSize adSize, AdPosition adPosition)

用法： 

AdView adView = new AdView("ca-app-pub-3940256099942544/2934735716", adSize, adPosition);

Properties

ad_listener / AdListener

接收各种广告加载和生命周期回调的监听器对象。请参阅 AdListener。

var ad_listener: AdListener

用法： 

ad_view.ad_listener.on_ad_loaded = func():
    print("Ad loaded successfully!")


public AdListener AdListener { get; set; }

用法： 

adView.AdListener.OnAdLoaded = () => {
    GD.Print("Ad loaded successfully!");
};

on_ad_paid / OnAdPaid

在发生展示并计算广告价值（收入）时触发的回调。接收一个 AdValue。

var on_ad_paid: Callable # 接收 AdValue

用法： 

ad_view.on_ad_paid = func(ad_value: AdValue):
    print("Ad revenue generated: ", ad_value.value_micros)


public Action<AdValue> OnAdPaid { get; set; }

用法： 

adView.OnAdPaid = (adValue) => {
    GD.Print($"Ad revenue generated: {adValue.ValueMicros}");
};

Methods

load_ad / LoadAd

根据请求配置加载广告。

func load_ad(ad_request: AdRequest) -> void

用法： 

var ad_request := AdRequest.new()
ad_view.load_ad(ad_request)


public void LoadAd(AdRequest adRequest)

用法： 

AdRequest adRequest = new AdRequest();
adView.LoadAd(adRequest);

destroy / Destroy

销毁横幅并释放其原生资源。

func destroy() -> void

public void Destroy()

get_response_info / GetResponseInfo

返回有关已加载广告的响应信息和中介元数据。

func get_response_info() -> ResponseInfo

public ResponseInfo GetResponseInfo()

show / Show

在屏幕上显示横幅广告。

func show() -> void

public void Show()

hide / Hide

从屏幕上隐藏横幅广告。

func hide() -> void

public void Hide()

set_position / SetPosition

为横幅广告设置新位置。

func set_position(ad_position: AdPosition) -> void

public void SetPosition(AdPosition adPosition)

get_width / GetWidth

返回广告的宽度，单位为与密度无关的像素 (dp)。

func get_width() -> int

public int GetWidth()

get_height / GetHeight

返回广告的高度，单位为与密度无关的像素 (dp)。

func get_height() -> int

public int GetHeight()

get_width_in_pixels / GetWidthInPixels

返回广告的物理屏幕像素宽度。

func get_width_in_pixels() -> int

public int GetWidthInPixels()

get_height_in_pixels / GetHeightInPixels

返回广告的物理屏幕像素高度。

func get_height_in_pixels() -> int

public int GetHeightInPixels()

is_collapsible / IsCollapsible

返回加载的横幅广告是否为折叠式横幅。

func is_collapsible() -> bool

public bool IsCollapsible()