企业官网建设流程全解析

1. 项目概述：为什么我们需要一个专门的AdMob插件？

如果你用Godot做过移动端游戏，尤其是面向Android平台，那你肯定绕不开一个现实问题：如何接入广告来变现？Google AdMob是绝大多数开发者的首选，但Godot引擎本身并没有内置的广告模块。这意味着你需要自己动手，把AdMob的SDK“塞”进Godot的Android导出模板里。这个过程听起来简单，实操起来却是一连串的坑：从Android Studio的配置、Gradle依赖的版本冲突，到Java/Kotlin与GDScript之间的通信桥接，每一步都可能让你头疼半天。

这就是像Shin-NiL的Godot AdMob Android插件（以及其前身poingstudios的项目）存在的核心价值。它不是一个简单的脚本集合，而是一个完整的、经过封装的基础设施。它的目标很明确：让Godot开发者能以最接近GDScript的思维方式和操作习惯，在Android平台上调用AdMob的所有核心功能，而无需深入Android原生开发的泥潭。你不再需要关心build.gradle该怎么写，不需要处理AndroidManifest.xml的权限声明，甚至不需要打开Android Studio。你只需要在Godot编辑器里安装插件，写几行直观的GDScript，广告就能在你的游戏里跑起来。

我经历过从零开始手动集成的痛苦，也用过几个早期的、不稳定的插件版本。所以当我看到这类插件逐渐成熟，支持了横幅、插页、激励视频等多种广告格式，甚至集成了GDPR合规的UMP（用户消息平台）和广告中介（Mediation）时，我知道这对于独立开发者和小团队来说，节省的不仅仅是时间，更是降低了整个项目的技术风险和后期维护成本。接下来，我就带你彻底拆解这个集成方案，从原理到实操，再到那些只有踩过坑才知道的细节。

2. 插件架构与核心原理拆解

要理解这个插件怎么用，首先得明白它在你不知道的背后做了什么。它本质上是一个“双向桥接器”，在Godot的GDScript运行时和Android的Java/Kotlin原生环境之间建立了一条高速公路。

2.1 核心通信机制：Godot的Android插件接口

Godot为Android平台提供了完善的插件扩展机制。一个标准的Godot Android插件包含以下几个核心部分：

1. GodotPlugin类（Kotlin/Java）：这是插件在Android端的入口。它继承自Godot引擎提供的GodotPlugin基类，负责在Android应用启动时初始化，并向Godot引擎注册可供GDScript调用的“原生方法”。
2. GDScript包装层：这是你在Godot编辑器中直接操作的脚本。它提供了一套友好的、面向对象的API（例如AdMobBanner、AdMobInterstitial类）。当你调用banner.load()时，这个GDScript层实际上是通过Godot的Engine.get_singleton()方法，找到了在Android端注册好的那个插件单例，然后发起了一个跨语言调用。
3. config.gd配置文件：一个关键的GDScript配置文件，通常用于存放你的AdMob应用ID（App ID）和各个广告单元的ID（Ad Unit ID）。插件会在初始化时读取这里的配置。
4. Android库依赖声明：插件包内会包含一个build.gradle文件或已经编译好的AAR库，其中声明了对官方com.google.android.gms:play-services-ads（AdMob SDK）以及其他中介平台SDK（如Meta Audience Network）的依赖。这样，当你导出APK时，Gradle会自动处理好这些依赖关系。

这个架构的精妙之处在于隔离性。作为游戏逻辑开发者，你99%的时间只需要和GDScript层打交道，用你熟悉的语法控制广告。而所有Android平台特有的、繁琐的、易错的配置和初始化工作，都被封装在了底层的Kotlin/Java代码里。

2.2 插件的工作流程解析

让我们跟踪一次广告加载的完整内部流程：

