Game Frame X 广告系统的支付宝小游戏平台适配器。为发布到支付宝小游戏平台的游戏提供激励视频广告集成。
- 基于支付宝 SDK 的激励视频广告支持
- 自动加载广告，展示失败自动重试
- IL2CPP 代码裁剪保护
- 条件编译（
ENABLE_ALIPAY_MINI_GAME、ENABLE_ALIPAY_MINI_GAME_ADVERTISEMENT） - 与 Game Frame X 广告组件无缝集成
本包是 Game Frame X 广告核心 BaseAdvertisementManager 的适配器实现。通过 Unity Inspector 配置 AdvertisementComponent 后，自动发现并加载。
| 类 | 说明 |
|---|---|
AliPayMiniGameAdvertisementManager | 激励视频广告管理器 — 加载、展示及生命周期管理 |
AliPayVideoAdCallback | 广告加载/展示事件回调处理器 |
GameFrameXAdvertisementAliPayMiniGameCroppingHelper | IL2CPP link.xml 替代方案 — 保留类型引用 |
- 安装广告核心包
- 通过 Unity Package Manager (UPM) 添加本适配器：
{
"dependencies": {
"com.gameframex.unity.advertisement": "https://github.com/GameFrameX/com.gameframex.unity.advertisement.git",
"com.gameframex.unity.advertisement.alipayminigame": "https://github.com/GameFrameX/com.gameframex.unity.advertisement.alipayminigame.git"
}
}
或在 Unity Package Manager 窗口中通过 git URL 添加。
在 Unity Inspector 中配置：将 AdvertisementComponent 添加到 GameObject，然后在实现类型下拉框中选择 AliPayMiniGameAdvertisementManager。
using GameFrameX.Advertisement.Runtime;
// 标准方式：通过 GameEntry（不依赖 com.gameframex.unity.entry）
var adComponent = GameEntry.GetComponent<AdvertisementComponent>();
adComponent.SetExtraData("userId", player.UserId);
var option = new AdvertisementPlayOption
{
OnSuccess = (data) => Debug.Log("广告展示成功"),
OnFail = (err) => Debug.LogError($"广告展示失败: {err}"),
OnShowResult = (watched) =>
{
if (watched)
{
// 发放奖励
}
},
};
adComponent.Play(option);
// 快捷方式：通过 GameApp（需要 com.gameframex.unity.entry）
GameApp.Advertisement.SetExtraData("userId", player.UserId);
var option2 = new AdvertisementPlayOption
{
OnSuccess = (data) => Debug.Log("广告展示成功"),
OnFail = (err) => Debug.LogError($"广告展示失败: {err}"),
OnShowResult = (watched) =>
{
if (watched)
{
// 发放奖励
}
},
};
GameApp.Advertisement.Play(option2);
| 平台 | 支持 |
|---|---|
| 支付宝小游戏 (WebGL) | 是 |
| Android | 否 |
| iOS | 否 |
| Standalone | 否 |
需要
UNITY_WEBGL和ENABLE_ALIPAY_MINI_GAME脚本宏定义。
- 初始发布
- 支持支付宝小游戏平台激励视频广告
- IL2CPP 裁剪保护
本项目基于 MIT 许可证 和 Apache 许可证 2.0 双重授权。
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
