重要！广告按钮更新指南

在032版本上，我们新增了一个UI控件——广告按钮。这个广告按钮将取代当前的showAd()函数，作为请求广告的新方式。
请注意，从下一个版本开始，showAd()将被废弃并禁用，请各位开发者尽快修改工程中的广告逻辑。

广告按钮功能详情请见：UI 控件-广告按钮 | 产品手册

为什么要新增广告按钮？
在032版本之前，我们的广告可以通过直接调用showAd来播放，这导致在某些游戏中广告的弹出可能过于频繁（例如，进入某个区域就会直接弹出广告等），并且这些无预警的广告可能违反了用户的预期，存在合规风险。为了确保平台广告的合规性，并为你们的游戏吸引更多的用户，我们决定将广告功能封装在一个样式相对固定的UI控件上，同时废弃之前的showAds接口。这样，只有点击了含有广告图标的按钮才会触发广告，这既可以保障广告的合规性，也有助于提升我们游戏的形象，吸引更多的玩家。

如何调整广告逻辑
在032版本之前，广告的逻辑与按钮逻辑是分离的，因此可能会出现以下三种场景：
若是使用EasyPrefabs的训练营同学，可以直接看第三条：使用了预制体EasyPrefabs的AdsPrefab
建议使用VScode的全局搜索功能，查找工程中所有的showAd，通过下列方法替换。防止修改遗漏

1. 原本无广告按钮或原本广告逻辑较为复杂
在旧版本中，如果你的广告逻辑是通过其他方式触发的（例如触发器），那么你需要新建一个确认观看广告的UI界面，添加广告按钮组件，并将原来的观看广告逻辑迁移到广告按钮中。同时，如果原本的广告按钮实现逻辑较复杂，也可以直接使用预制体替换，使用预制体替换仅需修改少量代码即可，无需修改广告展示逻辑。
例如，原来的逻辑是进入一个触发器后播放广告，如果成功播放完广告就给角色换装：

若原来没有确认播放广告的界面，那么在这次更新后，需要新建一个页面来询问玩家是否要观看广告。为此，我们提供了一个广告界面的预制体。可以用过调用API，快速实现创建广告界面的功能。并且使用预制体仅需简单代码替换即可实现

更新步骤：

点击下载预制体=》 AdsPrefab.zip (10.33 KB, 下载次数: 72)

2024-5-6 18:06 上传

点击文件名下载附件

1. 点击编辑器工程内容下的“资源导入”按钮，选择刚刚下载好的预制体，将预制体中所有文件全部导入

预制体只需导入即可，无需放入场景中

2. 预制体中包含了一个静态方法，你可以在客户端调用AdsPanel.showAdsPanel()来直接展示确认观看广告的界面。具体用法如下：

当展示广告确认页面时，会自动判断当前广告是否已经准备好，如果没有准备好，广告按钮将被隐藏

3. 导入预制体后，你可以将原来showAd()的逻辑用AdsPanel.showAdsPanel()来替代。例如：

4. 替换结束后，你就成功的给广告添加了确认播放界面。接下来就可以进入游戏来测试广告窗口了

广告按钮的真实表现需要在手机端设置“广告接入”后进行测试，详情请见商业化指南

2. 原本就存在广告确认按钮
在旧版本中，如果你的逻辑中已经存在一个用于确认广告的按钮，例如：

那么在脚本中的逻辑则大致为：
按下确认按钮后，通过 AdsService.isReady 判断广告是否准备好后，使用 showAd 请求广告，类似于下面这种情况：

更新步骤：
1. 将新的广告按钮拖入广告UI中，并使用以小写字母开头的名称重命名广告按钮控件


2. 保存UI，然后导出所有脚本


3. 打开UI脚本，将原来确认按钮中的逻辑转移到新的广告按钮中

4. 至此，我们已经完成了广告按钮逻辑的迁移，接下来只需要删除原有的确认按钮和showAd方法即可

请注意，原本showAd方法中的第一个参数AdsType实际上并不起作用（只有激励广告类型是有效的），因此在这次升级中我们删除了这个参数。现在，按下广告按钮将默认播放激励广告。

3. 使用了预制体EasyPrefabs的AdsPrefab

在旧版本中，如果你的广告逻辑使用了官方提供的EasyPrefabs，则你可以在官网下载最新的广告预制体=》【EasyPrefab系列】广告组件 - 口袋方舟论坛 (ark.online)

更新步骤：

1. 导入最新版本的广告预制体

2. 在预制体导入界面选择"覆盖"，并点击导入按钮

3. 替换结束后，就可以正常使用AdsPrefab中的广告功能了

常见问题&注意事项

1. 广告按钮必须在脚本中至少调用一次 onClose/onShow 才能正常触发广告按钮点击逻辑

2. 广告钮整体任何一个地方如果被可见的 UI 控件遮挡或超出屏幕可见范围，广告按钮都将不生效，此时在 PIE 上点击按钮将会有“AdsButton is Occlued”或者“AdsButton is out of screen!”的报错。例如：

广告按钮被遮挡：

报错如下：


广告按钮超出显示框：

报错如下：


3. onShow的回调触发时机为：
玩家点击按钮=》自动确认广告是否准备好=》触发 onShow 回调，所以 onShow 执行的时候广告不一定能正常播放，需要判断 onShow 触发了回调并且回调值为 true 时才能确认成功开始播放广告。

太好用了，正愁不会换呢

虾尾酱 发表于 2024-5-7 10:57
太好用了，正愁不会换呢