1. 初始化：在游戏启动的某个场景（通常是根场景）的_ready()函数中，你调用AdMob.initialize()。GDScript层将这个调用传递给Android插件。
2. 原生端初始化：Android插件收到指令后，在其onMainInitialize回调中，使用你配置的APPLICATION_ID，调用Google Mobile Ads SDK的MobileAds.initialize()方法。同时，如果配置了UMP，它会在这里启动GDPR合规性检查流程。
3. 创建广告对象：你在GDScript中实例化一个AdMobBanner，并设置其ad_unit_id和size。这个对象在GDScript内存中被创建，并持有对Android端对应广告对象的一个引用句柄。
4. 加载广告：你调用banner.load()。GDScript层通过插件接口，通知Android端：“请为句柄XXX对应的横幅广告加载广告单元ID为YYY的广告”。
5. SDK执行：Android插件创建原生的AdView对象，配置尺寸、位置，发起广告请求。整个过程在原生线程进行，不阻塞Godot的主线程。
6. 事件回调：当广告加载成功、失败、被点击或展示时，AdMob SDK会触发事件。Android插件捕获这些事件，并通过Godot的信号（Signal）机制，反向传递回GDScript层。
7. GDScript响应：你在GDScript中连接的信号（如banner.ad_loaded）被触发，你便可以更新UI（如显示横幅）或发放奖励（针对激励视频）。

关键理解：整个过程中，广告的渲染、点击交互完全由Android原生视图系统处理。Godot引擎渲染的是你的游戏画面，而广告视图是叠加在其上的一个独立图层。插件负责管理这个图层的生命周期（创建、显示、隐藏、销毁）和与游戏逻辑的同步。

3. 从零开始的完整集成与配置指南

理论讲完了，我们动手把它装进项目。这里我以当前社区中较为活跃的godot-admob-plugin（即poingstudios迁移后的monorepo项目）为例，因为它是原始godot-admob-android仓库的演进方向，支持更统一的管理。步骤适用于Godot 4.2及以上版本。

3.1 前期准备：不可或缺的三要素

在开始拖拽插件之前，请确保你手头有这三样东西，缺一不可：

1. Godot项目：一个已经可以正常在桌面上运行的游戏项目。先确保核心玩法没问题，再考虑加广告。
2. AdMob账号与广告单元：
   • 访问Google AdMob网站，创建一个账号（如果还没有）。
   • 在AdMob中创建一个“应用”。这里你会获得一个应用ID，格式类似ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy。这是整个广告系统的钥匙。
   • 为你需要的广告类型创建广告单元：
     • 横幅广告：获取其广告单元ID，格式如ca-app-pub-xxxxxxxxxxxxxxxx/zzzzzzzzzz。
     • 插页广告：同样获取其ID。
     • 激励视频广告：获取其ID。
   • 重要提示：测试期间，请务必使用AdMob提供的测试广告单元ID，避免因点击自家广告导致账号被封。例如，Android横幅的测试ID是ca-app-pub-3940256099942544/6300978111。
3. 配置Android导出模板：
   • 在Godot编辑器中，进入项目 -> 导出。
   • 添加Android导出预设。
   • 你必须填写或生成调试密钥库（Debug Keystore）。Godot可以一键生成。发布时则需要你自己保管好正式的密钥库文件。
   • 在导出 -> 选项中，确保屏幕 -> 支持屏幕至少勾选了横向或纵向（根据你的游戏设定）。
   • 在权限中，插件通常会自动添加INTERNET和ACCESS_NETWORK_STATE权限，但最好检查一下。

3.2 插件安装的两种路径

方法一：通过AssetLib安装（推荐给绝大多数开发者）

这是最无痛的方式，适合快速启动和原型验证。

1. 在Godot编辑器中，点击顶部的AssetLib选项卡。
2. 在搜索框输入“AdMob”。你应该能找到名为“AdMob Plugin”的资产，作者通常是Poing Studios。
3. 点击下载，然后安装到你的项目。安装路径通常默认为res://addons/admob/。
4. 安装完成后，进入项目 -> 项目设置 -> 插件。找到“AdMob”插件并将其状态改为启用。

方法二：手动下载与安装（适合需要特定版本或研究源码）

有时AssetLib的版本可能不是最新的，或者你想研究插件源码。

1. 访问插件的GitHub仓库（例如github.com/poingstudios/godot-admob-plugin）。
2. 在Releases页面，找到与你Godot引擎版本匹配的发布包。通常文件名会包含Godot版本号，如poing-godot-admob-plugin-v4.6.0.zip。
3. 下载ZIP文件，解压。
4. 将解压后得到的addons文件夹整体复制到你Godot项目的根目录下（与project.godot文件同级）。如果提示合并，选择是。
5. 同样，进入项目 -> 项目设置 -> 插件，启用AdMob插件。

