Google Mobile Ads Unity 插件使用指南
本教程将指导您了解并使用 googleads-mobile-unity
开源项目,这是一个官方Unity插件,用于集成Google移动广告SDK。
1. 项目目录结构及介绍
项目的根目录包含以下主要部分:
-
Assets:此目录包含了所有Unity可以识别的游戏对象、脚本、资源等。在这个案例中,它包括了Google Mobile Ads SDK以及相关的Unity资产。
-
Examples:示例代码目录,展示了如何在Unity项目中实现不同类型的广告。
-
Plugins:放置平台特定的库或插件的地方,这些库是Unity游戏引擎在运行时加载的。
-
Docs(可能缺失):如果存在,这个目录通常包含项目的文档或API参考。
-
README.md:项目的基本说明和安装指示。
-
CONTRIBUTING.md:贡献者指南,描述了如何向项目提交代码。
2. 项目的启动文件介绍
由于googleads-mobile-unity
是一个插件包,没有一个单独的“启动文件”。您需将此项目作为Unity工程的一个依赖来导入。在Unity编辑器中,通过Assets > Import Package > Custom Package
,选择下载解压后的项目中的Assets
目录来导入。
一旦导入成功,可以在Unity场景中创建Ad请求的脚本来启动广告功能。
例如,创建一个C#脚本添加到场景对象上,调用MobileAds.Initialize()
初始化广告系统,然后创建BannerView
或InterstitialAd
实例以展示广告。
using Google.MobileAds;
...
void Start() {
MobileAds.Initialize(initStatus => { });
// 创建广告对象和设置参数的代码在这里...
}
3. 项目的配置文件介绍
该插件主要通过代码配置进行设置,没有特定的配置文件。然而,您可能需要在您的Unity项目设置中进行一些调整,比如确保您支持的目标平台已经设置了正确的API级别,以及在游戏中禁用或者开启测试广告模式。
在Unity的Edit > Project Settings > Player
菜单下,针对每个目标平台(如Android或iOS),您可以在Other Settings
区域找到关于API级别的设置。
为了启用测试广告,在初始化MobileAds
时传递测试设备ID(对于Android,这通常是设备的SHA1指纹的一部分;对于iOS,是设备的UUID):
string testDeviceIds = new string[] {"YOUR_TEST_DEVICE_ID"};
MobileAds.Initialize(initStatus => {}, testDeviceIds);
请注意替换YOUR_TEST_DEVICE_ID
为实际的测试设备ID。
至此,您应该对googleads-mobile-unity
项目有了基本的理解,并能够开始在Unity项目中集成和使用Google移动广告了。更详细的API使用和错误处理等内容可参照官方文档或项目内的示例代码。