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