安装后验证：启用插件后，你会在Godot编辑器顶部菜单栏看到一个新的“AdMob”菜单项。点击它，如果出现“Download Manager”等子菜单，说明插件核心已成功加载。同时，在文件系统面板中，你应该能看到res://addons/admob/目录，里面包含了android、ios、plugin等子文件夹。

3.3 核心配置：填写你的密钥

插件安装好后，它还不知道你的AdMob信息。配置的核心在于修改res://addons/admob/android/config.gd这个文件。

用Godot的脚本编辑器打开这个文件，你会看到类似以下的结构：

extends Node class_name AdMobConfig const PLUGIN_NAME = "GodotAdMob" # ！！！ 这里必须改成你的AdMob应用ID ！！！ const APPLICATION_ID = "ca-app-pub-3940256099942544~3347511713" # 这是测试ID # 各广告单元的ID也在这里预定义，方便管理 const BANNER_AD_UNIT_ID = "ca-app-pub-3940256099942544/6300978111" const INTERSTITIAL_AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712" const REWARDED_AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917" const REWARDED_INTERSTITIAL_AD_UNIT_ID = "ca-app-pub-3940256099942544/5354046379"

你需要做的是：

1. 将APPLICATION_ID的值替换成你在AdMob后台创建的真实应用ID（上线前再替换为正式ID，开发时可用测试ID）。
2. 将其下的各个*_AD_UNIT_ID替换成你为对应广告类型创建的真实广告单元ID。同样，强烈建议开发阶段使用上面注释中给出的Google官方测试ID。这些测试ID会返回真实的广告格式但不会产生收益，是安全测试的保障。

配置的深层逻辑：为什么要把ID写在GDScript里，而不是Android的原生配置文件中？这体现了Godot插件设计的“以Godot为中心”的思想。所有游戏相关的配置，尽可能在Godot工程内完成，实现跨平台配置的统一管理。当你需要为iOS平台配置时，你会发现思路是完全一致的，只是修改ios/config.gd文件而已。

3.4 启用Android自定义构建

这是让插件生效的最关键一步，也是新手最容易遗漏的一步。Godot默认的Android导出模板是“纯净版”，不包含任何第三方插件。你必须启用“自定义构建”，让Godot在导出时，将插件代码打包进APK。

1. 进入项目 -> 导出，选中你配置好的Android预设。
2. 在右侧的导出选项列表中，找到架构 -> 使用自定义构建。
3. 勾选这个复选框。
4. 当你第一次勾选时，Godot会提示你需要下载或构建自定义导出模板。点击“是”，Godot会自动处理。这个过程可能需要下载一些组件，请保持网络通畅。

为什么必须这么做？勾选“自定义构建”后，Godot的导出流程会发生本质变化：它会将你的项目代码、以及addons目录下已启用的插件及其原生依赖（如.aar文件、AndroidManifest补丁）一起编译，生成一个融合了所有功能的自定义Android应用模块。如果不勾选，插件中的Android原生代码根本不会被包含进最终的APK。

4. GDScript API详解与广告生命周期管理

配置妥当，终于可以写代码了。插件的GDScript API设计得非常直观，我们按广告类型来逐一拆解。

4.1 横幅广告：常驻的展示位

横幅广告通常出现在屏幕顶部或底部。它的生命周期是“加载一次，显示/隐藏多次”。

