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使用和错误处理等内容可参照官方文档或项目内的示例代码。