extends Node2D # 或 Control，取决于你的UI系统 var banner_ad func _ready(): # 1. 初始化AdMob SDK（整个应用只需一次，通常在游戏启动时调用） var admob = Engine.get_singleton("AdMob") if admob: admob.initialize() print("AdMob Initialized") # 2. 创建横幅广告实例 banner_ad = AdMobBanner.new() # 3. 配置广告属性 banner_ad.ad_unit_id = AdMobConfig.BANNER_AD_UNIT_ID # 使用config.gd中的ID banner_ad.size = AdMobBanner.SMART_BANNER # 尺寸枚举：BANNER, LARGE_BANNER, MEDIUM_RECTANGLE, FULL_BANNER, LEADERBOARD, SMART_BANNER # 4. 连接信号，监听广告状态 banner_ad.ad_loaded.connect(_on_banner_ad_loaded) banner_ad.ad_failed_to_load.connect(_on_banner_ad_failed_to_load) banner_ad.ad_opened.connect(_on_banner_ad_opened) banner_ad.ad_closed.connect(_on_banner_ad_closed) # 5. 加载广告 banner_ad.load() func _on_banner_ad_loaded(): print("Banner Ad Loaded!") # 广告加载成功后，再将其显示出来 banner_ad.show() func _on_banner_ad_failed_to_load(error_code: int): print("Banner failed to load with error: ", error_code) # 可以在这里实现重试逻辑，例如等待几秒后再次调用 banner_ad.load() func _on_banner_ad_opened(): print("Banner clicked, user is viewing ad content.") # 可以在这里暂停游戏音乐或逻辑 func _on_banner_ad_closed(): print("User returned from the ad.") # 在这里恢复游戏音乐或逻辑 # 在需要隐藏横幅时（如进入无广告的关卡） func hide_banner(): if banner_ad: banner_ad.hide() # 在需要彻底移除横幅时（如切换场景前） func _exit_tree(): if banner_ad: banner_ad.destroy() # 销毁广告对象，释放资源

关键点解析：

• SMART_BANNER：这是一个智能横幅尺寸，它会根据设备的屏幕宽度自动调整高度，在不同设备上能有较好的展示效果，推荐使用。
• 加载与显示的分离：load()是向AdMob服务器请求广告内容。show()是将已经加载好的广告视图展示在屏幕上。通常先load()，在ad_loaded信号中再调用show()。
• 销毁：当广告节点不再需要时（例如切换到一个完全没有广告的场景），调用destroy()非常重要。它会释放原生端的广告对象，避免内存泄漏。

4.2 插页广告：时机就是一切

插页广告是全屏广告，会在游戏自然断点处展示，如关卡结束、菜单切换时。它的使用模式是“预加载，适时展示”。

extends Node var interstitial_ad func _ready(): # 初始化AdMob... # 创建并预加载插页广告 interstitial_ad = AdMobInterstitial.new() interstitial_ad.ad_unit_id = AdMobConfig.INTERSTITIAL_AD_UNIT_ID interstitial_ad.ad_loaded.connect(_on_interstitial_loaded) interstitial_ad.ad_failed_to_load.connect(_on_interstitial_failed) interstitial_ad.ad_dismissed.connect(_on_interstitial_dismissed) # 用户关闭广告 # 立即开始加载第一个插页广告 interstitial_ad.load() func _on_interstitial_loaded(): print("Interstitial is ready to show!") # 可以将一个标志位设为true，允许在下一个断点展示广告 Global.can_show_interstitial = true func _on_interstitial_failed(error_code: int): print("Interstitial load failed: ", error_code) # 可以设置一个延迟重试，例如5秒后 await get_tree().create_timer(5.0).timeout interstitial_ad.load() func _on_interstitial_dismissed(): print("Interstitial was closed.") # 广告关闭后，立即开始加载下一个，为下次展示做准备 interstitial_ad.load() Global.can_show_interstitial = false # 在游戏的自然断点处调用，例如关卡胜利后 func show_interstitial_at_breakpoint(): if Global.can_show_interstitial and interstitial_ad: # 在展示前，可以暂停游戏 get_tree().paused = true interstitial_ad.show() else: print("Interstitial not ready yet, skipping.") # 注意：广告展示期间，游戏线程可能被暂停（取决于AdMob SDK和系统）， # 广告关闭后，需要在 `_on_interstitial_dismissed` 中恢复。

插页广告的最佳实践：

• 预加载策略：广告加载需要时间（几百毫秒到几秒不等）。永远不要在需要展示的瞬间才去加载。应该在广告关闭后（ad_dismissed）或游戏启动后立即加载下一个，使其始终处于“待命”状态。
• 展示频率控制：不要滥用插页广告，否则会严重影响用户体验。可以设计规则，如“每通过3个关卡展示一次”，或“仅在玩家主动退出时展示”。这需要你在游戏逻辑中实现计数器或状态判断。
• 生命周期绑定：插页广告对象建议放在一个全局的、常驻的Autoload单例中，而不是某个具体场景里。这样它的加载状态可以在整个游戏生命周期内保持。

4.3 激励视频广告：用奖励换取用户时间

激励视频是变现效率最高的广告形式之一，用户选择观看以获取游戏内奖励（如金币、复活机会、道具）。其核心逻辑是“请求 -> 展示 -> 验证 -> 发放奖励”。

extends Node var rewarded_ad func _ready(): # 初始化AdMob... rewarded_ad = AdMobRewarded.new() rewarded_ad.ad_unit_id = AdMobConfig.REWARDED_AD_UNIT_ID # 激励视频有更多关键信号 rewarded_ad.ad_loaded.connect(_on_rewarded_loaded) rewarded_ad.ad_failed_to_load.connect(_on_rewarded_failed) rewarded_ad.ad_opened.connect(_on_rewarded_opened) rewarded_ad.ad_closed.connect(_on_rewarded_closed) # 最重要的信号：用户观看完毕，应得奖励 rewarded_ad.user_earned_reward.connect(_on_user_earned_reward) rewarded_ad.ad_failed_to_show.connect(_on_rewarded_failed_to_show) rewarded_ad.load() func _on_rewarded_loaded(): print("Rewarded video is ready!") # 可以更新UI按钮状态，变为可点击 $RewardButton.disabled = false func _on_user_earned_reward(reward_type: String, reward_amount: int): print("Reward earned! Type: %s, Amount: %d" % [reward_type, reward_amount]) # ！！！ 必须在这里发放游戏奖励 ！！！ Global.player_coins += reward_amount # 更新UI update_coin_display() # 奖励发放后，立即重新加载下一个激励视频 rewarded_ad.load() $RewardButton.disabled = true # 重新禁用按钮，直到下次加载完成 func _on_rewarded_closed(): print("Rewarded video closed.") # 注意：奖励可能在广告关闭前或关闭后通过 `user_earned_reward` 发放。 # 这里通常用于恢复游戏状态，但发放奖励的逻辑必须在 `user_earned_reward` 信号中处理。 # 当玩家点击“观看广告获取金币”按钮时 func _on_reward_button_pressed(): if rewarded_ad: # 并且可以添加一个 is_loaded 的状态检查 # 暂停游戏背景音乐或逻辑 pause_game() rewarded_ad.show()

激励视频的严谨流程：

1. 预加载：同插页广告，尽早加载。
2. 用户选择：提供一个明确的按钮（如“观看广告获得50金币”），仅在广告加载成功(ad_loaded) 后才将其设为可点击状态。避免用户点击后无广告可看。
3. 展示广告：调用show()。
4. 奖励验证与发放：这是最关键的一步。奖励发放的逻辑必须且只能放在user_earned_reward信号的连接函数里。这个信号是AdMob SDK确认用户已经完整观看了广告的可靠回调。绝对不要在ad_closed信号里直接发奖励，因为用户可能中途关闭广告，并未完成观看。
5. 重新加载：在发放奖励后，立即调用load()为下一次展示做准备。

5. 高级特性与实战避坑指南

掌握了基础API，你的广告已经能跑了。但要做得专业、稳定、合规，还需要了解下面这些高级特性和我踩过的坑。

5.1 GDPR与UMP合规集成

如果你的游戏面向欧洲经济区（EEA）用户，必须遵守GDPR，在展示个性化广告前获取用户同意。AdMob通过用户消息平台（UMP）来简化这个流程。幸运的是，这个插件已经集成了UMP。

配置与使用：

1. 在AdMob后台配置UMP：在AdMob控制台的“隐私与消息”部分，创建并获取你的UMP调试ID（用于测试）和正式ID。
2. 在插件中启用UMP：通常需要在config.gd或一个专门的UMP配置脚本中设置你的UMP App ID。
3. 在初始化AdMob前请求同意：最佳实践是在游戏启动的最早期，甚至在初始化AdMob SDK之前，就请求用户同意。

# 假设插件提供了UMP的GDScript接口 var ump_consent func request_consent(): ump_consent = AdMobUMP.new() ump_consent.consent_info_updated.connect(_on_consent_info_updated) ump_consent.consent_form_dismissed.connect(_on_consent_form_dismissed) # 启动同意信息请求。参数可以是调试ID（测试用）或正式ID。 var debug_settings = {"testDeviceHashedId": "你的测试设备HASH", "debugGeography": "EEA"} # 仅用于测试 ump_consent.request_consent_info_update(AdMobConfig.UMP_APP_ID, debug_settings) func _on_consent_info_updated(): var status = ump_consent.get_consent_status() if status == ump_consent.CONSENT_STATUS_REQUIRED: # 需要向用户展示同意表单 ump_consent.load_consent_form() ump_consent.show_consent_form() elif status == ump_consent.CONSENT_STATUS_NOT_REQUIRED: # 不需要同意（例如用户不在EEA） initialize_ads() elif status == ump_consent.CONSENT_STATUS_OBTAINED: # 已有同意状态，可以直接初始化广告 initialize_ads() else: # 其他状态（如未知），可以按“未同意”处理，初始化非个性化广告 initialize_ads(false) func _on_consent_form_dismissed(): # 表单关闭后，重新获取状态并初始化广告 var status = ump_consent.get_consent_status() initialize_ads(status == ump_consent.CONSENT_STATUS_OBTAINED) func initialize_ads(allow_personalized: bool = true): var admob = Engine.get_singleton("AdMob") if admob: # 插件可能提供一个初始化参数来设置是否请求个性化广告 admob.initialize(allow_personalized)

合规要点：在测试阶段，务必使用UMP的调试模式和测试设备ID，确保你能看到同意表单。上线前移除调试设置。

5.2 广告中介配置

广告中介（Mediation）允许AdMob作为“经理”，同时从多个广告网络（如Meta Audience Network, Unity Ads, Vungle等）获取广告，从而提高填充率和收益。插件通常支持通过配置来集成中介。

如何操作：

1. 在AdMob后台设置中介：在AdMob中你的应用下，添加中介组，并配置像Meta这样的广告网络。AdMob会提供每个网络所需的SDK集成指南（但插件可能已封装）。
2. 在插件中配置额外依赖：对于某些中介（如Meta），你可能需要在插件的Android构建配置（例如addons/admob/android/build.gradle）中添加额外的依赖库。这通常是手动集成中最复杂的一步，但像poingstudios的插件，可能已经内置了对主流中介的支持，你只需要在AdMob后台开启即可。
3. 更新适配器：中介网络的SDK和适配器经常更新。你需要关注插件的Release Notes，及时更新插件版本以获得最新的中介适配器，保证收益最大化。

5.3 实战中遇到的典型问题与排查

以下是我和社区开发者们常遇到的问题及解决方法：

问题1：导出APK后，游戏崩溃，Logcat报错ClassNotFoundException或NoSuchMethodError。

• 原因：这是最典型的依赖冲突或版本不匹配。Godot自带的Android模板、AdMob插件、以及其他第三方插件可能引入了不同版本的相同Android支持库（如androidx.core:core）。
• 排查：
  • 检查插件文档，确认其支持的Godot最低版本和AdMob SDK版本。
  • 如果你使用了其他Android插件（如Firebase、应用内购），尝试暂时禁用它们，看广告是否正常。逐步排查冲突源。
  • 查看ADB Logcat的完整错误堆栈，找到具体缺失的类或方法。
• 解决：
  • 确保你使用的插件版本与你的Godot引擎版本严格匹配。
  • 尝试更新所有插件到最新版本。
  • 在极端情况下，可能需要手动修改插件的build.gradle文件，强制指定某个库的版本（resolutionStrategy），但这需要一定的Gradle知识。

问题2：广告无法加载，回调错误码3 (ERROR_CODE_NO_FILL)。

• 原因：AdMob没有返回广告。对于新创建的应用和广告单元，这是正常现象，因为系统需要时间学习和匹配广告。
• 排查与解决：
  • 使用测试ID：确保开发阶段使用Google提供的测试广告单元ID。
  • 检查网络：确保测试设备可以访问互联网。
  • 等待与请求：新广告单元可能需要几小时甚至一两天才有广告填充。你可以尝试在AdMob后台手动发送广告请求来加速学习。
  • 检查配置：确认应用ID和广告单元ID没有填错，应用状态是“已发布”。

问题3：激励视频观看完成后，user_earned_reward信号没有触发。

• 原因：这是最严重的Bug之一，会导致用户无法获得奖励，极大损害信誉。
• 排查：
  • 首先，100%确认奖励发放代码是写在user_earned_reward信号回调函数里的，而不是ad_closed。
  • 使用测试广告单元ID进行测试，正式ID在未上线时可能无填充。
  • 检查Logcat，看AdMob SDK是否有相关错误日志。
• 解决：
  • 确保插件是最新版本，旧版本可能存在信号传递的Bug。
  • 简化测试场景：创建一个只有激励视频按钮的纯净场景，排除其他代码干扰。
  • 在ad_closed和user_earned_reward信号中都打印日志，确认它们的触发顺序和条件。

问题4：在特定Android设备或系统版本上崩溃。

• 原因：可能是插件中使用的某个Android API在该版本上不可用，或者设备架构（如x86）不支持。
• 解决：
  • 在插件的build.gradle中，检查minSdkVersion和targetSdkVersion。确保你的游戏export_presets.cfg中的min_sdk不低于插件的要求。
  • 如果你需要支持x86架构的模拟器或老旧设备，确保插件提供了相应的原生库（.so文件），或者你的游戏设置中未包含这些架构。

问题5：广告展示位置不对或遮挡UI。

• 原因：横幅广告的定位问题。
• 解决：AdMobBanner类通常提供position属性（如TOP，BOTTOM）或set_position(x, y)方法。在调用show()之前设置好位置。对于SMART_BANNER，通常只需指定顶部或底部即可，宽度会自动适配。

6. 性能优化与测试策略

接入广告不是一锤子买卖，为了更好的用户体验和收益，你需要持续优化。

6.1 内存与性能优化

• 广告对象的单例化管理：避免在每个场景都创建新的广告实例。将广告管理器（包含横幅、插页、激励视频实例）做成一个AutoLoad单例。这样广告在整个游戏生命周期内只加载一次，节省网络请求和内存。
• 及时销毁：对于横幅广告，如果某个场景确定不需要（如付费去广告版本的核心玩法场景），在离开前调用destroy()。对于插页和激励视频，由于其预加载特性，通常常驻内存即可。
• 加载时机：不要在游戏性能关键路径（如战斗场景加载、复杂计算时）初始化或加载广告。可以在游戏启动后的加载界面、或者主菜单空闲时进行初始化。
• 中介网络的选择：只集成你真正需要的、收益高的中介网络。每增加一个中介SDK，都会增加APK大小和内存占用。

6.2 全面的测试方案

1. 单元测试（逻辑）：为你的广告管理GDScript编写测试脚本，模拟信号的触发，确保奖励发放、状态切换等逻辑正确。
2. 集成测试（真机）：
   • 使用测试ID：全程使用Google的测试广告单元ID，避免无效点击。
   • 测试不同网络环境：在Wi-Fi、4G/5G以及弱网环境下测试广告加载、超时和失败处理。
   • 测试中断场景：在广告加载和展示过程中，接听电话、切换App、锁屏，观察恢复后广告和游戏状态是否正常。
   • 测试激励视频完整性：观看一半关闭，是否不发奖励？完整观看，奖励是否准确到账？
3. UMP合规测试：
   • 使用UMP调试参数，模拟位于EEA和非EEA地区，确保同意表单能正确弹出和消失。
   • 测试用户拒绝同意后，是否只展示非个性化广告（或没有广告）。
4. 发布前检查清单：
   • [ ] 应用ID和广告单元ID已从测试ID切换为正式ID。
   • [ ] UMP调试参数已移除。
   • [ ] 所有中介网络已正确配置并测试。
   • [ ] 广告频率和位置符合用户体验设计，不会引起反感。
   • [ ] 在Google Play Console的“政策状态”中，广告权限已正确声明。

最后，记住广告是游戏体验的一部分，而不是入侵者。平衡好收益与用户体验，用数据（AdMob后台的报告）说话，不断调整广告展示策略，才是长期健康的变现之道。这个插件提供了强大的工具，但如何用好它，取决于你的设计和考量。